claude-symphony 0.0.1 → 0.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (148) hide show
  1. package/README.md +16 -12
  2. package/bin/create.js +80 -69
  3. package/package.json +1 -1
  4. package/template/.claude/commands/benchmark.md +32 -32
  5. package/template/.claude/commands/brainstorm.md +33 -33
  6. package/template/.claude/commands/checkpoint.md +42 -42
  7. package/template/.claude/commands/codex.md +52 -52
  8. package/template/.claude/commands/collaborate.md +47 -47
  9. package/template/.claude/commands/context.md +77 -77
  10. package/template/.claude/commands/deploy.md +50 -50
  11. package/template/.claude/commands/fork.md +46 -46
  12. package/template/.claude/commands/gemini.md +43 -43
  13. package/template/.claude/commands/handoff.md +42 -42
  14. package/template/.claude/commands/implement.md +42 -42
  15. package/template/.claude/commands/init-project.md +25 -25
  16. package/template/.claude/commands/next.md +67 -67
  17. package/template/.claude/commands/planning.md +38 -38
  18. package/template/.claude/commands/qa.md +47 -47
  19. package/template/.claude/commands/refactor.md +50 -50
  20. package/template/.claude/commands/research.md +31 -31
  21. package/template/.claude/commands/restore.md +53 -53
  22. package/template/.claude/commands/run-stage.md +45 -45
  23. package/template/.claude/commands/stages.md +49 -49
  24. package/template/.claude/commands/status.md +41 -41
  25. package/template/.claude/commands/tasks.md +33 -33
  26. package/template/.claude/commands/test.md +45 -45
  27. package/template/.claude/commands/ui-ux.md +31 -31
  28. package/template/.claude/commands/validate.md +81 -81
  29. package/template/.claude/hooks/ai-selector.sh +39 -39
  30. package/template/.claude/hooks/auto-checkpoint.sh +30 -30
  31. package/template/.claude/hooks/output-validator.sh +45 -45
  32. package/template/.claude/hooks/post-stage.sh +28 -28
  33. package/template/.claude/hooks/pre-stage.sh +47 -47
  34. package/template/.claude/hooks/session-start.sh +27 -27
  35. package/template/.claude/hooks/statusline.sh +24 -24
  36. package/template/.claude/hooks/stop.sh +26 -26
  37. package/template/.claude/settings.json +32 -32
  38. package/template/.claude/skills/ai-collaboration/README.md +31 -31
  39. package/template/.claude/skills/ai-collaboration/debate.md +66 -66
  40. package/template/.claude/skills/ai-collaboration/parallel.md +34 -34
  41. package/template/.claude/skills/ai-collaboration/prompts/CLAUDE.md +59 -63
  42. package/template/.claude/skills/auto-checkpoint/README.md +46 -46
  43. package/template/.claude/skills/auto-checkpoint/prompts/CLAUDE.md +68 -72
  44. package/template/.claude/skills/auto-checkpoint/rollback.md +95 -95
  45. package/template/.claude/skills/auto-checkpoint/trigger.md +37 -37
  46. package/template/.claude/skills/context-compression/README.md +69 -69
  47. package/template/.claude/skills/context-compression/analyze.md +74 -74
  48. package/template/.claude/skills/context-compression/compress.md +103 -103
  49. package/template/.claude/skills/context-compression/prompts/compression.md +78 -78
  50. package/template/.claude/skills/output-validator/README.md +33 -33
  51. package/template/.claude/skills/output-validator/prompts/CLAUDE.md +74 -78
  52. package/template/.claude/skills/output-validator/validate.md +76 -76
  53. package/template/.claude/skills/smart-handoff/README.md +35 -35
  54. package/template/.claude/skills/smart-handoff/extract.md +42 -42
  55. package/template/.claude/skills/smart-handoff/prompts/CLAUDE.md +52 -54
  56. package/template/.claude/skills/smart-handoff/summarize.md +55 -55
  57. package/template/.claude/skills/stage-transition/README.md +50 -50
  58. package/template/.claude/skills/stage-transition/handoff-gen.md +89 -89
  59. package/template/.claude/skills/stage-transition/prompts/transition.md +74 -74
  60. package/template/.claude/skills/stage-transition/validate.md +41 -41
  61. package/template/CLAUDE.md +334 -335
  62. package/template/config/ai_benchmarking.yaml +22 -22
  63. package/template/config/ai_collaboration.yaml +18 -18
  64. package/template/config/ai_logging.yaml +50 -50
  65. package/template/config/auto_checkpoint.yaml +32 -32
  66. package/template/config/context.yaml +20 -20
  67. package/template/config/git.yaml +51 -51
  68. package/template/config/handoff_intelligence.yaml +23 -23
  69. package/template/config/mcp_fallbacks.yaml +71 -71
  70. package/template/config/memory_integration.yaml +23 -23
  71. package/template/config/model_enforcement.yaml +53 -53
  72. package/template/config/models.yaml +24 -24
  73. package/template/config/output_validation.yaml +44 -44
  74. package/template/config/pipeline.yaml +25 -25
  75. package/template/config/pipeline_forking.yaml +40 -40
  76. package/template/config/qa_logging.yaml +67 -67
  77. package/template/config/smart_rollback.yaml +48 -48
  78. package/template/config/stage_personas.yaml +154 -154
  79. package/template/config/workflow.yaml +16 -16
  80. package/template/scripts/ai-benchmark.sh +41 -41
  81. package/template/scripts/codex-wrapper.sh +32 -32
  82. package/template/scripts/context-manager.sh +136 -136
  83. package/template/scripts/create-checkpoint.sh +34 -34
  84. package/template/scripts/gemini-wrapper.sh +31 -31
  85. package/template/scripts/init-project.sh +40 -40
  86. package/template/scripts/list-stages.sh +30 -30
  87. package/template/scripts/next-stage.sh +67 -67
  88. package/template/scripts/output-validate.sh +2 -2
  89. package/template/scripts/pipeline-fork.sh +68 -68
  90. package/template/scripts/pre-run-check.sh +84 -84
  91. package/template/scripts/restore-checkpoint.sh +50 -50
  92. package/template/scripts/run-stage.sh +44 -44
  93. package/template/scripts/show-status.sh +30 -30
  94. package/template/scripts/smart-handoff.sh +70 -70
  95. package/template/stages/01-brainstorm/CLAUDE.md +70 -74
  96. package/template/stages/01-brainstorm/README.md +54 -54
  97. package/template/stages/01-brainstorm/config.yaml +18 -18
  98. package/template/stages/01-brainstorm/prompts/collaboration.md +24 -24
  99. package/template/stages/01-brainstorm/prompts/ideation.md +41 -41
  100. package/template/stages/01-brainstorm/prompts/persona.md +50 -50
  101. package/template/stages/01-brainstorm/prompts/requirements.md +55 -55
  102. package/template/stages/01-brainstorm/prompts/validation.md +28 -28
  103. package/template/stages/01-brainstorm/templates/ideas.md +47 -47
  104. package/template/stages/01-brainstorm/templates/requirements_analysis.md +61 -61
  105. package/template/stages/02-research/CLAUDE.md +72 -76
  106. package/template/stages/02-research/config.yaml +12 -12
  107. package/template/stages/02-research/prompts/collaboration.md +29 -29
  108. package/template/stages/02-research/prompts/feasibility.md +38 -38
  109. package/template/stages/02-research/prompts/market_analysis.md +29 -29
  110. package/template/stages/02-research/prompts/tech_stack.md +34 -34
  111. package/template/stages/02-research/prompts/validation.md +29 -29
  112. package/template/stages/03-planning/CLAUDE.md +88 -92
  113. package/template/stages/03-planning/config.yaml +10 -10
  114. package/template/stages/03-planning/prompts/architecture.md +43 -43
  115. package/template/stages/03-planning/prompts/collaboration.md +34 -34
  116. package/template/stages/03-planning/prompts/validation.md +34 -34
  117. package/template/stages/04-ui-ux/CLAUDE.md +68 -72
  118. package/template/stages/04-ui-ux/config.yaml +5 -5
  119. package/template/stages/04-ui-ux/prompts/collaboration.md +35 -35
  120. package/template/stages/04-ui-ux/prompts/validation.md +30 -30
  121. package/template/stages/05-task-management/CLAUDE.md +81 -85
  122. package/template/stages/05-task-management/config.yaml +17 -17
  123. package/template/stages/05-task-management/prompts/collaboration.md +30 -30
  124. package/template/stages/05-task-management/prompts/validation.md +33 -33
  125. package/template/stages/05-task-management/templates/notion_integration.md +70 -70
  126. package/template/stages/05-task-management/templates/parallel_groups.yaml +64 -64
  127. package/template/stages/05-task-management/templates/task_schema.yaml +33 -33
  128. package/template/stages/06-implementation/CLAUDE.md +117 -121
  129. package/template/stages/06-implementation/config.yaml +10 -10
  130. package/template/stages/06-implementation/prompts/collaboration.md +29 -29
  131. package/template/stages/06-implementation/prompts/validation.md +36 -36
  132. package/template/stages/07-refactoring/CLAUDE.md +120 -124
  133. package/template/stages/07-refactoring/config.yaml +11 -11
  134. package/template/stages/07-refactoring/prompts/collaboration.md +36 -36
  135. package/template/stages/07-refactoring/prompts/validation.md +40 -40
  136. package/template/stages/08-qa/CLAUDE.md +80 -84
  137. package/template/stages/08-qa/config.yaml +7 -7
  138. package/template/stages/08-qa/prompts/collaboration.md +34 -34
  139. package/template/stages/08-qa/prompts/validation.md +41 -41
  140. package/template/stages/09-testing/CLAUDE.md +86 -90
  141. package/template/stages/09-testing/config.yaml +10 -10
  142. package/template/stages/09-testing/prompts/collaboration.md +38 -38
  143. package/template/stages/09-testing/prompts/validation.md +41 -41
  144. package/template/stages/10-deployment/CLAUDE.md +86 -90
  145. package/template/stages/10-deployment/config.yaml +11 -11
  146. package/template/stages/10-deployment/prompts/collaboration.md +37 -37
  147. package/template/stages/10-deployment/prompts/validation.md +54 -54
  148. package/template/stages/10-deployment/templates/github-actions-cd.yaml +1 -1
