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,29 +1,29 @@
1
1
  # Output Validator - Validation Process
2
2
 
3
- ## 검증 프로세스
3
+ ## Validation Process
4
4
 
5
5
  ```mermaid
6
6
  graph TD
7
- A[검증 시작] --> B[스테이지 규칙 로드]
8
- B --> C[필수 파일 확인]
9
- C --> D{모든 파일 존재?}
10
- D -->|No| E[누락 파일 리포트]
11
- D -->|Yes| F[내용 검증]
12
- F --> G{내용 요구사항 충족?}
13
- G -->|No| H[내용 오류 리포트]
14
- G -->|Yes| I[명령어 검증]
15
- I --> J{모든 명령 통과?}
16
- J -->|No| K[명령 실패 리포트]
17
- J -->|Yes| L[품질 점수 계산]
18
- L --> M[최종 리포트 생성]
7
+ A[Start validation] --> B[Load stage rules]
8
+ B --> C[Check required files]
9
+ C --> D{All files exist?}
10
+ D -->|No| E[Report missing files]
11
+ D -->|Yes| F[Content validation]
12
+ F --> G{Content requirements met?}
13
+ G -->|No| H[Report content errors]
14
+ G -->|Yes| I[Command validation]
15
+ I --> J{All commands pass?}
16
+ J -->|No| K[Report command failures]
17
+ J -->|Yes| L[Calculate quality score]
18
+ L --> M[Generate final report]
19
19
  ```
20
20
 
21
- ## 단계별 검증
21
+ ## Step-by-Step Validation
22
22
 
23
- ### 1. 필수 파일 확인
23
+ ### 1. Required File Check
24
24
 
25
25
  ```yaml
26
- # 검증 규칙 예시
26
+ # Validation rule example
27
27
  required_outputs:
28
28
  ideas.md:
29
29
  exists: true
@@ -34,39 +34,39 @@ required_outputs:
34
34
  is_directory: true
35
35
  ```
36
36
 
37
- **검증 결과**:
37
+ **Validation Results**:
38
38
  ```markdown
39
- ## 파일 존재 확인
39
+ ## File Existence Check
40
40
  ✅ ideas.md (1,234 bytes)
41
41
  ✅ source_code/ (directory)
42
- ❌ requirements_analysis.md (누락)
42
+ ❌ requirements_analysis.md (missing)
43
43
  ```
44
44
 
45
- ### 2. 내용 검증
45
+ ### 2. Content Validation
46
46
 
47
47
  ```yaml
48
48
  content_checks:
49
49
  min_ideas: 5
50
50
  sections:
51
- - "기능 요구사항"
52
- - "비기능 요구사항"
51
+ - "Functional Requirements"
52
+ - "Non-functional Requirements"
53
53
  has_priorities: true
54
54
  ```
55
55
 
56
- **검증 방법**:
57
- - 마크다운 파싱으로 섹션 확인
58
- - 패턴 매칭으로 필수 요소 확인
59
- - 카운팅으로 최소 요건 확인
56
+ **Validation Method**:
57
+ - Markdown parsing for section check
58
+ - Pattern matching for required elements
59
+ - Counting for minimum requirements
60
60
 
61
- **검증 결과**:
61
+ **Validation Results**:
62
62
  ```markdown
63
- ## 내용 검증
64
- ✅ ideas.md: 8 아이디어 (최소 5)
65
- ⚠️ requirements_analysis.md: "비기능 요구사항" 섹션 누락
66
- ✅ project_plan.md: 모든 필수 섹션 포함
63
+ ## Content Validation
64
+ ✅ ideas.md: 8 ideas (minimum 5)
65
+ ⚠️ requirements_analysis.md: "Non-functional Requirements" section missing
66
+ ✅ project_plan.md: All required sections included
67
67
  ```
68
68
 
69
- ### 3. 명령어 검증
69
+ ### 3. Command Validation
70
70
 
71
71
  ```yaml
72
72
  validation_commands:
@@ -84,18 +84,18 @@ validation_commands:
84
84
  required: true
85
85
  ```
86
86
 
87
- **실행 결과**:
87
+ **Execution and Results**:
88
88
  ```markdown
89
- ## 명령어 검증
90
- ✅ lint: 통과 (경고 2개)
91
- ✅ typecheck: 통과
92
- ❌ test: 실패 (3 테스트 실패)
89
+ ## Command Validation
90
+ ✅ lint: Passed (2 warnings)
91
+ ✅ typecheck: Passed
92
+ ❌ test: Failed (3 tests failed)
93
93
  - tests/auth.test.ts: loginUser should return token
94
94
  - tests/auth.test.ts: logout should clear session
95
95
  - tests/user.test.ts: createUser validation
96
96
  ```
