claude-symphony 0.0.1

package/template/stages/06-implementation/config.yaml

@@ -0,0 +1,62 @@
+# Stage 06: Implementation Configuration
+
+stage:
+  id: "06-implementation"
+  name: "Implementation"
+  description: "핵심 기능 구현"
+
+models:
+  primary: "claudecode"
+  secondary: null
+  collaboration: null
+
+execution:
+  mode: "plan_sandbox"
+  container: false
+  sandbox: true
+  timeout: 14400  # 4 hours
+
+inputs:
+  required:
+    - name: "../05-task-management/outputs/tasks.md"
+    - name: "../03-planning/outputs/architecture.md"
+    - name: "../03-planning/outputs/implementation.yaml"
+      description: "구현 규칙 (Issue #10)"
+    - name: "../05-task-management/HANDOFF.md"
+  optional:
+    - name: "../04-ui-ux/outputs/design_system.md"
+    - name: "../03-planning/outputs/tech_stack.md"
+
+outputs:
+  required:
+    - name: "source_code/"
+      description: "구현된 소스 코드"
+    - name: "implementation_log.md"
+      description: "구현 로그"
+    - name: "HANDOFF.md"
+
+prompts:
+  - name: "scaffolding"
+    file: "prompts/scaffolding.md"
+    model: "claudecode"
+  - name: "component_impl"
+    file: "prompts/component_impl.md"
+    model: "claudecode"
+  - name: "api_impl"
+    file: "prompts/api_impl.md"
+    model: "claudecode"
+
+completion:
+  checklist:
+    - "프로젝트 스캐폴딩 완료"
+    - "공통 컴포넌트 구현"
+    - "핵심 기능 구현"
+    - "API 엔드포인트 구현"
+    - "체크포인트 생성"
+
+transition:
+  next_stage: "07-refactoring"
+  prerequisites:
+    - "05-task-management"
+  handoff_required: true
+  checkpoint_required: true  # 필수!

package/template/stages/06-implementation/prompts/collaboration.md

@@ -0,0 +1,64 @@
+# AI 협업 프롬프트 - Implementation
+
+## 협업 모드: Sequential Handoff
+
+이 스테이지에서는 **순차적 전달** 모드를 사용하여 구현 → 리뷰 → 개선 사이클을 진행합니다.
+
+### 참여 모델
+- **ClaudeCode**: 코드 생성, 구현
+
+### 협업 프롬프트
+
+```
+# 구현 → 셀프 리뷰 → 개선
+/collaborate --mode sequential --chain "claudecode:implement -> claudecode:review -> claudecode:improve"
+```
+
+### AI 벤치마킹 (선택적)
+
+복잡한 알고리즘 구현 시:
+```
+/benchmark --task "sorting_algorithm" --models "claude,codex"
+```
+
+### 작업 흐름
+
+1. **스캐폴딩**: 프로젝트 초기화
+2. **공통 컴포넌트**: 디자인 시스템 기반
+3. **기능 구현**: 스프린트 태스크 순차 구현
+4. **통합**: API/DB 연동
+
+### 체크포인트 트리거
+
+- 스프린트 완료 시
+- 주요 기능 완료 시
+- 100줄 이상 변경 시
+
+```
+/checkpoint --reason "스프린트 1 완료"
+```
+
+### implementation.yaml 준수
+
+구현 전 반드시 확인:
+```yaml
+# 예시 규칙
+component_type: functional
+styling: tailwind
+state_management: zustand
+naming: camelCase
+```
+
+### 출력 형식
+
+```markdown
+## 구현 로그
+
+### [날짜] - [태스크]
+- 구현 내용
+- 변경된 파일
+- 테스트 결과
+
+### 체크포인트
+- checkpoint_YYYYMMDD_HHMMSS
+```

package/template/stages/06-implementation/prompts/validation.md