@@ -3,7 +3,7 @@
3
3
  stage:
4
4
  id: "06-implementation"
5
5
  name: "Implementation"
6
- description: "핵심 기능 구현"
6
+ description: "Core feature implementation"
7
7
 
8
8
  models:
9
9
  primary: "claudecode"
@@ -21,7 +21,7 @@ inputs:
21
21
  - name: "../05-task-management/outputs/tasks.md"
22
22
  - name: "../03-planning/outputs/architecture.md"
23
23
  - name: "../03-planning/outputs/implementation.yaml"
24
- description: "구현 규칙 (Issue #10)"
24
+ description: "Implementation rules (Issue #10)"
25
25
  - name: "../05-task-management/HANDOFF.md"
26
26
  optional:
27
27
  - name: "../04-ui-ux/outputs/design_system.md"
@@ -30,9 +30,9 @@ inputs:
30
30
  outputs:
31
31
  required:
32
32
  - name: "source_code/"
33
- description: "구현된 소스 코드"
33
+ description: "Implemented source code"
34
34
  - name: "implementation_log.md"
35
- description: "구현 로그"
35
+ description: "Implementation log"
36
36
  - name: "HANDOFF.md"
37
37
 
38
38
  prompts:
@@ -48,15 +48,15 @@ prompts:
48
48
 