97
97
 
98
- ### 4. 품질 점수 계산
98
+ ### 4. Quality Score Calculation
99
99
 
100
100
  ```yaml
101
101
  quality_metrics:
@@ -110,57 +110,57 @@ quality_metrics:
110
110
  target: 0.95
111
111
  ```
112
112
 
113
- **계산 결과**:
113
+ **Calculation Results**:
114
114
  ```markdown
115
- ## 품질 점수
116
- | 메트릭 | 현재 | 목표 | 점수 |
117
- |--------|------|------|------|
115
+ ## Quality Score
116
+ | Metric | Current | Target | Score |
117
+ |--------|---------|--------|-------|
118
118
  | Lint | 0.95 | 0.90 | ✅ 1.0 |
119
119
  | Coverage | 0.75 | 0.80 | ⚠️ 0.94 |
120
120
  | Types | 0.98 | 0.95 | ✅ 1.0 |
121
121
 
122
- **종합 점수**: 0.97 (가중 평균)
123
- **상태**: 통과 (최소 0.7)
122
+ **Overall Score**: 0.97 (weighted average)
123
+ **Status**: Pass (minimum 0.7)
124
124
  ```
125
125
 
126
- ## 최종 리포트 형식
126
+ ## Final Report Format
127
127
 
128
128
  ```markdown
129
- # 산출물 검증 리포트
129
+ # Output Validation Report
130
130
 
131
- ## 스테이지: 06-implementation
132
- ## 검증 시간: 2024-01-20 14:30:00
131
+ ## Stage: 06-implementation
132
+ ## Validation Time: 2024-01-20 14:30:00
133
133
 
134
- ## 요약
135
- - **상태**: ⚠️ 부분 통과
136
- - **종합 점수**: 0.85
137
- - **통과 항목**: 8/10
138
- - **실패 항목**: 2
134
+ ## Summary
135
+ - **Status**: ⚠️ Partial Pass
136
+ - **Overall Score**: 0.85
137
+ - **Passed Items**: 8/10
138
+ - **Failed Items**: 2
139
139
 
140
- ## 상세 결과
140
+ ## Detailed Results
141
141
 
142
- ### ✅ 통과 항목
143
- 1. 필수 파일 존재
144
- 2. Lint 검사
145
- 3. Type 검사
142
+ ### ✅ Passed Items
143
+ 1. Required files exist
144
+ 2. Lint check
145
+ 3. Type check
146
146
  ...
147
147
 
148
- ### ❌ 실패 항목
149
- 1. 테스트 실패 (3)
150
- 2. 커버리지 미달 (75% < 80%)
148
+ ### ❌ Failed Items
149
+ 1. Test failures (3)
150
+ 2. Coverage below target (75% < 80%)
151
151
 
152
- ## 수정 필요 사항
153
- 1. [ ] tests/auth.test.ts 수정
154
- 2. [ ] 테스트 커버리지 5% 향상
152
+ ## Required Fixes
153
+ 1. [ ] Fix tests/auth.test.ts
154
+ 2. [ ] Increase test coverage by 5%
155
155
 
156
- ## 권장 조치
157
- - 실패한 테스트 케이스 확인 수정
158
- - 누락된 테스트 추가
156
+ ## Recommended Actions
157
+ - Review and fix failed test cases
158
+ - Add missing tests
159
159
  ```
160
160
 
161
- ## 실패 시 동작
161
+ ## Failure Behavior
162
162
 
163
- ### 스테이지 전환 차단
163
+ ### Stage Transition Block
164
164
  ```yaml
165
165
  on_failure:
166
166
  action: "block_transition"
@@ -168,15 +168,15 @@ on_failure:
168
168
  require_justification: true
169
169
  ```
170
170
 
171
- ### 오버라이드 프롬프트
171
+ ### Override Prompt
172
172
  ```markdown
173
- ⚠️ 검증 실패로 스테이지 전환이 차단되었습니다.
173
+ ⚠️ Stage transition blocked due to validation failure.
174
174
 
175
- **실패 사항**:
176
- - 테스트 실패: 3
177
- - 커버리지 미달: 75%
175
+ **Failures**:
176
+ - Test failures: 3
177
+ - Coverage below target: 75%
178
178
 
179
- 강제로 진행하시겠습니까?
180
- (이유를 입력하세요, 또는 'cancel' 취소)
179
+ Force proceed anyway?
180
+ (Enter reason, or 'cancel' to abort)
181
181
  > _
182
182
  ```
