modify gemini template

2026-04-28 01:51:20 +09:00
parent 949e0ab13c
commit 38291723f0
32 changed files with 523 additions and 320 deletions
@@ -40,9 +40,9 @@

 **트레이드오프**: 파일 수가 늘어난다. 대신 리뷰와 회귀 확인이 쉬워진다.

-### ADR-006: Codex의 AGENTS/Skill/Hook 구조로 이전
-**결정**: Claude 전용 `CLAUDE.md`, `.claude/commands`, `.claude/settings.json` 구조를 Codex의 `AGENTS.md`, `.agents/skills`, `.codex/hooks.json`, `.codex/agents` 구조로 이전한다.
+### ADR-006: Gemini CLI의 context/Skill/Command/Hook/Subagent 구조 사용
+**결정**: 이 템플릿은 Gemini CLI의 `GEMINI.md`, `.agents/skills`, `.gemini/settings.json`, `.gemini/commands`, `.gemini/hooks`, `.gemini/agents` 구조를 기준으로 한다.

-**이유**: Codex는 프로젝트 지침을 `AGENTS.md`로 읽고, 재사용 가능한 워크플로우를 Skill로 관리하며, lifecycle hook과 custom agent를 별도 디렉토리에서 구성한다. 템플릿의 의도를 Codex의 네이티브 구조에 맞추면 실행 맥락과 재사용성이 좋아진다.
+**이유**: Gemini CLI는 프로젝트 지침을 `GEMINI.md`로 읽고, `SKILL.md` 기반 Agent Skills를 on-demand로 활성화하며, custom slash command와 lifecycle hook, local subagent를 `.gemini/` 아래에서 구성한다. 템플릿의 의도를 Gemini CLI 네이티브 구조에 맞추면 실행 맥락과 재사용성이 좋아진다.

-**트레이드오프**: Claude Code와의 직접 호환성은 낮아진다. 대신 Codex CLI, Skill, custom agent, hook을 기준으로 한 문서 작성 자동화가 명확해진다.
+**트레이드오프**: 다른 CLI 전용 구성과 직접 호환되지 않는다. 대신 Gemini CLI의 headless execution, custom commands, hooks, subagents를 기준으로 문서 작성 자동화가 명확해진다.
@@ -3,16 +3,16 @@
 ## 디렉토리 구조
 ```text
 .
-├── AGENTS.md                 # Codex가 읽는 프로젝트별 문서 작성 규칙
+├── GEMINI.md                 # Gemini CLI가 읽는 프로젝트별 문서 작성 규칙
 ├── .agents/
 │   └── skills/
 │       ├── document-harness/ # 단계적 문서 작성 Skill
 │       └── document-review/  # 문서 리뷰 Skill
-├── .codex/
-│   ├── config.toml           # Codex 기능, live web search, agent 한도 설정
-│   ├── hooks.json            # Stop/PreToolUse hook 설정
+├── .gemini/
+│   ├── settings.json         # context, skills, hooks 설정
+│   ├── commands/             # Harness custom slash commands
 │   ├── hooks/                # hook 실행 스크립트
-│   └── agents/               # 조사/초안/리뷰 custom agents
+│   └── agents/               # 조사/초안/리뷰 subagents
 ├── docs/
 │   ├── PRD.md                # 사용자 요구사항 원천
 │   ├── ResearchNote.md       # 조사 노트와 출처 장부
@@ -25,7 +25,7 @@
 ├── final/                    # 피드백 반영 최종 산출물
 ├── phases/                   # Harness task/step 계획과 상태
 └── scripts/
-    ├── execute.py            # codex exec 기반 step 순차 실행기
+    ├── execute.py            # Gemini CLI headless 기반 step 순차 실행기
    ├── validate_docs.py      # 문서 템플릿 기본 검증
    └── test_execute.py       # execute.py 안전망 테스트
 ```
