nomadcode/GEMINI.md

2.5 KiB

공통 규칙

  • 현재 문서를 반드시 끝까지 정독하고 작업한다. 다 읽지 않고 즉각 작업은 금지한다.
  • 기존 구조를 우선한다. 새 파일 생성보다 기존 파일 수정을 우선한다.
  • 코드 변경 전 관련 domain rule을 먼저 확인한다.
  • 요청 범위를 넘는 변경을 하지 않는다.
  • 불확실하면 단정하지 말고 후보를 제시한다.
  • agent-task/archive/**는 사용자가 명시적으로 요청한 경우에만 읽는다.
  • agent-ops/roadmap/ 디렉터리가 있는 프로젝트에서도 agent-ops/roadmap/archive/**는 일반 작업에서 읽지 않는다. 로드맵 과거 완료 내용, 완료 근거, 복원, 비교가 필요한 경우에만 agent-ops/rules/common/rules-roadmap.md의 archive 접근 규칙을 따른다.
  • agent-ops 구조, 규칙, 스킬, 로드맵, 런타임 책임 경계를 설계하거나 수정할 때만 agent-ops/rules/common/philosophy.md를 읽는다.

세션 최초 1회 아래 파일을 순서대로 반드시 읽는다. 파일이나 디렉터리가 없는 항목은 건너뛴다. 그외에 스킵은 금지한다.

  1. agent-ops/rules/project/rules.md
  2. agent-ops/rules/private/rules.md
  3. agent-ops/roadmap/ 디렉터리가 있으면 agent-ops/rules/common/rules-roadmap.md

프로젝트 간 잠금

  • 프로젝트 상위 폴더에 .agent-roadmap-sync/locks.yaml이 있으면 프로젝트 간 Milestone 잠금 인덱스로 본다.
  • 외부 의존 잠금 생성/동기화 요청은 .agent-roadmap-sync/locks.yaml이 없어도 update-roadmap이 생성한다.
  • "이 Milestone은 X가 끝나야 가능하다", "A 전까지 B를 잠근다", "잠금 해제 조건은 X다", "현재 마일스톤은 X 프로젝트 작업 뒤에 진행되어야 한다", "의존성 설정해"는 update-roadmap으로 처리한다.
  • plancode-review.agent-roadmap-sync를 읽거나 갱신하지 않는다.

스킬 규칙

아래 경우에 부합되는지 반드시 끝까지 정독해서 읽고, 부합할 경우 agent-ops/skills/common/router.md를 작업 최초 1회 읽고 수행한다. 자동으로 수행하지 않는다. 절대 스킵하지 말고 정독해야한다

  • agent-ops 초기화
  • domain rule 생성
  • skill 생성
  • README 생성
  • 로드맵/마일스톤 생성·갱신
  • 로드맵 현지점 / 현재 작업 지점 확인
  • 계획 작성 / plan 생성
  • 코드 리뷰 / review 진행
  • git commit / push
  • agent-ops 업데이트 / 진입 파일 재적용