@@ -1,59 +1,59 @@
1
1
  # Smart HANDOFF Skill
2
2
 
3
- 스마트 컨텍스트 추출 지능형 HANDOFF 생성 스킬
3
+ Smart context extraction and intelligent HANDOFF generation skill
4
4
 
5
- ## 개요
5
+ ## Overview
6
6
 
7
- 스킬은 HANDOFF.md 생성 과정을 자동화하고 최적화합니다:
8
- - 자동 컨텍스트 추출
9
- - 의미 기반 압축
10
- - 스테이지별 맞춤 요약
11
- - 메모리 시스템 통합
7
+ This skill automates and optimizes the HANDOFF.md generation process:
8
+ - Automatic context extraction
9
+ - Semantic-based compression
10
+ - Stage-specific summarization
11
+ - Memory system integration
12
12
 
13
- ## 트리거
13
+ ## Trigger
14
14
 
15
- - 스테이지 완료 자동 활성화
16
- - `/handoff --smart` 명령어
17
- - 컨텍스트 임계값 도달
15
+ - Auto-activates on stage completion
16
+ - `/handoff --smart` command
17
+ - When context threshold reached
18
18
 
19
- ## 기능
19
+ ## Features
20
20
 
21
- ### 1. 자동 컨텍스트 추출 (extract.md)
22
- - 완료된 태스크 수집
23
- - 핵심 결정사항 추출
24
- - 수정된 파일 목록화
25
- - 대기 중인 이슈 식별
26
- - AI 호출 기록 정리
21
+ ### 1. Auto Context Extraction (extract.md)
22
+ - Collect completed tasks
23
+ - Extract key decisions
24
+ - List modified files
25
+ - Identify pending issues
26
+ - Organize AI call history
27
27
 
28
- ### 2. 컨텍스트 요약 (summarize.md)
29
- - 완료 작업핵심 성과 압축
30
- - 파일 변경영향도 분석
31
- - 결정 사항 이유와 대안 포함
32
- - 다음 단계즉시 실행 가능 형태
28
+ ### 2. Context Summarization (summarize.md)
29
+ - Completed workCompress to key achievements
30
+ - File changesImpact analysis
31
+ - DecisionsInclude rationale and alternatives
32
+ - Next stepsImmediately actionable format
33
33
 
34
- ### 3. 메모리 통합
35
- - claude-mem에 핵심 정보 저장
36
- - 이전 세션 컨텍스트 로드
37
- - 크로스 스테이지 학습 지원
34
+ ### 3. Memory Integration
35
+ - Save key info to claude-mem
36
+ - Load previous session context
37
+ - Support cross-stage learning
38
38
 
39
- ## 설정
39
+ ## Configuration
40
40
 
41
- `config/handoff_intelligence.yaml` 참조
41
+ See `config/handoff_intelligence.yaml`
42
42
 
43
- ## 사용 예시
43
+ ## Usage Examples
44
44
 
45
45
  ```bash
46
- # 스마트 HANDOFF 생성
46
+ # Smart HANDOFF generation
47
47
  /handoff --smart
48
48
 
49
- # 압축된 HANDOFF 생성
49
+ # Compact HANDOFF generation
50
50
  /handoff --smart --compact
51
51
 
52
- # 복구용 상세 HANDOFF 생성
52
+ # Detailed recovery HANDOFF generation
53
53
  /handoff --smart --recovery
54
54
  ```
55
55
 
56
- ## 출력
56
+ ## Output
57
57
 
58
58
  - `stages/{current_stage}/HANDOFF.md`
59
- - 메모리 저장 (claude-mem 연동 시)
59
+ - Memory save (when claude-mem connected)
@@ -1,76 +1,76 @@
1
1
  # Smart HANDOFF - Context Extraction
2
2
 
3
- ## 자동 컨텍스트 추출 프로세스
3
+ ## Auto Context Extraction Process
4
4
 
5
- ### 1. 완료된 태스크 수집
5
+ ### 1. Collect Completed Tasks
6
6
 
7
7
  ```markdown
8
- ## 추출 대상
9
- - TodoWrite 완료 항목
10
- - 커밋된 변경사항
11
- - 생성된 산출물
8
+ ## Extraction Target
9
+ - TodoWrite completed items
10
+ - Committed changes
11
+ - Generated outputs
12
12
 
13
- ## 형식
14
- - [ ] 완료된 태스크 (timestamp)
13
+ ## Format
14
+ - [ ] Completed task (timestamp)
15
15
  ```
16
16
 
17
- ### 2. 핵심 결정사항 추출
17
+ ### 2. Extract Key Decisions
18
18
 