@@ -0,0 +1,65 @@
+# 산출물 검증 프롬프트 - Implementation
+
+## 검증 대상
+
+| 산출물 | 필수 조건 | 검증 방법 |
+|--------|----------|----------|
+| `source_code/` | Lint 통과 | `npm run lint` |
+| `source_code/` | Type 체크 통과 | `npm run typecheck` |
+| `implementation_log.md` | 변경 기록 | 구조 확인 |
+| `HANDOFF.md` | 체크포인트 참조 | 항목 확인 |
+
+## 검증 명령
+
+```bash
+/validate --stage 06-implementation
+```
+
+## 품질 기준
+
+### source_code/
+- [ ] ESLint 에러 없음
+- [ ] TypeScript 타입 에러 없음
+- [ ] 폴더 구조 준수 (implementation.yaml)
+- [ ] 네이밍 규칙 준수
+- [ ] 코드 포맷팅 적용
+
+### implementation_log.md
+- [ ] 구현된 태스크 목록
+- [ ] 변경된 파일 목록
+- [ ] 알려진 이슈/기술 부채
+
+### HANDOFF.md
+- [ ] 완료된 기능 체크리스트
+- [ ] 체크포인트 참조
+- [ ] 리팩토링 필요 항목
+
+## 자동 검증 스크립트
+
+```bash
+# Lint 검사
+npm run lint
+
+# Type 검사
+npm run typecheck
+
+# 빌드 검증
+npm run build
+
+# 기본 테스트
+npm run test -- --passWithNoTests
+```
+
+## 코드 품질 메트릭
+
+| 메트릭 | 기준 | 명령 |
+|--------|------|------|
+| Lint 에러 | 0 | `npm run lint` |
+| Type 에러 | 0 | `npm run typecheck` |
+| 빌드 성공 | Yes | `npm run build` |
+
+## 실패 시 조치
+
+1. Lint 에러 → `npm run lint --fix`
+2. Type 에러 → 타입 수정
+3. 빌드 실패 → 에러 로그 분석 후 수정

package/template/stages/07-refactoring/CLAUDE.md

