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
@@ -1,64 +1,64 @@
1
1
  # /deploy
2
2
 
3
- 10-deployment 스테이지를 바로 시작합니다.
3
+ Start the 10-deployment stage directly.
4
4
 
5
- ## 사용법
5
+ ## Usage
6
6
  ```
7
7
  /deploy [environment]
8
8
  ```
9
9
 
10
- ## 스테이지 정보
10
+ ## Stage Information
11
11
 
12
- | 항목 | |
13
- |------|-----|
14
- | 스테이지 | 10-deployment |
15
- | AI 모델 | ClaudeCode |
16
- | 실행 모드 | Headless |
17
- | 체크포인트 | 선택 |
12
+ | Item | Value |
13
+ |------|-------|
14
+ | Stage | 10-deployment |
15
+ | AI Model | ClaudeCode |
16
+ | Execution Mode | Headless |
17
+ | Checkpoint | Optional |
18
18
 
19
- ## 동작
19
+ ## Actions
20
20
 
21
- 1. **전제 조건 확인**
22
- - 09-testing 완료 여부
23
- - test-results.md 존재
24
- - 모든 테스트 통과
21
+ 1. **Prerequisite Check**
22
+ - 09-testing completion status
23
+ - test-results.md exists
24
+ - All tests passed
25
25
 
26
- 2. **배포 실행**
27
- - CI/CD 파이프라인 설정
28
- - 환경별 배포
29
- - 모니터링 설정
26
+ 2. **Execute Deployment**
27
+ - CI/CD pipeline setup
28
+ - Environment-specific deployment
29
+ - Monitoring setup
30
30
 
31
- 3. **산출물 생성**
32
- - CI/CD 설정 파일
31
+ 3. **Output Generation**
32
+ - CI/CD configuration files
33
33
  - deployment-log.md
34
34
 
35
- ## 실행
35
+ ## Execution
36
36
 
37
37
  ```bash
38
38
  scripts/run-stage.sh 10-deployment "$ARGUMENTS"
39
39
  ```
40
40
 
41
- ## 입력 파일
41
+ ## Input Files
42
42
 
43
43
  - `stages/09-testing/outputs/test-results.md`
44
44
  - `stages/06-implementation/outputs/src/`
45
- - 모든 이전 스테이지 outputs
45
+ - All previous stage outputs
46
46
 
47
- ## 출력 파일
47
+ ## Output Files
48
48
 
49
49
  - `.github/workflows/ci.yaml`
50
50
  - `.github/workflows/cd.yaml`
51
51
  - `stages/10-deployment/outputs/deployment-log.md`
52
52
 
53
- ## 배포 환경
53
+ ## Deployment Environments
54
54
 
55
- | 환경 | 설명 |
56
- |------|------|
57
- | dev | 개발 환경 |
58
- | staging | 스테이징 |
59
- | prod | 프로덕션 |
55
+ | Environment | Description |
56
+ |-------------|-------------|
57
+ | dev | Development environment |
58
+ | staging | Staging |
59
+ | prod | Production |
60
60
 
61
- ## CI/CD 워크플로우
61
+ ## CI/CD Workflow
62
62
 
63
63
  ```
64
64
  Push
@@ -72,31 +72,31 @@ CD (Deploy)
72
72
  Health Check
73
73
  ```
74
74
 
75
- ## 관련 명령어
75
+ ## Related Commands
76
76
 
77
- - `/run-stage 10` - 전제조건 확인 시작
78
- - `/test` - 이전 스테이지
79
- - `/status` - 파이프라인 상태
77
+ - `/run-stage 10` - Start after prerequisite check
78
+ - `/test` - Previous stage
79
+ - `/status` - Pipeline status
80
80
 
81
- ## 배포 체크리스트
81
+ ## Deployment Checklist
82
82
 
83
- - [ ] 환경 변수 설정
84
- - [ ] 시크릿 설정 (GitHub Secrets)
85
- - [ ] 도메인/DNS 설정
86
- - [ ] SSL 인증서
87
- - [ ] 모니터링 설정
88
- - [ ] 롤백 계획
83
+ - [ ] Environment variables configured
84
+ - [ ] Secrets configured (GitHub Secrets)
85
+ - [ ] Domain/DNS configured
86
+ - [ ] SSL certificate
87
+ - [ ] Monitoring configured
88
+ - [ ] Rollback plan
89
89
 