49
49
  completion:
50
50
  checklist:
51
- - "프로젝트 스캐폴딩 완료"
52
- - "공통 컴포넌트 구현"
53
- - "핵심 기능 구현"
54
- - "API 엔드포인트 구현"
55
- - "체크포인트 생성"
51
+ - "Project scaffolding complete"
52
+ - "Common components implemented"
53
+ - "Core features implemented"
54
+ - "API endpoints implemented"
55
+ - "Checkpoint created"
56
56
 
57
57
  transition:
58
58
  next_stage: "07-refactoring"
59
59
  prerequisites:
60
60
  - "05-task-management"
61
61
  handoff_required: true
62
- checkpoint_required: true # 필수!
62
+ checkpoint_required: true # Required!
@@ -1,64 +1,64 @@
1
- # AI 협업 프롬프트 - Implementation
1
+ # AI Collaboration Prompt - Implementation
2
2
 
3
- ## 협업 모드: Sequential Handoff
3
+ ## Collaboration Mode: Sequential Handoff
4
4
 
5
- 스테이지에서는 **순차적 전달** 모드를 사용하여 구현리뷰개선 사이클을 진행합니다.
5
+ This stage uses **sequential handoff** mode to run the implement reviewimprove cycle.
6
6
 
7
- ### 참여 모델
8
- - **ClaudeCode**: 코드 생성, 구현
7
+ ### Participating Models
8
+ - **ClaudeCode**: Code generation, implementation
9
9
 
