claude-symphony 0.0.1

package/template/stages/08-qa/CLAUDE.md

@@ -0,0 +1,93 @@
+# Stage 08: QA
+
+품질 보증 및 코드 리뷰 단계
+
+## 🎭 페르소나: Quality Guardian
+
+> 당신은 Quality Guardian입니다.
+> 모든 가능한 문제를 찾아내고 품질을 보장하세요.
+> 엣지 케이스와 보안 취약점에 특히 주의하세요.
+
+### 특성
+- 꼼꼼한 검토
+- 엣지 케이스 발견
+- 보안 의식
+- 사용자 관점
+
+### 권장 행동
+- 엣지 케이스 탐색
+- 보안 취약점 검사
+- 성능 문제 식별
+- 사용성 검토
+
+### 지양 행동
+- 표면적 검토
+- 긍정적 가정
+- 버그 무시
+
+### AI 설정
+- **Temperature**: 0.3 (철저한 검토)
+- **철저함**: High
+- **회의적 태도**: Healthy
+
+## 실행 모델
+- **Primary**: ClaudeCode (코드 리뷰, 버그 수정)
+- **Mode**: Plan + Sandbox
+
+## 목표
+1. 코드 리뷰 수행
+2. 버그 식별 및 수정
+3. 보안 취약점 검사
+4. 품질 기준 준수 확인
+
+## 입력 파일
+- `../07-refactoring/outputs/refactored_code/`
+- `../07-refactoring/outputs/refactoring_report.md`
+- `../07-refactoring/HANDOFF.md`
+
+## 출력 파일
+- `outputs/qa_report.md` - QA 보고서
+- `outputs/bug_fixes.md` - 버그 수정 내역
+- `HANDOFF.md` - 다음 스테이지 인계 문서
+
+## 워크플로우
+
+### 1. 코드 리뷰
+- 코딩 표준 준수 확인
+- 베스트 프랙티스 적용 여부
+- 문서화 수준 검토
+
+### 2. 기능 테스트
+- 요구사항 대비 기능 검증
+- 엣지 케이스 테스트
+- 에러 핸들링 검증
+
+### 3. 보안 검사
+- OWASP Top 10 체크
+- 입력 검증
+- 인증/인가 검증
+- 민감 정보 노출 검사
+
+### 4. 성능 검토
+- 응답 시간 측정
+- 메모리 사용량
+- 불필요한 리렌더링
+
+### 5. 버그 수정
+- 식별된 버그 우선순위 지정
+- 수정 및 검증
+- 회귀 테스트
+
+## 완료 조건
+- [ ] 코드 리뷰 완료
+- [ ] 보안 검사 통과
+- [ ] 식별된 버그 수정
+- [ ] QA 보고서 작성
+- [ ] HANDOFF.md 생성
+
+## 다음 스테이지
+→ **09-testing**: 테스트 코드 작성 및 E2E 테스트
+
+
+
+

package/template/stages/08-qa/HANDOFF.md.template

