2.9 KiB
2.9 KiB
| domain | last_rule_review_commit | last_rule_updated_at |
|---|---|---|
| workspace-ops | e3b5dae725 |
2026-05-21 |
workspace-ops
목적 / 책임
NomadCode 원레포 운영 도메인이다. 루트 helper, 문서, ignore 정책, 원레포 구조, agent entry 파일, agent-ops project rules와 roadmap을 관리한다.
포함 경로
bin/— root test/build/lint/dev helper.docs/— architecture and operations documents.README.md— workspace overview.AGENTS.md,CLAUDE.md,GEMINI.md— root agent entry instructions.opencode.json— agent/tooling configuration..gitignore— workspace-level ignore policy.agent-ops/.version— agent-ops framework/version marker.agent-ops/bin/— agent-ops 초기화, sync, entry file helper.agent-ops/rules/project/— project/domain rules.agent-ops/roadmap/— project roadmap, current milestone pointer, milestone documents.
제외 경로
agent-ops/rules/common/— agentic-framework에서 동기화되는 공통 rules.agent-ops/skills/common/— agentic-framework에서 동기화되는 공통 skills.services/core/,apps/web/,apps/mobile/,packages/contracts/— 각 제품 도메인 소유 코드.
주요 구성 요소
bin/test— core/web/mobile 검증 entrypoint.bin/lint— vet/check/analyze entrypoint.bin/build— build entrypoint.bin/dev— development entrypoint 안내.docs/monorepo.md— monorepo layout 설명.AGENTS.md,CLAUDE.md,GEMINI.md— agent별 루트 진입 규칙.agent-ops/rules/project/rules.md— 프로젝트 전체 agent routing.agent-ops/roadmap/ROADMAP.md— 전체 Phase와 Milestone index.agent-ops/roadmap/current.md— 현재 Phase와 기본 Milestone pointer.agent-ops/bin/sync.sh— agent-ops 동기화 helper.
유지할 패턴
- root helper는 누락된 도구를 친절하게 skip하거나 명확히 실패한다.
- 공통 agent-ops 영역과 프로젝트 특화 영역을 섞지 않는다.
- roadmap은
agent-ops/roadmap/에 두고, 서비스별 README에 Phase 계획을 중복 유지하지 않는다. .gitignore에는 private rules만 제외하고,agent-task/archive/**는 AI ignore/permission 파일에서 제어한다.- 원레포 구조 변경은 README와 docs를 함께 갱신한다.
다른 도메인과의 경계
- core/web/mobile/contracts: workspace-ops는 실행/검증 흐름을 연결하지만 각 도메인 내부 구현을 소유하지 않는다.
- agentic-framework: common rules/skills/bin은 framework 동기화 결과물로 취급한다.
금지 사항
- 하위 앱/서비스에 별도 agent entry 파일이나 agent-ops scaffold를 복제하지 않는다.
- framework 공통 파일을 프로젝트 요구에 맞춰 직접 수정하지 않는다.
- root helper에 특정 개발자 로컬 절대경로를 넣지 않는다.