10
- ### 협업 프롬프트
10
+ ### Collaboration Prompt
11
11
 
12
12
  ```
13
- # 구현셀프 리뷰개선
13
+ # ImplementSelf ReviewImprove
14
14
  /collaborate --mode sequential --chain "claudecode:implement -> claudecode:review -> claudecode:improve"
15
15
  ```
16
16
 
17
- ### AI 벤치마킹 (선택적)
17
+ ### AI Benchmarking (Optional)
18
18
 
19
- 복잡한 알고리즘 구현 시:
19
+ For complex algorithm implementation:
20
20
  ```
21
21
  /benchmark --task "sorting_algorithm" --models "claude,codex"
22
22
  ```
23
23
 
24
- ### 작업 흐름
24
+ ### Workflow
25
25
 
26
- 1. **스캐폴딩**: 프로젝트 초기화
27
- 2. **공통 컴포넌트**: 디자인 시스템 기반
28
- 3. **기능 구현**: 스프린트 태스크 순차 구현
29
- 4. **통합**: API/DB 연동
26
+ 1. **Scaffolding**: Project initialization
27
+ 2. **Common Components**: Based on design system
28
+ 3. **Feature Implementation**: Sequential implementation of sprint tasks
29
+ 4. **Integration**: API/DB integration
30
30
 
31
- ### 체크포인트 트리거
31
+ ### Checkpoint Triggers
32
32
 
33
- - 스프린트 완료
34
- - 주요 기능 완료
35
- - 100 이상 변경 시
33
+ - On sprint completion
34
+ - On major feature completion
35
+ - On 100+ lines changed
36
36
 
37
37
  ```
38
- /checkpoint --reason "스프린트 1 완료"
38
+ /checkpoint --reason "Sprint 1 complete"
39
39
  ```
40
40
 
41
- ### implementation.yaml 준수
41
+ ### Follow implementation.yaml
42
42
 
43
- 구현 반드시 확인:
43
+ Check before implementation:
44
44
  ```yaml
45
- # 예시 규칙
45
+ # Example rules
46
46
  component_type: functional
47
47
  styling: tailwind
48
48
  state_management: zustand
49
49
  naming: camelCase
50
50
  ```
51
51
 
52
- ### 출력 형식
52
+ ### Output Format
53
53
 
54
54
  ```markdown
55
- ## 구현 로그
55
+ ## Implementation Log
56
56
 
57
- ### [날짜] - [태스크]
58
- - 구현 내용
59
- - 변경된 파일
60
- - 테스트 결과
57
+ ### [Date] - [Task]
58
+ - Implementation details
59
+ - Modified files
60
+ - Test results
61
61
 
62
- ### 체크포인트
62
+ ### Checkpoint
63
63
  - checkpoint_YYYYMMDD_HHMMSS
64
64
  ```
@@ -1,65 +1,65 @@
1
- # 산출물 검증 프롬프트 - Implementation
1
+ # Output Validation Prompt - Implementation
2
2
 
3
- ## 검증 대상
3
+ ## Validation Targets
4
4
 
5
- | 산출물 | 필수 조건 | 검증 방법 |
6
- |--------|----------|----------|
7
- | `source_code/` | Lint 통과 | `npm run lint` |
8
- | `source_code/` | Type 체크 통과 | `npm run typecheck` |
9
- | `implementation_log.md` | 변경 기록 | 구조 확인 |
10
- | `HANDOFF.md` | 체크포인트 참조 | 항목 확인 |
5
+ | Output | Required Condition | Validation Method |
6
+ |--------|-------------------|-------------------|
7
+ | `source_code/` | Lint pass | `npm run lint` |
8
+ | `source_code/` | Type check pass | `npm run typecheck` |
9
+ | `implementation_log.md` | Change records | Structure verification |
10
+ | `HANDOFF.md` | Checkpoint reference | Item verification |
11
11
 
12
- ## 검증 명령
12
+ ## Validation Command
13
13
 
14
14
  ```bash
15
15
  /validate --stage 06-implementation
16
16
  ```
17
17
 
18
- ## 품질 기준
18
+ ## Quality Criteria
19
19
 
20
20
  ### source_code/
