3.3 KiB
3.3 KiB
워크스페이스 공통 규칙
- 현재 루트는 여러 하위 Git repository를 품은 workspace이며, 그 자체를 제품 repository로 단정하지 않는다.
- 응답은 사용자가 다르게 요청하지 않는 한 한국어로 작성한다.
- 기존 하위 repository의 구조와 규칙을 우선한다.
- 분석 대상 하위 repository는 workspace root
.gitignore에서 ignore되는 프로젝트 폴더 중.workspace-ops/config/target-excludes.txt에 없는 경로만 대상으로 한다. - 하위 repository를 변경해야 할 때는 해당 repository의 진입 파일과
agent-ops/rules/project/rules.md를 먼저 확인한다. - 주기 분석, 주간 작업 요약, 주간 분석, 구현 전 점검은
.workspace-ops/skills/하위 skill을 사용한다. .workspace-ops/**는 workspace 운영 도구이므로 하위 프로젝트 분석 대상에서 제외한다. 단, skill 또는 rule을 사용하기 위해 명시적으로 필요한 파일은 읽을 수 있다..tmp/**,.antigravitycli/**,**/.agent-cache/**,**/.git/**,**/node_modules/**,**/build/**,**/dist/**,**/.dart_tool/**,**/coverage/**는 일반 분석 대상에서 제외한다.agent-task/archive/**와agent-roadmap/archive/**는 사용자가 명시적으로 요청한 경우에만 읽는다.- 분석 요청에서는 기본적으로 읽기 전용으로 진행하고, 파일 수정은 사용자가 명시적으로 요청한 경우에만 한다.
- 작업 평가에서는 제품 기능 구현뿐 아니라 표준화/하네싱, 공통 규칙 전파, drift 방지, 실행 재현성 개선을 핵심 품질 성과로 본다.
- AI-first 개발에서는 agent가 읽고 실행할 수 있는 규칙, 스킬 라우팅, ignore 정책, 출력 형식, sync 절차를 제품 개발 인프라 품질로 본다.
- sync 커밋은 평가 항목으로 세지 않고, sync로 반영된 실제 내용을 기준으로 평가한다.
- 미커밋 변경은 작업 중인 유효 payload로 보고, 미커밋 상태 자체를 위험/누락/감점 사유로 언급하지 않는다.
- git 작업 중 기존 변경을 되돌리지 않는다.
스킬 라우팅
아래 요청은 작업 최초 1회 해당 SKILL.md를 읽고 수행한다.
짧은 자연어 요청도 같은 의미로 라우팅한다.
| 요청 예시 | 요청 성격 | SKILL.md |
|---|---|---|
| 오늘 작업 평가해줘, 오늘 평가해줘, 일간 리뷰, daily review | 오늘 작업 평가 | .workspace-ops/skills/daily-subproject-review/SKILL.md |
| 주간 작업, 이번주 작업 정리, 지난 일주일 작업 요약, weekly work summary | 이번 주 작업 요약 | .workspace-ops/skills/weekly-subproject-work-summary/SKILL.md |
| 이번주 작업 평가해줘, 이번주 평가해줘, 주간 분석, weekly review, cross-repo 점검 | 이번 주 작업 평가 | .workspace-ops/skills/weekly-subproject-review/SKILL.md |
| 이 작업 시작해도 돼?, 구현 전 점검, 시작 가능 여부, pre-implementation review | 큰 구현 전 점검 | .workspace-ops/skills/pre-implementation-review/SKILL.md |
진입 파일
workspace root의 진입 파일은 호환용 얇은 안내만 담고, 실제 규칙 원본은 이 파일에 둔다.
진입 파일 목록은 .workspace-ops/config/entry-files.txt를 기준으로 관리한다.
GEMINI.mdCLAUDE.mdAGENTS.md.cursorrules.clinerules