@@ -34,8 +34,8 @@
 ```text
 사용자 입력
  -> docs/PRD.md
-  -> AGENTS.md 작성 규칙 구체화
-  -> Codex/custom agents 웹 검색 및 출처 검증
+  -> GEMINI.md 작성 규칙 구체화
+  -> Gemini CLI/subagents 웹 검색 및 출처 검증
  -> docs/ResearchNote.md
  -> drafts/ 초안 작성
  -> docs/DraftFeedback.md 사용자 피드백
@@ -46,19 +46,21 @@
 ## Step 설계 패턴
 권장 phase는 아래 순서를 따른다.

-1. `rule-synthesis`: `docs/PRD.md`를 읽고 `AGENTS.md`의 문서 작성 규칙을 프로젝트에 맞게 구체화한다.
-2. `research-note`: 웹 검색과 사용자가 제공한 자료를 바탕으로 `docs/ResearchNote.md`를 작성한다. 필요하면 `doc_researcher` agent를 사용한다.
+1. `rule-synthesis`: `docs/PRD.md`를 읽고 `GEMINI.md`의 문서 작성 규칙을 프로젝트에 맞게 구체화한다.
+2. `research-note`: 웹 검색과 사용자가 제공한 자료를 바탕으로 `docs/ResearchNote.md`를 작성한다. 필요하면 `doc-researcher` subagent를 사용한다.
 3. `draft-documents`: `drafts/`에 사용자 검토용 초안을 작성한다.
 4. `draft-feedback-gate`: `docs/DraftFeedback.md`가 비어 있으면 `blocked`로 멈추고 사용자 검토를 요청한다.
 5. `final-documents`: 피드백을 반영해 `final/`에 최종 문서를 작성한다.
 6. `final-feedback-gate`: `docs/FinalFeedback.md`에 승인 또는 추가 수정 요청이 없으면 `blocked`로 멈춘다.

-## Codex 구성 책임
- `AGENTS.md`는 Codex가 매 작업에서 읽는 짧고 지속적인 규칙을 담는다.
+## Gemini CLI 구성 책임
+- `GEMINI.md`는 Gemini CLI가 매 작업에서 읽는 짧고 지속적인 규칙을 담는다.
 - `.agents/skills/document-harness/`는 phase 생성, research, draft, feedback gate, final 작성 절차를 담는다.
 - `.agents/skills/document-review/`는 변경된 Markdown 문서의 리뷰 체크리스트를 담는다.
- `.codex/agents/`는 조사, 초안 작성, 리뷰, 근거 점검 역할을 분리한다.
- `.codex/hooks.json`은 위험 명령 차단과 Stop 시점 문서 검증을 연결한다.
+- `.gemini/commands/`는 반복 작업을 호출하기 위한 project-local slash command를 담는다.
+- `.gemini/agents/`는 조사, 초안 작성, 리뷰, 근거 점검 역할을 분리한다.
+- `.gemini/settings.json`은 context, skills, hook 실행 설정을 담는다.
+- `.gemini/hooks/`는 위험 명령 차단과 AfterAgent 시점 문서 검증을 연결한다.

 ## 상태 관리
 - `pending`: 아직 실행되지 않은 step.
@@ -67,7 +69,7 @@
 - `error`: 자동 수정 3회 후에도 실패한 상태.

 ## 파일 책임
- `docs/PRD.md`는 사용자의 의도와 요구사항을 보존한다. Codex가 임의로 요구사항을 바꾸지 않는다.
+- `docs/PRD.md`는 사용자의 의도와 요구사항을 보존한다. Gemini CLI가 임의로 요구사항을 바꾸지 않는다.
 - `docs/ResearchNote.md`는 사실 검증의 근거 장부다. 최종 문서의 외부 주장은 이 파일의 출처와 연결되어야 한다.
 - `drafts/`는 논의용이다. 문장이 거칠 수 있지만 구조와 근거는 검토 가능해야 한다.
 - `final/`은 납품용이다. 사용자 피드백, 출처, 스타일 기준을 반영해야 한다.
@@ -1,6 +1,6 @@
 # PRD: {문서 프로젝트명}

-이 파일은 Codex 문서 작성 Harness의 출발점이다. 사용자는 아래 항목을 가능한 한 구체적으로 채운다. Codex는 이 문서를 기준으로 작성 규칙, 조사 계획, 초안, 최종 문서를 만든다.
+이 파일은 Gemini CLI 문서 작성 Harness의 출발점이다. 사용자는 아래 항목을 가능한 한 구체적으로 채운다. Gemini CLI는 이 문서를 기준으로 작성 규칙, 조사 계획, 초안, 최종 문서를 만든다.

 ## 문서 목적
 {이 문서가 해결하려는 문제, 설득하려는 주장, 설명하려는 주제, 또는 독자가 얻어야 할 결과를 한 문단으로 작성}
@@ -15,7 +15,7 @@
 | 목차와 본문 제목 불일치 | 리뷰와 유지보수가 어려워진다 |
 | PRD에 없는 독자나 목표 추가 | 사용자 의도를 벗어난다 |
 | ResearchNote에 없는 외부 주장 단정 | 출처 추적이 끊긴다 |
-| AGENTS.md와 Skill 지침 불일치 | Codex 실행 맥락이 흔들린다 |
+| GEMINI.md와 Skill 지침 불일치 | Gemini CLI 실행 맥락이 흔들린다 |

 ## 구조
 - 문서 제목은 `#` 하나만 사용한다.
@@ -51,4 +51,4 @@
 - 초안 피드백이 반영되었는가?
 - 문서 제목, 섹션 제목, 파일명이 산출물 목적과 맞는가?
 - 최종 문서는 `final/` 아래에 있는가?
- Codex Skill, agent, hook 지침과 충돌하지 않는가?
+- Gemini CLI Skill, subagent, command, hook 지침과 충돌하지 않는가?