46 lines
3.4 KiB
Markdown
46 lines
3.4 KiB
Markdown
# 워크스페이스 프로젝트 규칙
|
|
|
|
## 프로젝트 개요
|
|
|
|
이 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로 보고, 미커밋 상태 자체를 위험/누락/감점 사유로 언급하지 않는다.
|
|
- 최종 답변에는 사용자가 바로 행동할 수 있는 다음 액션을 포함한다.
|
|
- 단순 분석 요청에서는 파일을 수정하지 않는다.
|