@@ -0,0 +1,180 @@
+# Stage 07: Refactoring
+
+> ⚠️ **필수 AI 모델: Codex**
+> 이 스테이지의 핵심 작업(코드 분석, 리팩토링, 최적화)은 `/codex` 명령어로 수행하세요.
+> ClaudeCode는 간단한 파일 조작 및 빌드/테스트 실행에만 사용합니다.
+
+코드 품질 개선 및 최적화 단계
+
+## 🎭 페르소나: Code Surgeon
+
+> 당신은 Code Surgeon입니다.
+> 코드의 본질을 유지하면서 품질을 개선하세요.
+> 성능, 가독성, 유지보수성을 균형있게 최적화하세요.
+
+### 특성
+- 깊이 있는 분석
+- 성능 최적화
+- 기술 부채 해소
+- 패턴 적용
+
+### 권장 행동
+- 코드 복잡도 감소
+- 성능 병목 해결
+- 디자인 패턴 적용
+- 중복 제거
+
+### 지양 행동
+- 불필요한 변경
+- 과도한 추상화
+- 동작 변경
+
+### AI 설정
+- **Temperature**: 0.5 (균형 잡힌 분석)
+- **분석 깊이**: Deep
+
+## 실행 모델
+- **Primary**: Codex (코드 분석 및 최적화)
+- **Secondary**: ClaudeCode (복잡한 리팩토링)
+- **Mode**: Deep Dive - 심층 코드 분석
+
+## 목표
+1. 코드 품질 개선
+2. 중복 제거
+3. 성능 최적화
+4. 아키텍처 개선
+
+## 입력 파일
+- `../06-implementation/outputs/source_code/`
+- `../06-implementation/outputs/implementation_log.md`
+- `../06-implementation/HANDOFF.md`
+
+## 출력 파일
+- `outputs/refactored_code/` - 리팩토링된 코드
+- `outputs/refactoring_report.md` - 리팩토링 보고서
+- `HANDOFF.md` - 다음 스테이지 인계 문서
+
+## Codex CLI 활용
+
+### 코드 분석
+```bash
+/codex "다음 코드의 개선점을 분석해주세요:
+- 중복 코드
+- 성능 병목
+- 디자인 패턴 위반
+- 타입 안전성 문제"
+```
+
+### 리팩토링 실행
+```bash
+/codex "다음 함수를 리팩토링해주세요:
+[코드 블록]
+목표: 가독성 향상, 성능 최적화"
+```
+
+## 워크플로우
+
+### 1. 코드 분석
+- 정적 분석 실행 (ESLint, TypeScript)
+- 복잡도 분석 (Cyclomatic complexity)
+- 의존성 분석
+
+### 2. 리팩토링 계획
+- 개선 영역 식별
+- 우선순위 결정
+- 영향 범위 평가
+
+### 3. 리팩토링 실행
+- 작은 단위로 수행
+- 각 변경 후 테스트
+- 커밋 메시지에 변경 사항 기록
+
+### 4. 최적화
+- 번들 사이즈 최적화
+- 렌더링 최적화
+- API 호출 최적화
+
+## 체크포인트 규칙
+- **필수**: 이 스테이지는 체크포인트가 필수입니다
+- 주요 리팩토링 전 체크포인트 생성
+- 롤백 가능 상태 유지
+
+---
+
+## ⚠️ AI 사용 기록 (필수)
+
+> **중요**: 이 스테이지는 Codex CLI를 사용해야 합니다.
+> Codex 호출 실패 시 ClaudeCode로 폴백되며, 이 경우 HANDOFF.md에 반드시 기록해야 합니다.
+
+### Codex 호출 전 확인
+```bash
+# 1. Codex CLI 설치 확인
+which codex
+
+# 2. tmux 세션 확인
+tmux ls
+
+# 3. 사전 점검 (권장)
+./scripts/pre-run-check.sh
+```
+
+### Codex 폴백 시 HANDOFF.md 기록
+Codex CLI 사용이 불가능하여 ClaudeCode로 폴백한 경우:
+
+```markdown
+### 폴백 기록
+
+| 시도한 AI | 실패 시간 | 오류 | 폴백 AI | 결과 |
+|----------|----------|------|---------|------|
+| Codex | HH:MM | [오류 내용] | ClaudeCode | 성공/실패 |
+
+**폴백 사유**: [상세 사유]
+**영향**: Codex의 깊이 있는 분석 미활용
+```
+
+---
+
+## ⚠️ Test-First 플로우 (필수)
+
+> **중요**: 리팩토링 후 기존 기능이 깨지지 않았는지 반드시 회귀 테스트를 실행하세요.
+
+### 리팩토링 완료 후 필수 테스트
+
+```bash
+# 1. 기존 테스트 실행 (회귀 방지)
+npm run test
+
+# 2. 정적 분석
+npm run lint
+
+# 3. 타입 체크
+npm run typecheck
+
+# 4. 개발 서버 실행 확인
+npm run dev
+```
+
+### 테스트 실패 시 조치
+1. **회귀 테스트 실패**: 리팩토링 롤백 또는 수정
+2. **lint 오류**: 리팩토링된 코드 수정
+3. **typecheck 오류**: 타입 정의 수정
+4. **동작 변경 발견**: 의도적 변경인지 확인, 아니면 롤백
+
+---
+
+## 완료 조건
+- [ ] 코드 품질 분석 완료
+- [ ] 중복 코드 제거
+- [ ] 성능 최적화 적용
+- [ ] **회귀 테스트 실행** (Test-First)
+- [ ] **lint/typecheck 통과**
+- [ ] 리팩토링 보고서 작성
+- [ ] 체크포인트 생성
+- [ ] HANDOFF.md 생성 (AI 사용/폴백 기록 포함)
+
+## 다음 스테이지
+→ **08-qa**: 품질 보증 및 코드 리뷰
+
+
+
+

package/template/stages/07-refactoring/HANDOFF.md.template

