workspace-manager/.workspace-ops/rules/project/rules.md

3.4 KiB

워크스페이스 프로젝트 규칙

프로젝트 개요

이 workspace는 서로 연관된 하위 Git repository들을 한 루트에서 운영하기 위한 작업 공간이다. 분석 대상은 workspace root 자체가 아니라, root .gitignore에서 ignore되는 하위 Git repository 중 .workspace-ops/config/target-excludes.txt에 없는 경로다.

현재 주요 하위 repository:

경로 성격
agentic-framework/ 공통 agent-ops 규칙과 skill 공급원
dart-app-core/ Dart 앱 공통 기반
iop/ 실행, 모델, agent runtime, Edge/Node 계층
nomadcode/ 개발 workflow/product shell
oto/ build/deploy domain agent 후보
proto-socket/ proto-socket transport 구현

분석 대상 탐색

  • .workspace-ops/shared/target-discovery.md 규칙으로 root .gitignore에서 ignore되는 하위 Git repository를 찾고, .workspace-ops/config/target-excludes.txt에 명시된 경로는 제외한다.
  • workspace root 자체의 .git은 관리 repository로만 보고 분석 대상 repository로 보지 않는다.
  • .workspace-ops/**는 운영 도구이므로 분석 대상 repository로 보지 않는다.
  • 분석 중 .workspace-ops/를 읽는 경우는 skill, shared reference, script, rule, config를 사용해야 할 때로 제한한다.
  • 하위 repository 내부의 agent-task/archive/**agent-roadmap/archive/**는 사용자가 명시적으로 요청한 경우에만 읽는다.

스킬 라우팅

요청 예시 요청 성격 SKILL.md
오늘 작업 평가해줘 / 오늘 평가해줘 / 일간 분석 / daily 오늘 작업 평가 .workspace-ops/skills/daily-subproject-review/SKILL.md
주간 작업 / 이번주 작업 정리 / 지난 일주일 작업 요약 / weekly work summary 이번 주 작업 요약 .workspace-ops/skills/weekly-subproject-work-summary/SKILL.md
이번주 작업 평가해줘 / 이번주 평가해줘 / 주간 분석 / weekly / cross-repo 점검 이번 주 작업 평가 .workspace-ops/skills/weekly-subproject-review/SKILL.md
이 작업 시작해도 돼? / 구현 전 점검 / 시작 가능 여부 / pre-implementation 큰 구현 전 점검 .workspace-ops/skills/pre-implementation-review/SKILL.md

출력 기준

  • 커밋 수와 라인 수는 보조 지표로만 사용한다.
  • 실제 평가는 변경의 의미, 작업 속도, cross-repo 영향, 책임 경계, 위험/누락, 다음 액션을 기준으로 한다.
  • 작업 속도는 일반 개발자/시니어 개발자 AI 미사용 대비 추정 배율을 표로 제시하되, sync 자체가 아니라 sync로 반영된 실제 내용을 기준으로 평가한다.
  • 표준화/하네싱, 공통 규칙 전파, drift 방지, 실행 재현성 개선은 제품 기능 구현과 별개의 핵심 품질 성과로 평가한다.
  • AI-first 개발에서는 agent가 읽고 실행할 수 있는 규칙, 스킬 라우팅, ignore 정책, 출력 형식, sync 절차를 제품 개발 인프라 품질로 평가한다.
  • 제품 기능 구현만을 진척 또는 품질의 기준으로 삼지 않는다.
  • 미커밋 변경은 작업 중인 유효 payload로 보고, 미커밋 상태 자체를 위험/누락/감점 사유로 언급하지 않는다.
  • 최종 답변에는 사용자가 바로 행동할 수 있는 다음 액션을 포함한다.
  • 단순 분석 요청에서는 파일을 수정하지 않는다.