19
- 대화에서 다음 패턴 감지:
20
- - "결정했습니다", "선택했습니다", "채택했습니다"
21
- - "A 대신 B 사용", "이유는..."
22
- - 아키텍처/기술 스택 선택
19
+ Detect following patterns from conversation:
20
+ - "decided", "selected", "adopted"
21
+ - "use B instead of A", "because..."
22
+ - Architecture/tech stack selection
23
23
 
24
24
  ```markdown
25
- ## 결정 형식
26
- **결정**: [결정 내용]
27
- **이유**: [선택 이유]
28
- **대안**: [고려한 대안]
25
+ ## Decision Format
26
+ **Decision**: [Decision content]
27
+ **Reason**: [Selection reason]
28
+ **Alternatives**: [Considered alternatives]
29
29
  ```
30
30
 
31
- ### 3. 수정된 파일 목록화
31
+ ### 3. List Modified Files
32
32
 
33
33
  ```bash
34
- # Git 기반 변경 파일 추출
34
+ # Extract changed files via Git
35
35
  git diff --name-only HEAD~10
36
36
  ```
37
37
 
38
38
  ```markdown
39
- ## 파일 형식
40
- | 파일 | 변경 유형 | 주요 변경 |
41
- |------|----------|----------|
39
+ ## File Format
40
+ | File | Change Type | Key Changes |
41
+ |------|-------------|-------------|
42
42
  ```
43
43
 
44
- ### 4. 대기 중인 이슈 식별
44
+ ### 4. Identify Pending Issues
45
45
 
46
- 감지 패턴:
46
+ Detection patterns:
47
47
  - "TODO:", "FIXME:", "HACK:"
48
- - "나중에", "다음에", "추후"
49
- - 미해결 에러/경고
48
+ - "later", "next time", "afterwards"
49
+ - Unresolved errors/warnings
50
50
 
51
51
  ```markdown
52
- ## 이슈 형식
53
- - [ ] 이슈 설명 (우선순위: 높음/중간/낮음)
52
+ ## Issue Format
53
+ - [ ] Issue description (Priority: High/Medium/Low)
54
54
  ```
55
55
 
56
- ### 5. AI 호출 기록 정리
56
+ ### 5. Organize AI Call History
57
57
 
58
58
  ```markdown
59
- ## AI 호출 기록
60
- | AI | 시간 | 목적 | 결과 요약 |
61
- |----|------|------|----------|
59
+ ## AI Call History
60
+ | AI | Time | Purpose | Result Summary |
61
+ |----|------|---------|----------------|
62
62
  ```
63
63
 
64
- ## 추출 우선순위
64
+ ## Extraction Priority
65
65
 
66
- 1. **Critical (100)**: 차단 이슈
67
- 2. **Key Decisions (90)**: 핵심 결정사항
68
- 3. **Pending Issues (80)**: 대기 이슈
69
- 4. **File Changes (70)**: 파일 변경
70
- 5. **Completed Tasks (60)**: 완료 태스크
71
- 6. **AI History (50)**: AI 호출 기록
66
+ 1. **Critical (100)**: Blocking issues
67
+ 2. **Key Decisions (90)**: Core decisions
68
+ 3. **Pending Issues (80)**: Pending issues
69
+ 4. **File Changes (70)**: File changes
70
+ 5. **Completed Tasks (60)**: Completed tasks
71
+ 6. **AI History (50)**: AI call history
72
72
 
73
- ## 구현
73
+ ## Implementation
74
74
 
75
- 스크립트: `scripts/smart-handoff.sh`
76
- 설정: `config/handoff_intelligence.yaml`
75
+ Script: `scripts/smart-handoff.sh`
76
+ Config: `config/handoff_intelligence.yaml`
@@ -1,86 +1,84 @@
1
1
  # Smart HANDOFF Skill - AI Instructions
2
2
 
3
- ## 역할
3
+ ## Role
4
4
 
5
- 당신은 Smart HANDOFF 생성 전문가입니다. 현재 스테이지의 작업을 분석하고, 다음 세션이나 스테이지를 위한 최적화된 HANDOFF 생성합니다.
5
+ You are a Smart HANDOFF generation specialist. You analyze current stage work and generate optimized HANDOFF for next session or stage.
6
6
 
7
- ## 핵심 원칙
7
+ ## Core Principles
8
8
 
