alt/agent-ops/rules/project/domain/operations/rules.md

domain	last_rule_review_commit	last_rule_updated_at
operations	711dbb9f0c	2026-05-28

operations

목적 / 책임

로컬 개발, workspace orchestration, operator CLI, and infrastructure entrypoints를 관리한다. 개발자가 반복적으로 쓰는 root-level commands and local services stay discoverable here.

포함 경로

• bin/ - workspace helper scripts
• go.work - Go workspace module membership
• go.work.sum - Go workspace dependency checksum
• apps/cli/ - Go operator CLI for local/admin workflows
• deployments/local/ - local Docker Compose infrastructure
• .gitignore - repository-level ignore policy

제외 경로

• services/api/ - API runtime implementation
• services/worker/ - worker runtime implementation
• apps/client/ - Flutter client code
• packages/domain/ and packages/contracts/ - shared model and schema sources

주요 구성 요소

• bin/dev - prints local development entrypoints
• bin/test - runs Go tests and Flutter tests
• bin/lint - runs Go vet and Flutter analyze
• bin/build - builds Go binaries and Flutter web
• bin/contracts-gen - regenerates contract outputs
• bin/contracts-check - checks generated contract outputs are current
• deployments/local/docker-compose.yml - PostgreSQL and Redis local stack
• apps/cli/cmd/alt/main.go - operator CLI scaffold

유지할 패턴

• Keep root helper scripts executable, idempotent where practical, and set -euo pipefail.
• Prefer root bin/* commands for whole-workspace workflows.
• Keep contract codegen/check scripts under bin/ and route schema ownership back to packages/contracts.
• Keep local infrastructure defaults aligned with worker/API environment fallback values.
• Add new Go modules to go.work when they are part of local development.

다른 도메인과의 경계

• api and worker: operations starts, tests, and builds services; service behavior belongs to each service domain.
• client: operations invokes Flutter commands; UI implementation stays under apps/client.
• contracts: operations may run codegen later; schema design remains in contracts.

금지 사항

• Do not put application business logic in shell scripts.
• Do not commit local secrets or machine-specific state.
• Do not make root scripts silently skip failing module checks.