21
- - [ ] ESLint 에러 없음
22
- - [ ] TypeScript 타입 에러 없음
23
- - [ ] 폴더 구조 준수 (implementation.yaml)
24
- - [ ] 네이밍 규칙 준수
25
- - [ ] 코드 포맷팅 적용
21
+ - [ ] No ESLint errors
22
+ - [ ] No TypeScript type errors
23
+ - [ ] Folder structure compliance (implementation.yaml)
24
+ - [ ] Naming convention compliance
25
+ - [ ] Code formatting applied
26
26
 
27
27
  ### implementation_log.md
28
- - [ ] 구현된 태스크 목록
29
- - [ ] 변경된 파일 목록
30
- - [ ] 알려진 이슈/기술 부채
28
+ - [ ] List of implemented tasks
29
+ - [ ] List of modified files
30
+ - [ ] Known issues/technical debt
31
31
 
32
32
  ### HANDOFF.md
33
- - [ ] 완료된 기능 체크리스트
34
- - [ ] 체크포인트 참조
35
- - [ ] 리팩토링 필요 항목
33
+ - [ ] Completed features checklist
34
+ - [ ] Checkpoint reference
35
+ - [ ] Items needing refactoring
36
36
 
37
- ## 자동 검증 스크립트
37
+ ## Auto Validation Script
38
38
 
39
39
  ```bash
40
- # Lint 검사
40
+ # Lint check
41
41
  npm run lint
42
42
 
43
- # Type 검사
43
+ # Type check
44
44
  npm run typecheck
45
45
 
46
- # 빌드 검증
46
+ # Build verification
47
47
  npm run build
48
48
 
49
- # 기본 테스트
49
+ # Basic tests
50
50
  npm run test -- --passWithNoTests
51
51
  ```
52
52
 
53
- ## 코드 품질 메트릭
53
+ ## Code Quality Metrics
54
54
 
55
- | 메트릭 | 기준 | 명령 |
56
- |--------|------|------|
57
- | Lint 에러 | 0 | `npm run lint` |
58
- | Type 에러 | 0 | `npm run typecheck` |
59
- | 빌드 성공 | Yes | `npm run build` |
55
+ | Metric | Criteria | Command |
56
+ |--------|----------|---------|
57
+ | Lint errors | 0 | `npm run lint` |
58
+ | Type errors | 0 | `npm run typecheck` |
59
+ | Build success | Yes | `npm run build` |
60
60
 
61
- ## 실패 조치
61
+ ## Actions on Failure
62
62
 
63
- 1. Lint 에러 → `npm run lint --fix`
64
- 2. Type 에러타입 수정
65
- 3. 빌드 실패에러 로그 분석 수정
63
+ 1. Lint errors → `npm run lint --fix`
64
+ 2. Type errorsFix types
65
+ 3. Build failureAnalyze error log and fix
@@ -1,180 +1,176 @@
1
1
  # Stage 07: Refactoring
2
2
 
