docs: CLAUDE.md 작업 프로토콜 추가 및 수정 계획 작성

- CLAUDE.md: Claude-Gemini 교차 토론 프로토콜 추가
- CLAUDE.md: 존재하지 않는 디렉토리 3개 제거
- analysis/fix-plan: 4 Phase 수정 계획 (Claude-Gemini 합의)
- .claude/agents/: dev 리뷰 에이전트 9개 복사
- .claude/skills/: 프로젝트 스킬 4개 복사
This commit is contained in:
JiWoong Sul
2026-03-27 16:52:52 +09:00
parent 6f5b3ba8f4
commit 916a50992c
17 changed files with 1672 additions and 3 deletions

View File

@@ -55,12 +55,9 @@ lib/
│ │ ├── story_service.dart # 스토리 진행
│ │ └── ... # 기타 서비스
│ ├── model/ # 게임 상태 및 데이터 모델
│ ├── animation/ # ASCII 애니메이션 데이터/렌더링
│ ├── audio/ # 오디오 서비스
│ ├── storage/ # 세이브/설정 저장소
│ ├── notification/ # 알림 서비스
│ ├── constants/ # 상수 정의
│ ├── l10n/ # 게임 데이터 번역 유틸
│ └── util/ # 유틸리티 (RNG, 로직 헬퍼 등)
├── features/
│ ├── front/ # 타이틀/세이브 선택 화면
@@ -141,3 +138,31 @@ type(scope): 한국어 설명
```
Types: `feat`, `fix`, `refactor`, `test`, `docs`, `style`, `chore`, `perf`
## 작업 프로토콜
### Claude-Gemini 교차 토론 (Cross-Debate)
모든 에이전트/스킬 실행 결과는 Claude와 Gemini가 독립 분석 후 토론하여 합의된 결과만 사용자에게 제공한다.
```
[실행 흐름]
1. Claude 에이전트 실행 → 초안 생성
2. Gemini 동일 프롬프트 실행:
- 최초: gemini -y -p "{에이전트 프롬프트 + 컨텍스트}" -o text
- 후속: gemini -y -r latest -p "{토론 프롬프트}" -o text
3. 결과 비교 → 불일치 항목 식별
4. Gemini와 불일치 항목 토론 (후속 호출)
5. 합의 시: 합의 내용만 출력
6. 미합의 시: "[NO CONSENSUS]" 표기 + 양측 의견 병기
```
### 에이전트/스킬 활용
- 에이전트 정의: `.claude/agents/` (origin에서 복사)
- 스킬 정의: `.claude/skills/` (origin에서 복사)
- 비사소한 작업은 반드시 에이전트를 병렬 배포하여 진행
- 작업 완료 조건: Gemini 토론 합의 완료
## 프로젝트 분석 리포트
- `analysis/full-audit-2026-03-27.md` — 9개 에이전트 전체 감사 (Health Score: 49/100)
- `analysis/supply-chain-review.md` — 의존성/라이선스/CVE 분석