62 lines
2.9 KiB
Markdown
62 lines
2.9 KiB
Markdown
---
|
|
domain: workspace-ops
|
|
last_rule_review_commit: e3b5dae725db62dd7a47c563abcce557e0557551
|
|
last_rule_updated_at: 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-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/` (Legacy/Retired), `apps/client/`, `packages/contracts/` — 각 제품 도메인 소유 코드.
|
|
|
|
## 주요 구성 요소
|
|
|
|
- `bin/test` — core/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-roadmap/ROADMAP.md` — 전체 Phase와 Milestone index.
|
|
- `agent-roadmap/current.md` — 현재 Phase와 기본 Milestone pointer.
|
|
- `agent-ops/bin/sync.sh` — agent-ops 동기화 helper.
|
|
|
|
## 유지할 패턴
|
|
|
|
- root helper는 누락된 도구를 친절하게 skip하거나 명확히 실패한다.
|
|
- 공통 agent-ops 영역과 프로젝트 특화 영역을 섞지 않는다.
|
|
- roadmap은 `agent-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에 특정 개발자 로컬 절대경로를 넣지 않는다.
|