90
- ## 완료
90
+ ## On Completion
91
91
 
92
- 🎉 **파이프라인 완료!**
92
+ 🎉 **Pipeline Complete!**
93
93
 
94
- 모든 10 스테이지가 완료되었습니다.
95
- - `/status`로 최종 상태 확인
96
- - `state/handoffs/`에서 전체 문서 검토
94
+ All 10 stages completed.
95
+ - Check final status with `/status`
96
+ - Review all documents in `state/handoffs/`
97
97
 
98
98
  ## Tips
99
99
 
100
- - prod 배포 staging 검증
101
- - 롤백 스크립트 준비
102
- - 배포 스모크 테스트
100
+ - Verify in staging before prod deployment
101
+ - Prepare rollback script
102
+ - Run smoke tests after deployment
@@ -1,57 +1,57 @@
1
1
  # /fork - Pipeline Forking Command
2
2
 
3
- 파이프라인을 분기하여 여러 접근법을 동시에 탐색합니다.
3
+ Fork the pipeline to explore multiple approaches simultaneously.
4
4
 
5
- ## 사용법
5
+ ## Usage
6
6
 
7
7
  ```bash
8
8
  /fork [options]
9
9
  ```
10
10
 
11
- ## 옵션
11
+ ## Options
12
12
 
13
- | 옵션 | 설명 | 기본값 |
14
- |------|------|--------|
15
- | `--reason` | 분기 이유 (필수) | - |
16
- | `--name` | 분기 이름 | auto |
17
- | `--direction` | 탐색 방향 설명 | - |
18
- | `--compare` | 기존 분기와 비교 | false |
19
- | `--merge` | 분기 병합 | false |
20
- | `--list` | 활성 분기 목록 | false |
13
+ | Option | Description | Default |
14
+ |--------|-------------|---------|
15
+ | `--reason` | Fork reason (required) | - |
16
+ | `--name` | Fork name | auto |
17
+ | `--direction` | Exploration direction description | - |
18
+ | `--compare` | Compare with existing forks | false |
19
+ | `--merge` | Merge fork | false |
20
+ | `--list` | List active forks | false |
21
21
 
22
- ## 기본 사용
22
+ ## Basic Usage
23
23
 
24
- ### 분기 생성
24
+ ### Create New Fork
25
25
  ```bash
26
- /fork --reason "아키텍처 대안 탐색"
26
+ /fork --reason "architecture alternative exploration"
27
27
  ```
28
28
 
29
- ### 분기 목록 확인
29
+ ### Check Fork List
30
30
  ```bash
31
31
  /fork --list
32
32
  ```
33
33
 
34
- ### 분기 비교
34
+ ### Compare Forks
35
35
  ```bash
36
36
  /fork --compare
37
37
  ```
38
38
 
39
- ### 분기 병합
39
+ ### Merge Fork
40
40
  ```bash
41
41
  /fork --merge --select "fork_03_alternative_a"
42
42
  ```
43
43
 
44
- ## 분기 프로세스
44
+ ## Fork Process
45
45
 
46
46
  ```
47
- 1. 현재 상태 체크포인트 생성
48
- 2. 분기 디렉토리 생성 (state/forks/)
49
- 3. 상태 복사
50
- 4. 분기용 HANDOFF 생성
51
- 5. 분기 작업 시작
47
+ 1. Create checkpoint of current state
48
+ 2. Create fork directory (state/forks/)
49
+ 3. Copy state
50
+ 4. Generate fork HANDOFF
51
+ 5. Start fork work
52
52
  ```
53
53
 
54
- ## 분기 비교 출력
54
+ ## Fork Comparison Output
55
55
 
56
56
  ```markdown
57
57
  # Fork Comparison
@@ -71,46 +71,46 @@
71
71
  | Maintainability | 0.88 | 0.85 | 0.80 |
72
72
 
73
73
  ## Recommendation
74
- **Alt A** 권장: 높은 코드 품질
74
+ **Alt A** recommended: Higher code quality
75
75
  ```
76
76
 
77
- ## 병합 전략
77
+ ## Merge Strategies
78
78
 