@@ -0,0 +1,97 @@
+# Stage Handoff: 07-refactoring → 08-qa
+
+**생성일**: {{TIMESTAMP}}
+**생성자**: Codex
+**소요 시간**: {{DURATION}}
+
+---
+
+## 완료된 작업
+
+- [ ] 코드 품질 분석
+- [ ] 중복 코드 제거 ({{DUP_REMOVED}}개)
+- [ ] 성능 최적화
+- [ ] 리팩토링 보고서 작성
+- [ ] 체크포인트 생성
+- [ ] HANDOFF.md 생성
+
+---
+
+## 다음 에이전트를 위한 컨텍스트
+
+### 리팩토링 요약
+
+| 영역 | 이전 | 이후 | 개선율 |
+|------|------|------|--------|
+| 코드 중복 | {{DUP_BEFORE}} | {{DUP_AFTER}} | {{DUP_IMPROVE}}% |
+| 번들 사이즈 | {{BUNDLE_BEFORE}} | {{BUNDLE_AFTER}} | {{BUNDLE_IMPROVE}}% |
+| 복잡도 | {{COMPLEX_BEFORE}} | {{COMPLEX_AFTER}} | {{COMPLEX_IMPROVE}}% |
+
+### 주요 변경 사항
+1. {{CHANGE_1}}
+2. {{CHANGE_2}}
+3. {{CHANGE_3}}
+
+### 남은 기술 부채
+- {{REMAINING_DEBT_1}}
+- {{REMAINING_DEBT_2}}
+
+### QA 중점 확인 필요 영역
+- {{QA_FOCUS_1}}: 리팩토링으로 인한 영향
+- {{QA_FOCUS_2}}: 최적화로 인한 동작 변화
+
+---
+
+## 체크포인트 정보
+
+| ID | 생성일 | 설명 |
+|----|--------|------|
+| {{CP_ID}} | {{CP_DATE}} | 리팩토링 완료 |
+
+---
+
+## 생성된 산출물
+
+| 파일 | 설명 |
+|------|------|
+| refactored_code/ | 리팩토링된 코드 |
+| refactoring_report.md | 리팩토링 보고서 |
+
+---
+
+## 08-qa 스테이지 가이드
+
+### 즉시 실행할 작업
+1. 리팩토링 영역 기능 테스트
+2. 회귀 테스트
+3. 성능 벤치마크
+
+### 테스트 우선순위
+1. {{TEST_PRIORITY_1}}
+2. {{TEST_PRIORITY_2}}
+3. {{TEST_PRIORITY_3}}
+
+---
+
+## AI 호출 기록
+
+| AI | 호출 시간 | 프롬프트 | 결과 | 상태 |
+|----|----------|---------|------|------|
+| {{AI_1}} | {{TIME_1}} | {{PROMPT_1}} | {{OUTPUT_1}} | {{STATUS_1}} |
+| {{AI_2}} | {{TIME_2}} | {{PROMPT_2}} | {{OUTPUT_2}} | {{STATUS_2}} |
+
+> 설정: `config/ai_logging.yaml`
+
+---
+
+## 메타데이터
+
+```yaml
+stage: "07-refactoring"
+status: "completed"
+next_stage: "08-qa"
+models_used:
+  - codex
+  - claudecode
+checkpoint_id: "{{CP_ID}}"
+```

package/template/stages/07-refactoring/config.yaml

@@ -0,0 +1,68 @@
+# Stage 07: Refactoring Configuration
+
+stage:
+  id: "07-refactoring"
+  name: "Refactoring"
+  description: "코드 품질 개선 및 최적화"
+
+models:
+  primary: "codex"
+  secondary: "claudecode"
+  collaboration: "sequential"
+
+# AI 자동 호출 설정 (Issue #12, #14 해결)
+auto_invoke:
+  enabled: true
+  model: "codex"
+  trigger: "refactoring_start"
+  prompt_file: "prompts/code_analysis.md"
+  wrapper: "scripts/codex-wrapper.sh"
+  flags: "--full-auto"
+  required: true
+  message: "🤖 Codex 자동 호출: 코드 분석 및 리팩토링 시작"
+
+execution:
+  mode: "deep_dive"
+  container: false
+  sandbox: false
+  timeout: 7200  # 2 hours
+
+inputs:
+  required:
+    - name: "../06-implementation/outputs/source_code/"
+    - name: "../06-implementation/outputs/implementation_log.md"
+    - name: "../06-implementation/HANDOFF.md"
+
+outputs:
+  required:
+    - name: "refactored_code/"
+      description: "리팩토링된 코드"
+    - name: "refactoring_report.md"
+      description: "리팩토링 보고서"
+    - name: "HANDOFF.md"
+
+prompts:
+  - name: "code_analysis"
+    file: "prompts/code_analysis.md"
+    model: "codex"
+  - name: "refactoring"
+    file: "prompts/refactoring.md"
+    model: "codex"
+  - name: "optimization"
+    file: "prompts/optimization.md"
+    model: "codex"
+
+completion:
+  checklist:
+    - "코드 품질 분석 완료"
+    - "중복 코드 제거"
+    - "성능 최적화 적용"
+    - "리팩토링 보고서 작성"
+    - "체크포인트 생성"
+
+transition:
+  next_stage: "08-qa"
+  prerequisites:
+    - "06-implementation"
+  handoff_required: true
+  checkpoint_required: true  # 필수!

package/template/stages/07-refactoring/prompts/collaboration.md

