toki/nomadcode
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
nomadcode/agent-ops/rules/project/domain/workspace-ops/rules.md
toki 84c8ac67ed 기능: monorepo 구조를 변경하고 web을 제거한다 
- apps/web 디렉터리 전체를 삭제하여 web 클라이언트 제거
- Flutter 모바일 앱 구조를 정리하고 모델/스크린/서비스 추가
- agent-ops 규칙 및 로드맵 업데이트
- monorepo 문서 갱신
2026-05-24 21:48:51 +09:00

2.9 KiB
Raw Blame History

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/ (Legacy/Retired), apps/mobile/, 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-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에 특정 개발자 로컬 절대경로를 넣지 않는다.