79
79
  ### best_performer
80
80
  ```bash
81
81
  /fork --merge --strategy best_performer
82
82
  ```
83
- - 메트릭 기반 최고 성능 분기 선택
83
+ - Select best performing fork based on metrics
84
84
 
85
85
  ### manual
86
86
  ```bash
87
87
  /fork --merge --strategy manual --select "fork_01"
88
88
  ```
89
- - 수동 선택
89
+ - Manual selection
90
90
 
91
91
  ### cherry_pick
92
92
  ```bash
93
93
  /fork --merge --strategy cherry_pick
94
94
  ```
95
- - 여러 분기에서 최적 부분 선택
95
+ - Select optimal parts from multiple forks
96
96
 
97
- ## 예시
97
+ ## Examples
98
98
 
99
99
  ```bash
100
- # 아키텍처 대안 탐색을 위한 분기
101
- /fork --reason "REST vs GraphQL 비교" --direction "GraphQL 방식 구현"
100
+ # Fork for architecture alternative exploration
101
+ /fork --reason "REST vs GraphQL comparison" --direction "GraphQL implementation"
102
102
 
103
- # 현재 분기 상태 확인
103
+ # Check current fork status
104
104
  /fork --list
105
105
 
106
- # 분기 비교 메트릭 확인
106
+ # Compare forks and check metrics
107
107
  /fork --compare
108
108
 
109
- # 최고 성능 분기로 병합
109
+ # Merge best performing fork
110
110
  /fork --merge --strategy best_performer
111
111
  ```
112
112
 
113
- ## 분기 저장 위치
113
+ ## Fork Storage Location
114
114
 
115
115
  ```
116
116
  state/forks/
@@ -125,18 +125,18 @@ state/forks/
125
125
  └── comparison.json
126
126
  ```
127
127
 
128
- ## 설정
128
+ ## Configuration
129
129
 
130
- `config/pipeline_forking.yaml` 참조
130
+ See `config/pipeline_forking.yaml`
131
131
 
132
- ## 제한사항
132
+ ## Limitations
133
133
 
134
- - 최대 활성 분기: 3
135
- - 분기 최대 실행 시간: 2시간
136
- - 병합 체크포인트 자동 생성
134
+ - Max active forks: 3
135
+ - Max fork execution time: 2 hours
136
+ - Checkpoint auto-created before merge
137
137
 
138
- ## 관련 커맨드
138
+ ## Related Commands
139
139
 
140
- - `/checkpoint` - 체크포인트 생성
141
- - `/restore` - 체크포인트 복구
142
- - `/status` - 파이프라인 상태
140
+ - `/checkpoint` - Create checkpoint
141
+ - `/restore` - Restore checkpoint
142
+ - `/status` - Pipeline status
@@ -1,84 +1,84 @@
1
1
  # /gemini
2
2
 
3
- tmux 세션을 통해 Gemini CLI 호출합니다.
3
+ Call Gemini CLI through tmux session.
4
4
 
5
- ## 사용법
5
+ ## Usage
6
6
  ```
7
7
  /gemini [prompt]
8
8
  ```
9
9
 
10
- ## 동작
10
+ ## Actions
11
11
 
12
- 1. **tmux 세션 확인/생성**
13
- - 세션명: `ax-gemini`
14
- - 없으면 새로 생성
12
+ 1. **Check/Create tmux Session**
13
+ - Session name: `ax-gemini`
14
+ - Create new if not exists
15
15
 
16
- 2. **Gemini CLI 실행**
17
- - 프롬프트 전송
18
- - 응답 대기 (wait-for 방식)
16
+ 2. **Execute Gemini CLI**
17
+ - Send prompt
18
+ - Wait for response (wait-for method)
19
19
 
20
- 3. **결과 캡처 반환**
21
- - 출력 파일에서 결과 읽기
22
- - 사용자에게 표시
20
+ 3. **Capture and Return Results**
21
+ - Read results from output file
22
+ - Display to user
23
23
 
24
- ## 실행 스크립트
24
+ ## Execution Script
25
25
 
26
26
  ```bash
27
27
  scripts/gemini-wrapper.sh "$ARGUMENTS"
28
28
  ```
29
29
 
30
- ## 예시
30
+ ## Example
31
31
 
