nomadcode/agent-ops/rules/project/domain/workspace-ops/rules.md

domain	last_rule_review_commit	last_rule_updated_at
workspace-ops	a95fc27151	2026-06-24

workspace-ops

목적 / 책임

NomadCode 원레포 운영 도메인이다. 루트 helper, 문서, ignore/secret 정책, 원레포 구조, agent/tooling 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.
• .aiexclude, .clineignore, .clinerules, .cursorignore, .cursorrules, .geminiignore, .claude/, opencode.json — agent/tooling ignore와 configuration.
• .gitignore — workspace-level ignore policy.
• .sops.yaml, secrets/ — encrypted secret policy와 SOPS-managed tracked secret material.
• collect_evidence.sh — local evidence collection helper.
• 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-test/ — local-only test rules, smoke scenario docs, run artifacts.

제외 경로

• 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 안내.
• bin/nomadcode-sops-env — SOPS-managed env material 실행 helper.
• collect_evidence.sh — workspace evidence 수집 helper.
• AGENTS.md, CLAUDE.md, GEMINI.md — agent별 루트 진입 규칙.
• .aiexclude, .clineignore, .cursorignore, .geminiignore — agent별 archive/private ignore 경계.
• .clinerules, .cursorrules, .claude/settings.json, opencode.json — agent/tooling별 루트 설정.
• agent-test/local/rules.md — local 테스트 환경 routing과 private input 사용 경계.
• 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.
• agent-ops/bin/ai-ignore.sh — agent별 archive/private ignore 파일 생성 helper.
• agent-ops/bin/entry-files.sh — root agent entry 파일 재생성 helper.
• agent-ops/bin/bump-version.sh — agent-ops version marker 갱신 helper.
• agent-ops/bin/roadmap-dependency-checker.sh — roadmap 외부 의존 lock 판별 helper.
• agent-test/live-cycle-smoke.md, agent-test/plane-dev.md — lifecycle/Plane dev smoke routing 문서.
• agent-test/local/*-smoke.md — 도메인별 local smoke routing 문서.
• agent-roadmap/phase/*/PHASE.md, agent-roadmap/phase/*/milestones/*.md — 활성 Phase/Milestone 문서.

유지할 패턴

• root helper는 누락된 도구를 친절하게 skip하거나 명확히 실패한다.
• 공통 agent-ops 영역과 프로젝트 특화 영역을 섞지 않는다.
• roadmap은 agent-roadmap/에 두고, 서비스별 README에 Phase 계획을 중복 유지하지 않는다.
• 일반 작업에서 agent-roadmap/archive/**와 agent-task/archive/**는 사용자가 명시하거나 규칙이 허용한 경우에만 읽는다.
• .gitignore에는 private rules와 local-only agent-test/local/, agent-test/runs/만 제외하고, agent-task/archive/**는 AI ignore/permission 파일에서 제어한다.
• raw .env* secret은 tracked 문서/규칙에 값으로 기록하지 않고, SOPS encrypted material과 local ignored env material의 경계를 유지한다.
• 원레포 구조 설명은 README를 기준으로 갱신하고, 별도 운영/아키텍처 세부가 있을 때만 docs에 분리한다.

다른 도메인과의 경계

• core/mobile/contracts: workspace-ops는 실행/검증 흐름을 연결하지만 각 도메인 내부 구현을 소유하지 않는다.
• web: [Legacy/Retired] React web 도메인은 완전히 제거되었으며 새 작업 대상으로 되살리지 않는다.
• agentic-framework: common rules/skills/bin은 framework 동기화 결과물로 취급한다.

금지 사항

• 하위 앱/서비스에 별도 agent entry 파일이나 agent-ops scaffold를 복제하지 않는다.
• framework 공통 파일을 프로젝트 요구에 맞춰 직접 수정하지 않는다.
• root helper에 특정 개발자 로컬 절대경로를 넣지 않는다.
• SOPS encrypted file을 평문 secret 문서처럼 다루거나 secret 값을 rules/roadmap/docs에 기록하지 않는다.
• roadmap이나 agent-task archive 문서를 최신 템플릿에 맞춘다는 이유만으로 재포맷하지 않는다.