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