32
32
  ```
33
- /gemini Reddit의 r/programming에서 Claude Code 관련 최신 게시물을 요약해주세요
33
+ /gemini Please summarize recent posts about Claude Code from Reddit r/programming
34
34
 
35
- Gemini 호출 중...
36
- 세션: ax-gemini
37
- 타임아웃: 300
35
+ Calling Gemini...
36
+ Session: ax-gemini
37
+ Timeout: 300 seconds
38
38
 
39
- [응답]
40
- Reddit r/programming에서 Claude Code 관련 최신 게시물:
39
+ [Response]
40
+ Recent posts about Claude Code from Reddit r/programming:
41
41
 
42
- 1. "Claude Code로 전체 프로젝트 리팩토링한 경험" (3 )
43
- - 200줄 이상의 함수를 깔끔하게 분리
44
- - 테스트 커버리지 30% 85%로 향상
45
- - 장점: 컨텍스트 이해력, 단점: 파일 처리 속도
42
+ 1. "My experience refactoring an entire project with Claude Code" (3 days ago)
43
+ - Cleanly split functions over 200 lines
44
+ - Test coverage improved from 30% to 85%
45
+ - Pros: Context understanding, Cons: Large file processing speed
46
46
 
47
47
  2. ...
48
48
  ```
49
49
 
50
- ## 활용 시나리오
50
+ ## Usage Scenarios
51
51
 
52
- ### 1. 브레인스토밍 (01-brainstorm)
52
+ ### 1. Brainstorming (01-brainstorm)
53
53
  ```
54
- /gemini 다음 프로젝트에 대해 창의적인 아이디어 10개를 발산해주세요:
55
- [프로젝트 설명]
54
+ /gemini Please brainstorm 10 creative ideas for the following project:
55
+ [project description]
56
56
  ```
57
57
 
58
- ### 2. 리서치 (02-research)
58
+ ### 2. Web Research (02-research)
59
59
  ```
60
- /gemini 최신 React 서버 컴포넌트 베스트 프랙티스를 웹에서 검색해주세요
60
+ /gemini Please search the web for latest React Server Components best practices
61
61
  ```
62
62
 
63
- ### 3. 경쟁사 분석
63
+ ### 3. Competitor Analysis
64
64
  ```
65
- /gemini [경쟁사 URL]의 기능과 UI 분석해주세요
65
+ /gemini Please analyze the features and UI of [competitor URL]
66
66
  ```
67
67
 
68
- ## 타임아웃
68
+ ## Timeout
69
69
 
70
- 기본 타임아웃: 300 (5)
70
+ Default timeout: 300 seconds (5 minutes)
71
71
 
72
- 변경:
72
+ To change:
73
73
  ```
74
- /gemini --timeout 600 [ 작업 프롬프트]
74
+ /gemini --timeout 600 [long task prompt]
75
75
  ```
76
76
 
77
- ## 제한사항
78
- - Gemini CLI 설치되어 있어야
79
- - tmux 설치되어 있어야
80
- - 대화형 프롬프트는 지원하지 않음 (단발성 질의만)
77
+ ## Limitations
78
+ - Gemini CLI must be installed
79
+ - tmux must be installed
80
+ - Interactive prompts not supported (single queries only)
81
81
 
82
- ## 관련
83
- - `/codex`: Codex CLI 호출
84
- - `scripts/gemini-wrapper.sh`: 래퍼 스크립트
82
+ ## Related
83
+ - `/codex`: Codex CLI call
84
+ - `scripts/gemini-wrapper.sh`: Wrapper script
@@ -1,80 +1,80 @@
1
1
  # /handoff
2
2
 
3
- 현재 스테이지의 HANDOFF.md 문서를 생성합니다.
3
+ Generate the HANDOFF.md document for the current stage.
4
4
 
5
- ## 사용법
5
+ ## Usage
6
6
  ```
7
7
  /handoff
8
8
  ```
9
9
 
10
- ## 동작
10
+ ## Actions
11
11
 
12
- 1. **현재 스테이지 확인**
13
- - `state/progress.json`에서 현재 스테이지 조회
12
+ 1. **Check Current Stage**
13
+ - Query current stage from `state/progress.json`
14
14
 