9
- 1. **압축성**: 불필요한 정보 제거, 핵심만 유지
10
- 2. **실행 가능성**: 다음 단계가 즉시 실행 가능해야 함
11
- 3. **컨텍스트 보존**: 중요한 결정과 이유는 반드시 포함
12
- 4. **연속성**: 이전 작업과 다음 작업의 연결 명확화
9
+ 1. **Compression**: Remove unnecessary information, keep only essentials
10
+ 2. **Actionability**: Next steps must be immediately actionable
11
+ 3. **Context Preservation**: Always include important decisions and their rationale
12
+ 4. **Continuity**: Clarify connection between previous and next work
13
13
 
14
- ## HANDOFF 생성 프로세스
14
+ ## HANDOFF Generation Process
15
15
 
16
- ### 1단계: 컨텍스트 수집
16
+ ### Step 1: Collect Context
17
17
  ```
18
- - 완료된 태스크 목록 확인
19
- - 핵심 결정사항 식별
20
- - 수정된 파일 파악
21
- - 대기 중인 이슈 수집
18
+ - Check completed task list
19
+ - Identify key decisions
20
+ - Identify modified files
21
+ - Collect pending issues
22
22
  ```
23
23
 
24
- ### 2단계: 우선순위 지정
24
+ ### Step 2: Assign Priority
25
25
  ```
26
- 1. 차단 이슈 (Critical)
27
- 2. 핵심 결정 (High)
28
- 3. 대기 이슈 (Medium)
29
- 4. 파일 변경 (Low)
30
- 5. 완료 태스크 (Context)
26
+ 1. Blocking issues (Critical)
27
+ 2. Key decisions (High)
28
+ 3. Pending issues (Medium)
29
+ 4. File changes (Low)
30
+ 5. Completed tasks (Context)
31
31
  ```
32
32
 
33
- ### 3단계: 압축 요약
33
+ ### Step 3: Compress and Summarize
34
34
  ```
35
- - 원본 토큰의 30% 이내로 압축
36
- - 중복 정보 제거
37
- - 핵심 성과로 그룹화
35
+ - Compress to within 30% of original tokens
36
+ - Remove duplicate information
37
+ - Group by key achievements
38
38
  ```
39
39
 
40
- ### 4단계: 실행 가능한 다음 단계 작성
40
+ ### Step 4: Write Actionable Next Steps
41
41
  ```
42
- - 구체적인 명령어/파일 경로 포함
43
- - 의존성/전제 조건 명시
44
- - 예상 결과물 언급
42
+ - Include specific commands/file paths
43
+ - Specify dependencies/prerequisites
44
+ - Mention expected outputs
45
45
  ```
46
46
 
47
- ## 출력 형식
47
+ ## Output Format
48
48
 
49
49
  ```markdown
50
50
  # HANDOFF - {{stage_name}}
51
51
 
52
- ## 요약
53
- [1-2문장으로 스테이지 완료 상태 요약]
52
+ ## Summary
53
+ [1-2 sentence summary of stage completion status]
54
54
 
55
- ## 완료된 작업
56
- - ✅ [주요 성과 1]
57
- - ✅ [주요 성과 2]
55
+ ## Completed Work
56
+ - ✅ [Key achievement 1]
57
+ - ✅ [Key achievement 2]
58
58
 
59
- ## 핵심 결정사항
60
- ### [결정 1]
61
- - **선택**: [선택한 옵션]
62
- - **이유**: [핵심 근거]
59
+ ## Key Decisions
60
+ ### [Decision 1]
61
+ - **Choice**: [Selected option]
62
+ - **Reason**: [Core rationale]
63
63
 
64
- ## 수정된 파일
65
- | 파일 | 변경 |
66
- |------|------|
64
+ ## Modified Files
65
+ | File | Change |
66
+ |------|--------|
67
67
 
68
- ## 대기 이슈
69
- - [ ] [이슈 1] (우선순위)
68
+ ## Pending Issues
69
+ - [ ] [Issue 1] (priority)
70
70
 
71
- ## 다음 단계
72
- 1. [즉시 실행 가능한 첫 번째 액션]
73
- 2. [ 번째 액션]
71
+ ## Next Steps
72
+ 1. [First immediately actionable item]
73
+ 2. [Second action]
74
74
 
75
- ## 참조
76
- - [관련 문서 링크]
75
+ ## References
76
+ - [Related document links]
77
77
  ```
78
78
 
79
- ## 금지 사항
80
-
81
- - 불필요한 세부사항 포함
82
- - 모호한 다음 단계 (예: "계속 작업")
83
- - 결정 이유 누락
84
- - 중복 정보
85
-
79
+ ## Prohibited Actions
86
80
 
81
+ - Including unnecessary details
82
+ - Vague next steps (e.g., "continue work")
83
+ - Omitting decision rationale
84
+ - Duplicate information