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,94 +1,94 @@
1
1
  # Smart HANDOFF - Contextual Summarization
2
2
 
3
- ## 자동 요약 생성
3
+ ## Auto Summary Generation
4
4
 
5
- ### 1. 완료된 작업핵심 성과
5
+ ### 1. Completed WorkKey Achievements
6
6
 
7
- **입력**: 상세한 태스크 목록
8
- **출력**: 압축된 성과 요약
7
+ **Input**: Detailed task list
8
+ **Output**: Compressed achievement summary
9
9
 
10
10
  ```markdown
11
- ## 변환 예시
12
-
13
- ### Before (상세)
14
- - [x] UserService 클래스 생성
15
- - [x] 로그인 메서드 구현
16
- - [x] 회원가입 메서드 구현
17
- - [x] 비밀번호 해시 처리 추가
18
- - [x] 에러 핸들링 추가
19
-
20
- ### After (압축)
21
- **사용자 인증 시스템 구현 완료**
22
- - UserService: 로그인/회원가입/비밀번호 해시
11
+ ## Transformation Example
12
+
13
+ ### Before (Detailed)
14
+ - [x] Create UserService class
15
+ - [x] Implement login method
16
+ - [x] Implement signup method
17
+ - [x] Add password hash handling
18
+ - [x] Add error handling
19
+
20
+ ### After (Compressed)
21
+ **User authentication system implementation complete**
22
+ - UserService: login/signup/password hash
23
23
  ```
24
24
 
25
- ### 2. 파일 변경영향도 분석
25
+ ### 2. File ChangesImpact Analysis
26
26
 
27
27
  ```markdown
28
- ## 영향도 분석 템플릿
28
+ ## Impact Analysis Template
29
29
 
30
- ### 고영향 변경
31
- | 파일 | 변경 | 영향 범위 |
32
- |------|------|----------|
33
- | src/auth/UserService.ts | 신규 | 인증 전체 |
30
+ ### High Impact Changes
31
+ | File | Change | Impact Scope |
32
+ |------|--------|--------------|
33
+ | src/auth/UserService.ts | New | All authentication |
34
34
 
35
- ### 저영향 변경
36
- - config 파일 업데이트 (3)
37
- - 테스트 파일 추가 (2)
35
+ ### Low Impact Changes
36
+ - Config file updates (3)
37
+ - Test file additions (2)
38
38
  ```
39
39
 
40
- ### 3. 결정 사항 구조화된 기록
40
+ ### 3. DecisionsStructured Record
41
41
 
42
42
  ```markdown
43
- ## 결정 기록 형식
43
+ ## Decision Record Format
44
44
 
45
- ### 🔷 [결정 제목]
46
- - **결정**: [최종 선택]
47
- - **이유**: [핵심 근거 1-2문장]
48
- - **영향**: [영향받는 영역]
45
+ ### 🔷 [Decision Title]
46
+ - **Decision**: [Final choice]
47
+ - **Reason**: [Core rationale in 1-2 sentences]
48
+ - **Impact**: [Affected areas]
49
49
  ```
50
50
 
51
- ### 4. 다음 단계즉시 실행 가능 형태
51
+ ### 4. Next StepsImmediately Actionable Format
52
52
 
53
53
  ```markdown
54
- ## 다음 단계 형식
54
+ ## Next Steps Format
55
55
 
56
- ### 즉시 실행 (다음 세션 시작 )
57
- 1. `npm install` - 의존성 설치
58
- 2. `src/components/` 디렉토리에서 작업 재개
59
- 3. UserProfile 컴포넌트 구현
56
+ ### Immediate Actions (On next session start)
57
+ 1. `npm install` - Install dependencies
58
+ 2. Resume work in `src/components/` directory
59
+ 3. Implement UserProfile component
60
60
 
61
- ### 참조 필요
62
- - 아키텍처: `stages/03-planning/outputs/architecture.md`
63
- - 디자인: `stages/04-ui-ux/outputs/design_system.md`
61
+ ### References Needed
62
+ - Architecture: `stages/03-planning/outputs/architecture.md`
63
+ - Design: `stages/04-ui-ux/outputs/design_system.md`
64
64
  ```