@@ -0,0 +1,71 @@
+# AI 협업 프롬프트 - Refactoring
+
+## 협업 모드: Sequential Review Chain
+
+이 스테이지에서는 **순차적 리뷰 체인**을 사용하여 리팩토링 품질을 보장합니다.
+
+### 참여 모델
+- **Codex**: 코드 분석, 최적화
+- **ClaudeCode**: 복잡한 리팩토링, 검증
+
+### 협업 프롬프트
+
+```
+# 리뷰 체인: Codex 분석 → Claude 검증
+/collaborate --mode sequential --chain "codex:analyze -> claude:review -> codex:refactor"
+```
+
+### AI 벤치마킹
+
+성능 최적화 비교:
+```
+/benchmark --task "performance_optimization" --models "codex,claude"
+```
+
+### 작업 흐름
+
+1. **분석**: 정적 분석, 복잡도 측정
+2. **계획**: 리팩토링 우선순위 결정
+3. **실행**: 작은 단위로 리팩토링
+4. **검증**: 테스트 통과 확인
+
+### 체크포인트 필수
+
+```bash
+# 리팩토링 전 체크포인트
+/checkpoint --reason "리팩토링 시작 전 상태"
+
+# 주요 리팩토링 후
+/checkpoint --reason "함수 X 리팩토링 완료"
+```
+
+### 롤백 준비
+
+```bash
+# 롤백 가능 상태 확인
+/restore --list
+
+# 필요시 부분 롤백
+/restore checkpoint_id --partial --files "src/utils/*"
+```
+
+### 출력 형식
+
+```markdown
+## AI 협업 결과
+
+### Codex 분석
+- 복잡도 높은 함수 목록
+- 중복 코드 위치
+- 성능 병목
+
+### Claude 검증
+- 리팩토링 영향 범위
+- 테스트 필요 영역
+- 위험 요소
+
+### 리팩토링 계획
+1. [우선순위 1 항목]
+2. [우선순위 2 항목]
+...
+```

package/template/stages/07-refactoring/prompts/validation.md

@@ -0,0 +1,76 @@
+# 산출물 검증 프롬프트 - Refactoring
+
+## 검증 대상
+
+| 산출물 | 필수 조건 | 검증 방법 |
+|--------|----------|----------|
+| `refactored_code/` | 동작 유지 | 테스트 통과 |
+| `refactored_code/` | 품질 개선 | 메트릭 비교 |
+| `refactoring_report.md` | 변경 내역 | 구조 확인 |
+| `HANDOFF.md` | 체크포인트 참조 | 항목 확인 |
+
+## 검증 명령
+
+```bash
+/validate --stage 07-refactoring
+```
+
+## 품질 기준
+
+### refactored_code/
+- [ ] 모든 기존 테스트 통과
+- [ ] Lint 에러 없음
+- [ ] 타입 에러 없음
+- [ ] 복잡도 감소 (목표: 20%↓)
+- [ ] 중복 코드 감소 (목표: 50%↓)
+
+### refactoring_report.md
+- [ ] 리팩토링된 함수/클래스 목록
+- [ ] 변경 전후 비교
+- [ ] 성능 개선 측정값
+- [ ] 남은 기술 부채
+
+### HANDOFF.md
+- [ ] 완료된 리팩토링 목록
+- [ ] 체크포인트 참조
+- [ ] QA 필요 영역
+
+## 자동 검증 스크립트
+
+```bash
+# 테스트 통과 확인
+npm run test
+
+# Lint 검사
+npm run lint
+
+# 번들 사이즈 비교
+npm run build && du -sh dist/
+
+# 복잡도 측정 (선택적)
+npx complexity-report src/**/*.ts
+```
+
+## 품질 메트릭 비교
+
+| 메트릭 | 이전 | 이후 | 개선율 |
+|--------|------|------|--------|
+| 평균 복잡도 | - | - | - |
+| 중복 코드 | - | - | - |
+| 번들 사이즈 | - | - | - |
+
+## 회귀 테스트
+
+```bash
+# 전체 테스트 실행
+npm run test
+
+# E2E 테스트 실행 (있는 경우)
+npm run test:e2e
+```
+
+## 실패 시 조치
+
+1. 테스트 실패 → 체크포인트로 롤백 후 재시도
+2. 성능 저하 → 변경 사항 검토 및 최적화
+3. 타입 에러 → 타입 수정 후 재검증