15
- 2. **완료 조건 검증**
16
- - 스테이지 config.yaml의 completion.checklist 확인
17
- - 필수 출력 파일 존재 확인
15
+ 2. **Verify Completion Criteria**
16
+ - Check completion.checklist in stage config.yaml
17
+ - Verify required output files exist
18
18
 
19
- 3. **HANDOFF.md 생성**
20
- - `HANDOFF.md.template` 기반으로 생성
21
- - 변수 치환 (타임스탬프, 산출물 )
22
- - 사용자 입력 받기 (핵심 결정사항 )
19
+ 3. **Generate HANDOFF.md**
20
+ - Generate based on `HANDOFF.md.template`
21
+ - Variable substitution (timestamp, deliverables, etc.)
22
+ - Get user input (key decisions, etc.)
23
23
 
24
- 4. **상태 업데이트**
25
- - `state/progress.json` 핸드오프 완료 표시
26
- - `state/handoffs/` 디렉토리에 복사본 저장
24
+ 4. **Update State**
25
+ - Mark handoff complete in `state/progress.json`
26
+ - Save copy to `state/handoffs/` directory
27
27
 
28
- 5. **다음 스테이지 안내**
29
- - 다음 스테이지 정보 표시
30
- - `/run-stage [next]` 명령어 안내
28
+ 5. **Next Stage Guidance**
29
+ - Display next stage information
30
+ - Guide `/run-stage [next]` command
31
31
 
32
- ## 실행 스크립트
32
+ ## Execution Script
33
33
 
34
34
  ```bash
35
35
  scripts/create-handoff.sh
36
36
  ```
37
37
 
38
- ## 예시
38
+ ## Example
39
39
 
40
40
  ```
41
41
  /handoff
42
42
 
43
- 현재 스테이지: 01-brainstorm
43
+ Current stage: 01-brainstorm
44
44
 
45
- 완료 조건 검증:
46
- 최소 10 아이디어 생성
47
- ✓ 3 이상 사용자 페르소나 정의
48
- 요구사항 분석 문서 완성
45
+ Completion criteria verification:
46
+ Minimum 10 ideas generated
47
+ ✓ 3+ user personas defined
48
+ Requirements analysis document completed
49
49
 
50
- 핵심 결정사항을 입력해주세요:
51
- > MVP 인증, 핵심기능 A, 핵심기능 B로 한정
50
+ Please enter key decisions:
51
+ > MVP limited to authentication, core feature A, core feature B
52
52
 
53
- HANDOFF.md 생성 완료!
54
- - 위치: stages/01-brainstorm/HANDOFF.md
55
- - 백업: state/handoffs/01-brainstorm-20240120-1030.md
53
+ HANDOFF.md generation complete!
54
+ - Location: stages/01-brainstorm/HANDOFF.md
55
+ - Backup: state/handoffs/01-brainstorm-20240120-1030.md
56
56
 
57
- 다음 단계:
57
+ Next step:
58
58
  /run-stage 02-research
59
59
  ```
60
60
 
61
- ## 완료 조건 미충족
61
+ ## When Completion Criteria Not Met
62
62
 
63
63
  ```
64
64
  /handoff
65
65
 
66
- 현재 스테이지: 01-brainstorm
66
+ Current stage: 01-brainstorm
67
67
 
68
- 완료 조건 검증:
69
- 최소 10 아이디어 생성
70
- ✗ 3 이상 사용자 페르소나 정의 (현재: 2)
71
- 요구사항 분석 문서 완성
68
+ Completion criteria verification:
69
+ Minimum 10 ideas generated
70
+ ✗ 3+ user personas defined (current: 2)
71
+ Requirements analysis document completed
72
72
 
73
- 완료 조건을 충족해주세요.
74
- 또는 --force 옵션으로 강제 생성:
73
+ Please meet the completion criteria.
74
+ Or use --force option to force generation:
75
75
  /handoff --force
76
76
  ```
77
77
 
78
- ## 옵션
79
- - `--force`: 완료 조건 미충족 시에도 강제 생성
80
- - `--draft`: 초안으로 생성 (다음 스테이지 진행 불가)
78
+ ## Options
79
+ - `--force`: Force generation even when completion criteria not met
80
+ - `--draft`: Generate as draft (cannot proceed to next stage)