65
65
 
66
- ## 스테이지별 요약 초점
66
+ ## Stage-Specific Summary Focus
67
67
 
68
68
  ### 01-brainstorm
69
- - **강조**: 아이디어, 요구사항
70
- - **약화**: 기술적 세부사항
69
+ - **Emphasize**: Ideas, requirements
70
+ - **Minimize**: Technical details
71
71
 
72
72
  ### 06-implementation
73
- - **강조**: 코드 변경, 기술 결정
74
- - **약화**: 아이디어/기획
73
+ - **Emphasize**: Code changes, technical decisions
74
+ - **Minimize**: Ideas/planning
75
75
 
76
76
  ### 08-qa
77
- - **강조**: 버그, 테스트 결과
78
- - **약화**: 계획 세부사항
77
+ - **Emphasize**: Bugs, test results
78
+ - **Minimize**: Plan details
79
79
 
80
- ## 압축 비율
80
+ ## Compression Ratios
81
81
 
82
- | 원본 토큰 | 목표 압축 | 최대 토큰 |
83
- |----------|----------|----------|
82
+ | Original Tokens | Target Compression | Max Tokens |
83
+ |-----------------|-------------------|------------|
84
84
  | < 2000 | 100% | 2000 |
85
85
  | 2000-5000 | 50% | 2500 |
86
86
  | 5000-10000 | 30% | 3000 |
87
87
  | > 10000 | 25% | 4000 |
88
88
 
89
- ## 품질 검증
89
+ ## Quality Verification
90
90
 
91
- 생성된 요약 검증 기준:
92
- - **명확성**: 모호한 표현 없음
93
- - **완전성**: 핵심 정보 누락 없음
94
- - **실행 가능성**: 다음 단계가 구체적
91
+ Generated summary verification criteria:
92
+ - **Clarity**: No ambiguous expressions
93
+ - **Completeness**: No missing key information
94
+ - **Actionability**: Next steps are specific
@@ -1,84 +1,84 @@
1
1
  # Stage Transition Skill
2
2
 
3
- 스테이지 완료 감지 전환을 자동화하는 스킬입니다.
3
+ A skill that automates stage completion detection and transitions.
4
4
 
5
- ## 트리거 조건
5
+ ## Trigger Conditions
6
6
 
7
- 스킬은 다음 조건에서 자동 활성화됩니다:
7
+ This skill auto-activates under these conditions:
8
8
 
9
- 1. **완료 표현 감지**
10
- - "끝났어", "완료", "done", "finished" 등
11
- - 스테이지 관련 작업 종료 시
9
+ 1. **Completion expression detected**
10
+ - "done", "completed", "finished", etc.
11
+ - When stage-related work ends
12
12
 
13
- 2. **완료 조건 충족**
14
- - outputs 파일 모두 생성됨
15
- - config.yaml completion_criteria 충족
13
+ 2. **Completion criteria met**
14
+ - All outputs files generated
15
+ - config.yaml completion_criteria satisfied
16
16
 
17
- 3. **명시적 호출**
18
- - `/handoff` 명령 후
19
- - `/next` 명령 전
17
+ 3. **Explicit call**
18
+ - After `/handoff` command
19
+ - Before `/next` command
20
20
 
21
- ## 기능
21
+ ## Features
22
22
 
23
- ### 1. 완료 조건 검증 (validate.md)
24
- - 현재 스테이지의 필수 outputs 확인
25
- - 체크포인트 필수 여부 확인
26
- - 완료 체크리스트 자동 검증
23
+ ### 1. Completion Criteria Validation (validate.md)
24
+ - Check required outputs for current stage
25
+ - Check checkpoint requirements
26
+ - Auto-verify completion checklist
27
27
 
28
- ### 2. HANDOFF.md 생성 (handoff-gen.md)
29
- - 완료된 작업 요약
30
- - 핵심 결정사항 추출
31
- - 다음 단계 안내 생성
28
+ ### 2. HANDOFF.md Generation (handoff-gen.md)
29
+ - Summarize completed work
30
+ - Extract key decisions
31
+ - Generate next step guidance
32
32
 