@@ -0,0 +1,96 @@
+# Stage Handoff: 08-qa → 09-testing
+
+**생성일**: {{TIMESTAMP}}
+**생성자**: ClaudeCode
+**소요 시간**: {{DURATION}}
+
+---
+
+## 완료된 작업
+
+- [ ] 코드 리뷰 완료
+- [ ] 보안 검사 ({{SECURITY_ISSUES}}개 이슈)
+- [ ] 버그 수정 ({{BUGS_FIXED}}개)
+- [ ] QA 보고서 작성
+- [ ] HANDOFF.md 생성
+
+---
+
+## 다음 에이전트를 위한 컨텍스트
+
+### QA 결과 요약
+
+| 항목 | 상태 | 비고 |
+|------|------|------|
+| 코딩 표준 | {{STANDARD_STATUS}} | |
+| 보안 검사 | {{SECURITY_STATUS}} | |
+| 성능 | {{PERF_STATUS}} | |
+| 접근성 | {{A11Y_STATUS}} | |
+
+### 수정된 버그
+
+| ID | 심각도 | 설명 | 파일 |
+|----|--------|------|------|
+| BUG-001 | {{SEV_1}} | {{BUG_1}} | {{FILE_1}} |
+| BUG-002 | {{SEV_2}} | {{BUG_2}} | {{FILE_2}} |
+
+### 알려진 이슈 (미수정)
+- {{KNOWN_ISSUE_1}}: {{REASON_1}}
+
+### 테스트 필요 영역
+- {{TEST_AREA_1}}: 핵심 기능
+- {{TEST_AREA_2}}: 엣지 케이스
+- {{TEST_AREA_3}}: 통합 테스트
+
+---
+
+## 생성된 산출물
+
+| 파일 | 설명 |
+|------|------|
+| qa_report.md | QA 보고서 |
+| bug_fixes.md | 버그 수정 내역 |
+
+---
+
+## 09-testing 스테이지 가이드
+
+### 즉시 실행할 작업
+1. 단위 테스트 작성
+2. 통합 테스트 작성
+3. E2E 테스트 설정 (Playwright)
+
+### 테스트 커버리지 목표
+- 단위 테스트: 80% 이상
+- 통합 테스트: 핵심 플로우 100%
+- E2E: 주요 사용자 시나리오
+
+### 권장 테스트 프레임워크
+- Unit: {{UNIT_FRAMEWORK}}
+- E2E: Playwright
+
+---
+
+## 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: "08-qa"
+status: "completed"
+next_stage: "09-testing"
+models_used:
+  - claudecode
+bugs_found: {{BUGS_FOUND}}
+bugs_fixed: {{BUGS_FIXED}}
+security_issues: {{SECURITY_ISSUES}}
+```

package/template/stages/08-qa/config.yaml

@@ -0,0 +1,56 @@
+# Stage 08: QA Configuration
+
+stage:
+  id: "08-qa"
+  name: "QA"
+  description: "품질 보증 및 코드 리뷰"
+
+models:
+  primary: "claudecode"
+  secondary: null
+  collaboration: null
+
+execution:
+  mode: "plan_sandbox"
+  container: false
+  sandbox: true
+  timeout: 3600
+
+inputs:
+  required:
+    - name: "../07-refactoring/outputs/refactored_code/"
+    - name: "../07-refactoring/outputs/refactoring_report.md"
+    - name: "../07-refactoring/HANDOFF.md"
+
+outputs:
+  required:
+    - name: "qa_report.md"
+      description: "QA 보고서"
+    - name: "bug_fixes.md"
+      description: "버그 수정 내역"
+    - name: "HANDOFF.md"
+
+prompts:
+  - name: "code_review"
+    file: "prompts/code_review.md"
+    model: "claudecode"
+  - name: "security_audit"
+    file: "prompts/security_audit.md"
+    model: "claudecode"
+  - name: "bug_fix"
+    file: "prompts/bug_fix.md"
+    model: "claudecode"
+
+completion:
+  checklist:
+    - "코드 리뷰 완료"
+    - "보안 검사 통과"
+    - "식별된 버그 수정"
+    - "QA 보고서 작성"
+
+transition:
+  next_stage: "09-testing"
+  prerequisites:
+    - "07-refactoring"
+  handoff_required: true
+  checkpoint_required: false

package/template/stages/08-qa/prompts/collaboration.md

@@ -0,0 +1,65 @@
+# AI 협업 프롬프트 - QA
+
+## 협업 모드: Comprehensive Review
+
+이 스테이지에서는 **포괄적 리뷰** 모드를 사용하여 품질을 보장합니다.
+
+### 참여 모델
+- **ClaudeCode**: 코드 리뷰, 버그 수정, 보안 검사
+
+### 협업 프롬프트
+
+```
+# 다각도 검토
+/collaborate --mode sequential --chain "claudecode:code_review -> claudecode:security_audit -> claudecode:fix"
+```
+
+### 리뷰 영역
+
+| 영역 | 검토 항목 |
+|------|----------|
+| 코드 품질 | 가독성, 유지보수성, 베스트 프랙티스 |
+| 보안 | OWASP Top 10, 입력 검증, 인증/인가 |
+| 성능 | 응답 시간, 메모리, 리렌더링 |
+| 기능 | 요구사항 충족, 엣지 케이스 |
+
+### 보안 검사 체크리스트
+
+- [ ] SQL Injection
+- [ ] XSS (Cross-Site Scripting)
+- [ ] CSRF (Cross-Site Request Forgery)
+- [ ] 인증/인가 우회
+- [ ] 민감 정보 노출
+- [ ] 의존성 취약점
+
+```bash
+# 의존성 취약점 검사
+npm audit
+```
+
+### 버그 우선순위
+
+| 등급 | 기준 | 조치 |
+|------|------|------|
+| Critical | 보안, 데이터 손실 | 즉시 수정 |
+| High | 주요 기능 장애 | 이번 스테이지 수정 |
+| Medium | 부가 기능 이슈 | 다음 스프린트 |
+| Low | UI/UX 개선 | 백로그 |
+
+### 출력 형식
+
+```markdown
+## QA 결과
+
+### 코드 리뷰
+- [파일]: [이슈] - [심각도]
+...
+
+### 보안 검사
+- [취약점]: [위치] - [조치]
+...
+
+### 버그 수정
+- [BUG-001]: [설명] - [해결 방법]
+...
+```

package/template/stages/08-qa/prompts/validation.md

@@ -0,0 +1,71 @@
+# 산출물 검증 프롬프트 - QA
+
+## 검증 대상
+
+| 산출물 | 필수 조건 | 검증 방법 |
+|--------|----------|----------|
+| `qa_report.md` | 리뷰 결과 포함 | 구조 확인 |
+| `bug_fixes.md` | 수정 내역 | 항목 확인 |
+| 소스 코드 | 보안 검사 통과 | 자동 스캔 |
+| `HANDOFF.md` | 테스트 필요 항목 | 항목 확인 |
+
+## 검증 명령
+
+```bash
+/validate --stage 08-qa
+```
+
+## 품질 기준
+
+### qa_report.md
+- [ ] 코드 리뷰 결과
+- [ ] 보안 검사 결과
+- [ ] 성능 검토 결과
+- [ ] 발견된 버그 목록
+- [ ] 권장 사항
+
+### bug_fixes.md
+- [ ] 수정된 버그 목록
+- [ ] 각 버그의 원인 분석
+- [ ] 해결 방법
+- [ ] 회귀 방지 조치
+
+### 소스 코드
+- [ ] Critical 버그 0개
+- [ ] High 버그 0개
+- [ ] 보안 취약점 해결
+
+### HANDOFF.md
+- [ ] 테스트 필요 영역
+- [ ] 남은 Medium/Low 이슈
+- [ ] 다음 단계 권고
+
+## 자동 검증 스크립트
+
+```bash
+# 보안 취약점 검사
+npm audit --audit-level=high
+
+# Lint 검사
+npm run lint
+
+# 타입 검사
+npm run typecheck
+
+# 테스트 실행
+npm run test
+```
+
+## 보안 메트릭
+
+| 메트릭 | 기준 | 실제 |
+|--------|------|------|
+| Critical 취약점 | 0 | - |
+| High 취약점 | 0 | - |
+| Medium 취약점 | < 5 | - |
+
+## 실패 시 조치
+
+1. 보안 취약점 → 즉시 수정 후 재검증
+2. 테스트 실패 → 버그 수정 후 재실행
+3. Lint 에러 → 코드 수정

package/template/stages/09-testing/CLAUDE.md

@@ -0,0 +1,124 @@
+# Stage 09: Testing & E2E
+
+테스트 코드 작성 및 E2E 테스트 단계
+
+## 🎭 페르소나: Test Engineer
+
+> 당신은 Test Engineer입니다.
+> 신뢰할 수 있고 유지보수 가능한 테스트를 작성하세요.
+> 높은 커버리지와 명확한 테스트 케이스를 목표로 하세요.
+
+### 특성
+- 체계적 테스트
+- 커버리지 최적화
+- 자동화 지향
+- 재현 가능성
+
+### 권장 행동
+- 높은 테스트 커버리지
+- 다양한 시나리오
+- 자동화된 테스트
+- 명확한 단언문
+
+### 지양 행동
+- 불안정한 테스트
+- 하드코딩된 값
+- 의존성 많은 테스트
+
+### AI 설정
+- **Temperature**: 0.4 (체계적 설계)
+- **커버리지 집중**: High
+- **자동화 수준**: High
+
+## 실행 모델
+- **Primary**: Codex (테스트 코드 생성)
+- **Mode**: Sandbox + Playwright
+- **MCP**: playwright 서버 연동
+
+## 목표
+1. 단위 테스트 작성
+2. 통합 테스트 작성
+3. E2E 테스트 작성 (Playwright)
+4. 테스트 커버리지 확보
+
+## 입력 파일
+- `../07-refactoring/outputs/refactored_code/` (또는 수정된 코드)
+- `../08-qa/outputs/qa_report.md`
+- `../08-qa/HANDOFF.md`
+
+## 출력 파일
+- `outputs/tests/` - 테스트 코드
+- `outputs/test_report.md` - 테스트 결과 보고서
+- `outputs/coverage_report.md` - 커버리지 보고서
+- `HANDOFF.md` - 다음 스테이지 인계 문서
+
+## Codex CLI 활용
+
+### 단위 테스트 생성
+```bash
+/codex "다음 함수에 대한 단위 테스트를 작성해주세요:
+[함수 코드]
+테스트 프레임워크: Vitest/Jest
+커버리지 목표: 80%"
+```
+
+### E2E 테스트 생성
+```bash
+/codex "다음 사용자 플로우에 대한 Playwright 테스트를 작성해주세요:
+1. 로그인 플로우
+2. 핵심 기능 테스트
+3. 에러 시나리오"
+```
+
+## 워크플로우
+
+### 1. 테스트 환경 설정
+```bash
+# Vitest 설정
+npm install -D vitest @testing-library/react
+
+# Playwright 설정
+npm install -D @playwright/test
+npx playwright install
+```
+
+### 2. 단위 테스트 작성
+- 유틸리티 함수
+- 컴포넌트 렌더링
+- 훅 테스트
+- API 핸들러
+
+### 3. 통합 테스트
+- API 통합 테스트
+- 컴포넌트 통합 테스트
+- 데이터 흐름 테스트
+
+### 4. E2E 테스트
+- 핵심 사용자 플로우
+- 인증 플로우
+- 에러 처리 시나리오
+
+### 5. 커버리지 분석
+- 목표 커버리지 확인
+- 커버되지 않은 영역 식별
+
+## 커버리지 목표
+- **Statements**: 80%
+- **Branches**: 75%
+- **Functions**: 80%
+- **Lines**: 80%
+
+## 완료 조건
+- [ ] 단위 테스트 작성 (커버리지 80%+)
+- [ ] 통합 테스트 작성
+- [ ] E2E 테스트 작성 (핵심 플로우)
+- [ ] 모든 테스트 통과
+- [ ] 커버리지 보고서 생성
+- [ ] HANDOFF.md 생성
+
+## 다음 스테이지
+→ **10-deployment**: CI/CD 및 배포
+
+
+
+

package/template/stages/09-testing/HANDOFF.md.template

@@ -0,0 +1,113 @@
+# Stage Handoff: 09-testing → 10-deployment
+
+**생성일**: {{TIMESTAMP}}
+**생성자**: Codex
+**소요 시간**: {{DURATION}}
+
+---
+
+## 완료된 작업
+
+- [ ] 단위 테스트 작성 ({{UNIT_COUNT}}개)
+- [ ] 통합 테스트 작성 ({{INT_COUNT}}개)
+- [ ] E2E 테스트 작성 ({{E2E_COUNT}}개)
+- [ ] 모든 테스트 통과
+- [ ] 커버리지 보고서 생성
+- [ ] HANDOFF.md 생성
+
+---
+
+## 다음 에이전트를 위한 컨텍스트
+
+### 테스트 결과 요약
+
+| 유형 | 총 개수 | 통과 | 실패 | 스킵 |
+|------|--------|------|------|------|
+| Unit | {{UNIT_COUNT}} | {{UNIT_PASS}} | {{UNIT_FAIL}} | {{UNIT_SKIP}} |
+| Integration | {{INT_COUNT}} | {{INT_PASS}} | {{INT_FAIL}} | {{INT_SKIP}} |
+| E2E | {{E2E_COUNT}} | {{E2E_PASS}} | {{E2E_FAIL}} | {{E2E_SKIP}} |
+
+### 커버리지 보고서
+
+| 메트릭 | 결과 | 목표 | 상태 |
+|--------|------|------|------|
+| Statements | {{STMT_COV}}% | 80% | {{STMT_STATUS}} |
+| Branches | {{BRANCH_COV}}% | 75% | {{BRANCH_STATUS}} |
+| Functions | {{FUNC_COV}}% | 80% | {{FUNC_STATUS}} |
+| Lines | {{LINE_COV}}% | 80% | {{LINE_STATUS}} |
+
+### E2E 테스트 시나리오
+
+| 시나리오 | 상태 | 실행 시간 |
+|----------|------|-----------|
+| {{E2E_1}} | Pass | {{TIME_1}} |
+| {{E2E_2}} | Pass | {{TIME_2}} |
+| {{E2E_3}} | Pass | {{TIME_3}} |
+
+### CI 통합 준비 사항
+- 테스트 명령어: `npm test`
+- 커버리지 명령어: `npm run coverage`
+- E2E 명령어: `npm run test:e2e`
+
+---
+
+## 생성된 산출물
+
+| 파일 | 설명 |
+|------|------|
+| tests/ | 테스트 코드 |
+| test_report.md | 테스트 결과 |
+| coverage_report.md | 커버리지 보고서 |
+
+---
+
+## 10-deployment 스테이지 가이드
+
+### 즉시 실행할 작업
+1. GitHub Actions 워크플로우 설정
+2. 배포 환경 설정
+3. 환경 변수 구성
+
+### CI/CD 파이프라인 제안
+```yaml
+workflow:
+  - lint
+  - type-check
+  - unit-tests
+  - integration-tests
+  - build
+  - e2e-tests
+  - deploy
+```
+
+### 배포 전 체크리스트
+- [ ] 환경 변수 설정
+- [ ] 도메인 설정
+- [ ] SSL 인증서
+- [ ] 데이터베이스 마이그레이션
+
+---
+
+## 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: "09-testing"
+status: "completed"
+next_stage: "10-deployment"
+models_used:
+  - codex
+total_tests: {{TOTAL_TESTS}}
+coverage: {{TOTAL_COV}}%
+e2e_scenarios: {{E2E_COUNT}}
+```