3
- > ⚠️ **필수 AI 모델: Codex**
4
- > 스테이지의 핵심 작업(코드 분석, 리팩토링, 최적화) `/codex` 명령어로 수행하세요.
5
- > ClaudeCode 간단한 파일 조작 빌드/테스트 실행에만 사용합니다.
6
-
7
- 코드 품질 개선 최적화 단계
8
-
9
- ## 🎭 페르소나: Code Surgeon
10
-
11
- > 당신은 Code Surgeon입니다.
12
- > 코드의 본질을 유지하면서 품질을 개선하세요.
13
- > 성능, 가독성, 유지보수성을 균형있게 최적화하세요.
14
-
15
- ### 특성
16
- - 깊이 있는 분석
17
- - 성능 최적화
18
- - 기술 부채 해소
19
- - 패턴 적용
20
-
21
- ### 권장 행동
22
- - 코드 복잡도 감소
23
- - 성능 병목 해결
24
- - 디자인 패턴 적용
25
- - 중복 제거
26
-
27
- ### 지양 행동
28
- - 불필요한 변경
29
- - 과도한 추상화
30
- - 동작 변경
31
-
32
- ### AI 설정
33
- - **Temperature**: 0.5 (균형 잡힌 분석)
34
- - **분석 깊이**: Deep
35
-
36
- ## 실행 모델
37
- - **Primary**: Codex (코드 분석 최적화)
38
- - **Secondary**: ClaudeCode (복잡한 리팩토링)
39
- - **Mode**: Deep Dive - 심층 코드 분석
40
-
41
- ## 목표
42
- 1. 코드 품질 개선
43
- 2. 중복 제거
44
- 3. 성능 최적화
45
- 4. 아키텍처 개선
46
-
47
- ## 입력 파일
3
+ > ⚠️ **Required AI Model: Codex**
4
+ > The core tasks of this stage (code analysis, refactoring, optimization) should be performed using the `/codex` command.
5
+ > ClaudeCode is only used for simple file operations and running builds/tests.
6
+
7
+ Code quality improvement and optimization stage
8
+
9
+ ## Persona: Code Surgeon
10
+
11
+ > You are a Code Surgeon.
12
+ > Improve code quality while maintaining its essence.
13
+ > Optimize performance, readability, and maintainability in balance.
14
+
15
+ ### Characteristics
16
+ - Deep analysis
17
+ - Performance optimization
18
+ - Technical debt resolution
19
+ - Pattern application
20
+
21
+ ### Recommended Actions
22
+ - Reduce code complexity
23
+ - Resolve performance bottlenecks
24
+ - Apply design patterns
25
+ - Remove duplication
26
+
27
+ ### Actions to Avoid
28
+ - Unnecessary changes
29
+ - Excessive abstraction
30
+ - Behavior changes
31
+
32
+ ### AI Settings
33
+ - **Temperature**: 0.5 (balanced analysis)
34
+ - **Analysis Depth**: Deep
35
+
36
+ ## Execution Model
37
+ - **Primary**: Codex (code analysis and optimization)
38
+ - **Secondary**: ClaudeCode (complex refactoring)
39
+ - **Mode**: Deep Dive - in-depth code analysis
40
+
41
+ ## Goals
42
+ 1. Code quality improvement
43
+ 2. Duplication removal
44
+ 3. Performance optimization
45
+ 4. Architecture improvement
46
+
47
+ ## Input Files
48
48
  - `../06-implementation/outputs/source_code/`
49
49
  - `../06-implementation/outputs/implementation_log.md`
50
50
  - `../06-implementation/HANDOFF.md`
51
51
 
52
- ## 출력 파일
53
- - `outputs/refactored_code/` - 리팩토링된 코드
54
- - `outputs/refactoring_report.md` - 리팩토링 보고서
55
- - `HANDOFF.md` - 다음 스테이지 인계 문서
52
+ ## Output Files
53
+ - `outputs/refactored_code/` - Refactored code
54
+ - `outputs/refactoring_report.md` - Refactoring report
55
+ - `HANDOFF.md` - Handoff document for next stage
56
56
 
57
- ## Codex CLI 활용
57
+ ## Codex CLI Usage
58
58
 
59
- ### 코드 분석
59
+ ### Code Analysis
60
60
  ```bash
61
- /codex "다음 코드의 개선점을 분석해주세요:
62
- - 중복 코드
63
- - 성능 병목
64
- - 디자인 패턴 위반
65
- - 타입 안전성 문제"
61
+ /codex "Analyze the following code for improvements:
62
+ - Duplicate code
63
+ - Performance bottlenecks
64
+ - Design pattern violations
65
+ - Type safety issues"
66
66
  ```
67
67
 
68
- ### 리팩토링 실행
68
+ ### Refactoring Execution
69
69
  ```bash
70
- /codex "다음 함수를 리팩토링해주세요:
71
- [코드 블록]
72
- 목표: 가독성 향상, 성능 최적화"
70
+ /codex "Refactor the following function:
71
+ [code block]
72
+ Goals: Improve readability, optimize performance"
73
73
  ```
74
74
 
75
- ## 워크플로우
75
+ ## Workflow
76
76
 
77
- ### 1. 코드 분석
78
- - 정적 분석 실행 (ESLint, TypeScript)
79
- - 복잡도 분석 (Cyclomatic complexity)
80
- - 의존성 분석
77
+ ### 1. Code Analysis
78
+ - Run static analysis (ESLint, TypeScript)
79
+ - Complexity analysis (Cyclomatic complexity)
80
+ - Dependency analysis
81
81
 
82
- ### 2. 리팩토링 계획
83
- - 개선 영역 식별
84
- - 우선순위 결정
85
- - 영향 범위 평가
82
+ ### 2. Refactoring Plan
83
+ - Identify improvement areas
84
+ - Determine priorities
85
+ - Evaluate impact scope
86
86
 