33
- ### 3. 전환 안내 (prompts/transition.md)
34
- - 다음 스테이지 정보 제공
35
- - 입력 파일 위치 안내
36
- - 단축 명령어 제안
33
+ ### 3. Transition Guidance (prompts/transition.md)
34
+ - Provide next stage information
35
+ - Guide input file locations
36
+ - Suggest shortcut commands
37
37
 
38
- ## 스킬 파일 구조
38
+ ## Skill File Structure
39
39
 
40
40
  ```
41
41
  stage-transition/
42
- ├── README.md # 파일
43
- ├── validate.md # 완료 조건 검증 로직
44
- ├── handoff-gen.md # 핸드오프 자동 생성
42
+ ├── README.md # This file
43
+ ├── validate.md # Completion criteria validation logic
44
+ ├── handoff-gen.md # Handoff auto-generation
45
45
  └── prompts/
46
- └── transition.md # 전환 프롬프트
46
+ └── transition.md # Transition prompts
47
47
  ```
48
48
 
49
- ## 사용 예시
49
+ ## Usage Examples
50
50
 
51
- ### 자동 트리거
51
+ ### Auto Trigger
52
52
 
53
53
  ```
54
- 사용자: "브레인스토밍 끝났어"
54
+ User: "Brainstorming is done"
55
55
 
56
- [stage-transition 스킬 활성화]
57
- → 01-brainstorm 완료 조건 검증
58
- → HANDOFF.md 생성 제안
59
- 다음 단계 안내
56
+ [stage-transition skill activated]
57
+ Validate 01-brainstorm completion criteria
58
+ Suggest HANDOFF.md generation
59
+ Provide next step guidance
60
60
  ```
61
61
 
62
- ### 검증 결과 예시
62
+ ### Validation Result Example
63
63
 
64
64
  ```
65
- 스테이지 완료 조건 확인
65
+ Stage completion criteria verified
66
66
 
67
- 현재: 04-ui-ux
67
+ Current: 04-ui-ux
68
68
 
69
- [필수 outputs]
70
- ✓ wireframes/ 존재
71
- ✓ component-spec.md 생성됨
72
- ✓ design-system.md 생성됨
69
+ [Required outputs]
70
+ ✓ wireframes/ exists
71
+ ✓ component-spec.md generated
72
+ ✓ design-system.md generated
73
73
 
74
74
  [HANDOFF.md]
75
- ⚠️ 아직 생성되지 않음
75
+ ⚠️ Not yet generated
76
76
 
77
- 제안: /handoff 실행 /next로 전환하세요.
77
+ Suggestion: Run /handoff then transition with /next.
78
78
  ```
79
79
 
80
- ## 관련 명령어
80
+ ## Related Commands
81
81
 
82
- - `/handoff` - HANDOFF.md 생성
83
- - `/next` - 다음 스테이지 전환
84
- - `/status` - 현재 상태 확인
82
+ - `/handoff` - Generate HANDOFF.md
83
+ - `/next` - Transition to next stage
84
+ - `/status` - Check current status
@@ -1,88 +1,88 @@
1
- # HANDOFF.md 자동 생성
1
+ # HANDOFF.md Auto-Generation
2
2
 
3
- 스테이지 완료 시 HANDOFF.md 자동 생성합니다.
3
+ Auto-generates HANDOFF.md on stage completion.
4
4
 
5
- ## 생성 로직
5
+ ## Generation Logic
6
6
 
7
- ### 1. 컨텍스트 수집
7
+ ### 1. Context Collection
8
8
 
9
9
  ```
10
- 수집 항목:
11
- - 현재 스테이지 정보
12
- - 생성된 outputs 목록
13
- - 대화에서 추출한 결정사항
14
- - 다음 스테이지 요구사항
10
+ Collection items:
11
+ - Current stage information
12
+ - Generated outputs list
13
+ - Decisions extracted from conversation
14
+ - Next stage requirements
15
15
  ```
16
16
 
