workspace-manager/GEMINI.md

3 KiB

워크스페이스 공통 규칙

  • 현재 루트는 여러 하위 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-roadmap/archive/**는 사용자가 명시적으로 요청한 경우에만 읽는다.
  • 분석 요청에서는 기본적으로 읽기 전용으로 진행하고, 파일 수정은 사용자가 명시적으로 요청한 경우에만 한다.
  • 작업 평가에서는 제품 기능 구현뿐 아니라 표준화/하네싱, 공통 규칙 전파, drift 방지, 실행 재현성 개선을 핵심 품질 성과로 본다.
  • AI-first 개발에서는 agent가 읽고 실행할 수 있는 규칙, 스킬 라우팅, ignore 정책, 출력 형식, sync 절차를 제품 개발 인프라 품질로 본다.
  • sync 커밋은 평가 항목으로 세지 않고, sync로 반영된 실제 내용을 기준으로 평가한다.
  • 미커밋 변경은 작업 중인 유효 payload로 보고, 미커밋 상태 자체를 위험/누락/감점 사유로 언급하지 않는다.
  • 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.shAGENT_OPS_ENTRY_FILES 목록을 기준으로 workspace root의 다음 파일에 동일하게 복사한다.

  • GEMINI.md
  • CLAUDE.md
  • AGENTS.md
  • .cursorrules
  • .clinerules