87
- ### 3. 리팩토링 실행
88
- - 작은 단위로 수행
89
- - 변경 테스트
90
- - 커밋 메시지에 변경 사항 기록
87
+ ### 3. Refactoring Execution
88
+ - Perform in small units
89
+ - Test after each change
90
+ - Record changes in commit messages
91
91
 
92
- ### 4. 최적화
93
- - 번들 사이즈 최적화
94
- - 렌더링 최적화
95
- - API 호출 최적화
92
+ ### 4. Optimization
93
+ - Bundle size optimization
94
+ - Rendering optimization
95
+ - API call optimization
96
96
 
97
- ## 체크포인트 규칙
98
- - **필수**: 스테이지는 체크포인트가 필수입니다
99
- - 주요 리팩토링 체크포인트 생성
100
- - 롤백 가능 상태 유지
97
+ ## Checkpoint Rules
98
+ - **Required**: Checkpoints are mandatory for this stage
99
+ - Create checkpoint before major refactoring
100
+ - Maintain rollback-ready state
101
101
 
102
102
  ---
103
103
 
104
- ## ⚠️ AI 사용 기록 (필수)
104
+ ## ⚠️ AI Usage Recording (Required)
105
105
 
106
- > **중요**: 스테이지는 Codex CLI를 사용해야 합니다.
107
- > Codex 호출 실패 ClaudeCode 폴백되며, 경우 HANDOFF.md에 반드시 기록해야 합니다.
106
+ > **Important**: This stage requires Codex CLI.
107
+ > If Codex call fails, it falls back to ClaudeCode, and this must be recorded in HANDOFF.md.
108
108
 
109
- ### Codex 호출 전 확인
109
+ ### Pre-Codex Call Verification
110
110
  ```bash
111
- # 1. Codex CLI 설치 확인
111
+ # 1. Verify Codex CLI installation
112
112
  which codex
113
113
 
114
- # 2. tmux 세션 확인
114
+ # 2. Check tmux session
115
115
  tmux ls
116
116
 
117
- # 3. 사전 점검 (권장)
117
+ # 3. Pre-run check (recommended)
118
118
  ./scripts/pre-run-check.sh
119
119
  ```
120
120
 
121
- ### Codex 폴백 시 HANDOFF.md 기록
122
- Codex CLI 사용이 불가능하여 ClaudeCode로 폴백한 경우:
121
+ ### HANDOFF.md Recording on Codex Fallback
122
+ When Codex CLI is unavailable and falls back to ClaudeCode:
123
123
 
124
124
  ```markdown
125
- ### 폴백 기록
125
+ ### Fallback Record
126
126
 
127
- | 시도한 AI | 실패 시간 | 오류 | 폴백 AI | 결과 |
128
- |----------|----------|------|---------|------|
129
- | Codex | HH:MM | [오류 내용] | ClaudeCode | 성공/실패 |
127
+ | Attempted AI | Failure Time | Error | Fallback AI | Result |
128
+ |--------------|--------------|-------|-------------|--------|
129
+ | Codex | HH:MM | [Error content] | ClaudeCode | Success/Failure |
130
130
 
131
- **폴백 사유**: [상세 사유]
132
- **영향**: Codex의 깊이 있는 분석 미활용
131
+ **Fallback Reason**: [Detailed reason]
132
+ **Impact**: Deep analysis from Codex not utilized
133
133
  ```
134
134
 
135
135
  ---
136
136
 
137
- ## ⚠️ Test-First 플로우 (필수)
137
+ ## ⚠️ Test-First Flow (Required)
138
138
 
139
- > **중요**: 리팩토링 기존 기능이 깨지지 않았는지 반드시 회귀 테스트를 실행하세요.
139
+ > **Important**: Run regression tests after refactoring to ensure existing functionality is not broken.
140
140
 
141
- ### 리팩토링 완료 필수 테스트
141
+ ### Required Tests After Refactoring
142
142
 
143
143
  ```bash
144
- # 1. 기존 테스트 실행 (회귀 방지)
144
+ # 1. Run existing tests (regression prevention)
145
145
  npm run test
146
146
 
147
- # 2. 정적 분석
147
+ # 2. Static analysis
148
148
  npm run lint
149
149
 
150
- # 3. 타입 체크
150
+ # 3. Type check
151
151
  npm run typecheck
152
152
 
153
- # 4. 개발 서버 실행 확인
153
+ # 4. Verify dev server runs
154
154
  npm run dev
155
155
  ```