17
- ### 2. HANDOFF.md 구조
17
+ ### 2. HANDOFF.md Structure
18
18
 
19
19
  ```markdown
20
- # Handoff: [현재 스테이지] → [다음 스테이지]
20
+ # Handoff: [Current Stage] → [Next Stage]
21
21
 
22
- 생성일: {{TIMESTAMP}}
22
+ Generated: {{TIMESTAMP}}
23
23
 
24
- ## 완료된 작업
24
+ ## Completed Work
25
25
 
26
- - [x] 작업 1
27
- - [x] 작업 2
28
- - [x] 작업 3
26
+ - [x] Task 1
27
+ - [x] Task 2
28
+ - [x] Task 3
29
29
 
30
- ## 핵심 결정사항
30
+ ## Key Decisions
31
31
 
32
- ### 결정 1: [제목]
33
- - **선택**: [선택한 옵션]
34
- - **이유**: [선택 이유]
35
- - **영향**: [다음 단계에 미치는 영향]
32
+ ### Decision 1: [Title]
33
+ - **Choice**: [Selected option]
34
+ - **Reason**: [Selection reason]
35
+ - **Impact**: [Impact on next steps]
36
36
 
37
- ## 산출물
37
+ ## Outputs
38
38
 
39
- | 파일 | 설명 |
40
- |------|------|
41
- | file1.md | 설명 |
42
- | file2.json | 설명 |
39
+ | File | Description |
40
+ |------|-------------|
41
+ | file1.md | Description |
42
+ | file2.json | Description |
43
43
 
44
- ## 시도했으나 실패한 접근법
44
+ ## Failed Approaches
45
45
 
46
- (해당 )
47
- - 접근법 1: [실패 이유]
46
+ (If applicable)
47
+ - Approach 1: [Failure reason]
48
48
 
49
- ## 다음 단계
49
+ ## Next Steps
50
50
 
51
- ### 즉시 실행 작업
52
- 1. [작업 1]
53
- 2. [작업 2]
51
+ ### Immediate Actions
52
+ 1. [Action 1]
53
+ 2. [Action 2]
54
54
 
55
- ### 참고 파일
55
+ ### Reference Files
56
56
  - stages/[current]/outputs/[file]
57
57
 
58
- ## 체크포인트
58
+ ## Checkpoint
59
59
 
60
- (해당 )
60
+ (If applicable)
61
61
  - ID: CP-XX-YYYYMMDD-HHMM
62
- - 설명: [설명]
62
+ - Description: [Description]
63
63
  ```
64
64
 
65
- ### 3. 결정사항 추출
65
+ ### 3. Decision Extraction
66
66
 
67
- 대화에서 결정사항을 추출하는 패턴:
67
+ Patterns to extract decisions from conversation:
68
68
 
69
69
  ```
70
- 키워드:
71
- - "결정", "선택", "~로 하자", "~가 좋겠다"
72
- - "A 대신 B", "A보다 B"
73
- - "최종적으로", "확정"
74
-
75
- 구조화:
76
- - 결정 제목
77
- - 선택한 옵션
78
- - 선택 이유
79
- - 대안 (있는 경우)
70
+ Keywords:
71
+ - "decided", "selected", "let's go with", "would be good"
72
+ - "A instead of B", "B over A"
73
+ - "finally", "confirmed"
74
+
75
+ Structure:
76
+ - Decision title
77
+ - Selected option
78
+ - Selection reason
79
+ - Alternatives (if any)
80
80
  ```
81
81
 
82
- ### 4. 산출물 자동 탐지
82
+ ### 4. Auto Output Detection
83
83
 
84
84
  ```bash
85
- # outputs 디렉토리 스캔
85
+ # Scan outputs directory
86
86
  find stages/$CURRENT_STAGE/outputs -type f \
87
87
  -name "*.md" -o -name "*.json" -o -name "*.yaml" |
88
88
  while read file; do
@@ -90,71 +90,71 @@ while read file; do
90
90
  done
91
91
  ```
92
92
 
93
- ## 생성 예시
93
+ ## Generation Example
94
94
 