package/template/stages/09-testing/config.yaml

@@ -0,0 +1,65 @@
+# Stage 09: Testing & E2E Configuration
+
+stage:
+  id: "09-testing"
+  name: "Testing & E2E"
+  description: "테스트 코드 작성 및 E2E 테스트"
+
+models:
+  primary: "codex"
+  secondary: null
+  collaboration: null
+
+execution:
+  mode: "sandbox_playwright"
+  container: false
+  sandbox: true
+  timeout: 7200  # 2 hours
+
+mcp_servers:
+  - playwright
+
+inputs:
+  required:
+    - name: "source_code/"
+      description: "테스트할 소스 코드"
+    - name: "../08-qa/outputs/qa_report.md"
+    - name: "../08-qa/HANDOFF.md"
+
+outputs:
+  required:
+    - name: "tests/"
+      description: "테스트 코드"
+    - name: "test_report.md"
+      description: "테스트 결과 보고서"
+    - name: "coverage_report.md"
+      description: "커버리지 보고서"
+    - name: "HANDOFF.md"
+
+prompts:
+  - name: "unit_tests"
+    file: "prompts/unit_tests.md"
+    model: "codex"
+  - name: "integration_tests"
+    file: "prompts/integration_tests.md"
+    model: "codex"
+  - name: "e2e_tests"
+    file: "prompts/e2e_tests.md"
+    model: "codex"
+
+completion:
+  checklist:
+    - "단위 테스트 작성 (커버리지 80%+)"
+    - "통합 테스트 작성"
+    - "E2E 테스트 작성"
+    - "모든 테스트 통과"
+    - "커버리지 보고서 생성"
+  validation:
+    min_coverage: 80
+
+transition:
+  next_stage: "10-deployment"
+  prerequisites:
+    - "08-qa"
+  handoff_required: true
+  checkpoint_required: false