156
156
 
157
- ### 테스트 실패 조치
158
- 1. **회귀 테스트 실패**: 리팩토링 롤백 또는 수정
159
- 2. **lint 오류**: 리팩토링된 코드 수정
160
- 3. **typecheck 오류**: 타입 정의 수정
161
- 4. **동작 변경 발견**: 의도적 변경인지 확인, 아니면 롤백
157
+ ### Actions on Test Failure
158
+ 1. **Regression test failure**: Rollback refactoring or fix
159
+ 2. **lint errors**: Fix refactored code
160
+ 3. **typecheck errors**: Fix type definitions
161
+ 4. **Behavior change detected**: Verify if intentional, otherwise rollback
162
162
 
163
163
  ---
164
164
 
165
- ## 완료 조건
166
- - [ ] 코드 품질 분석 완료
167
- - [ ] 중복 코드 제거
168
- - [ ] 성능 최적화 적용
169
- - [ ] **회귀 테스트 실행** (Test-First)
170
- - [ ] **lint/typecheck 통과**
171
- - [ ] 리팩토링 보고서 작성
172
- - [ ] 체크포인트 생성
173
- - [ ] HANDOFF.md 생성 (AI 사용/폴백 기록 포함)
174
-
175
- ## 다음 스테이지
176
- → **08-qa**: 품질 보증 코드 리뷰
177
-
178
-
179
-
180
-
165
+ ## Completion Criteria
166
+ - [ ] Code quality analysis complete
167
+ - [ ] Duplicate code removed
168
+ - [ ] Performance optimization applied
169
+ - [ ] **Regression tests executed** (Test-First)
170
+ - [ ] **lint/typecheck passed**
171
+ - [ ] Refactoring report written
172
+ - [ ] Checkpoint created
173
+ - [ ] HANDOFF.md generated (including AI usage/fallback records)
174
+
175
+ ## Next Stage
176
+ → **08-qa**: Quality assurance and code review
@@ -3,14 +3,14 @@
3
3
  stage:
4
4
  id: "07-refactoring"
5
5
  name: "Refactoring"
6
- description: "코드 품질 개선 최적화"
6
+ description: "Code quality improvement and optimization"
7
7
 
8
8
  models:
9
9
  primary: "codex"
10
10
  secondary: "claudecode"
11
11
  collaboration: "sequential"
12
12
 
13
- # AI 자동 호출 설정 (Issue #12, #14 해결)
13
+ # AI auto-invoke settings (Issue #12, #14 resolution)
14
14
  auto_invoke:
15
15
  enabled: true
16
16
  model: "codex"
@@ -19,7 +19,7 @@ auto_invoke:
19
19
  wrapper: "scripts/codex-wrapper.sh"
20
20
  flags: "--full-auto"
21
21
  required: true
22
- message: "🤖 Codex 자동 호출: 코드 분석 리팩토링 시작"
22
+ message: "🤖 Codex auto-invoke: Starting code analysis and refactoring"
23
23
 
24
24
  execution:
25
25
  mode: "deep_dive"
@@ -36,9 +36,9 @@ inputs:
36
36
  outputs:
37
37
  required:
38
38
  - name: "refactored_code/"
39
- description: "리팩토링된 코드"
39
+ description: "Refactored code"
40
40
  - name: "refactoring_report.md"
41
- description: "리팩토링 보고서"
41
+ description: "Refactoring report"
42
42
  - name: "HANDOFF.md"
43
43
 
44
44
  prompts:
@@ -54,15 +54,15 @@ prompts:
54
54
 
55
55
  completion:
56
56
  checklist:
57
- - "코드 품질 분석 완료"
58
- - "중복 코드 제거"
59
- - "성능 최적화 적용"
60
- - "리팩토링 보고서 작성"
61
- - "체크포인트 생성"
57
+ - "Code quality analysis complete"
58
+ - "Duplicate code removed"
59
+ - "Performance optimization applied"
60
+ - "Refactoring report written"
61
+ - "Checkpoint created"
62
62
 
63
63
  transition:
64
64
  next_stage: "08-qa"
65
65
  prerequisites:
66
66
  - "06-implementation"
67
67
  handoff_required: true
68
- checkpoint_required: true # 필수!
68
+ checkpoint_required: true # Required!