95
- ### 입력 (대화 컨텍스트)
95
+ ### Input (Conversation Context)
96
96
 
97
97
  ```
98
- 사용자: React Vue 중에 React를 선택했어
99
- AI: React 기반으로 컴포넌트 명세를 작성했습니다.
100
- 사용자: Tailwind CSS 추가하자
101
- AI: design-system.md에 Tailwind 설정을 추가했습니다.
98
+ User: Chose React over Vue
99
+ AI: Wrote component specs based on React.
100
+ User: Let's add Tailwind CSS too
101
+ AI: Added Tailwind config to design-system.md.
102
102
  ```
103
103
 
104
- ### 출력 (HANDOFF.md)
104
+ ### Output (HANDOFF.md)
105
105
 
106
106
  ```markdown
107
107
  # Handoff: 04-ui-ux → 05-task-management
108
108
 
109
- 생성일: 2024-01-20 15:30
109
+ Generated: 2024-01-20 15:30
110
110
 
111
- ## 완료된 작업
111
+ ## Completed Work
112
112
 
113
- - [x] 와이어프레임 설계
114
- - [x] 컴포넌트 명세 작성
115
- - [x] 디자인 시스템 정의
113
+ - [x] Wireframe design
114
+ - [x] Component spec creation
115
+ - [x] Design system definition
116
116
 
117
- ## 핵심 결정사항
117
+ ## Key Decisions
118
118
 
119
- ### 결정 1: 프론트엔드 프레임워크
120
- - **선택**: React
121
- - **이유**: 경험, 생태계 성숙도
122
- - **영향**: 컴포넌트 기반 아키텍처 적용
119
+ ### Decision 1: Frontend Framework
120
+ - **Choice**: React
121
+ - **Reason**: Team experience, ecosystem maturity
122
+ - **Impact**: Component-based architecture applied
123
123
 
124
- ### 결정 2: CSS 프레임워크
125
- - **선택**: Tailwind CSS
126
- - **이유**: 빠른 프로토타이핑, 일관된 디자인
127
- - **영향**: utility-first 스타일링
124
+ ### Decision 2: CSS Framework
125
+ - **Choice**: Tailwind CSS
126
+ - **Reason**: Fast prototyping, consistent design
127
+ - **Impact**: Utility-first styling
128
128
 
129
- ## 산출물
129
+ ## Outputs
130
130
 
131
- | 파일 | 설명 |
132
- |------|------|
133
- | wireframes/home.md | 화면 와이어프레임 |
134
- | component-spec.md | React 컴포넌트 명세 |
135
- | design-system.md | Tailwind 기반 디자인 시스템 |
131
+ | File | Description |
132
+ |------|-------------|
133
+ | wireframes/home.md | Home screen wireframe |
134
+ | component-spec.md | React component specs |
135
+ | design-system.md | Tailwind-based design system |
136
136
 
137
- ## 다음 단계
137
+ ## Next Steps
138
138
 
139
- ### 즉시 실행 작업
140
- 1. tasks.json에 컴포넌트별 태스크 생성
141
- 2. 스프린트 계획 수립
139
+ ### Immediate Actions
140
+ 1. Create component-specific tasks in tasks.json
141
+ 2. Establish sprint plan
142
142
 
143
- ### 참고 파일
143
+ ### Reference Files
144
144
  - stages/04-ui-ux/outputs/component-spec.md
145
145
  - stages/04-ui-ux/outputs/design-system.md
146
146
  ```
147
147
 
148
- ## 사용자 확인
148
+ ## User Confirmation
149
149
 
150
- 생성 사용자에게 확인 요청:
150
+ Request user confirmation after generation:
151
151
 
152
152
  ```
153
- HANDOFF.md 생성되었습니다.
153
+ HANDOFF.md has been generated.
154
154
 
155
- [미리보기]
155
+ [Preview]
156
156
  ...
157
157
 
158
- 수정이 필요하면 말씀해 주세요.
159
- 확인되면 /next 다음 스테이지로 전환합니다.
158
+ Let me know if modifications are needed.
159
+ Once confirmed, transition to next stage with /next.
160
160
  ```