claude-symphony 0.0.5 → 0.0.7

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 (37) hide show
  1. package/bin/create.js +139 -18
  2. package/package.json +3 -2
  3. package/template/.claude/settings.json +0 -2
  4. package/template/.claude/skills/context-compression/README.md +39 -0
  5. package/template/CLAUDE.md +64 -1
  6. package/template/config/ai_fallbacks.yaml +130 -0
  7. package/template/config/git.yaml +24 -0
  8. package/template/config/implementation.yaml.template +72 -72
  9. package/template/config/pipeline.yaml +50 -0
  10. package/template/config/ui-ux.yaml +31 -0
  11. package/template/scripts/config-manager.sh +350 -0
  12. package/template/scripts/context-manager.sh +55 -4
  13. package/template/scripts/goto-stage.sh +264 -0
  14. package/template/scripts/next-stage.sh +132 -0
  15. package/template/stages/01-brainstorm/HANDOFF.md.template +42 -42
  16. package/template/stages/02-research/HANDOFF.md.template +42 -42
  17. package/template/stages/03-planning/HANDOFF.md.template +39 -39
  18. package/template/stages/04-ui-ux/CLAUDE.md +40 -0
  19. package/template/stages/04-ui-ux/HANDOFF.md.template +38 -38
  20. package/template/stages/04-ui-ux/inputs/moodboard/brand-assets/.gitkeep +3 -0
  21. package/template/stages/04-ui-ux/inputs/moodboard/sketches/.gitkeep +3 -0
  22. package/template/stages/04-ui-ux/inputs/moodboard/ui-references/.gitkeep +3 -0
  23. package/template/stages/05-task-management/HANDOFF.md.template +38 -38
  24. package/template/stages/06-implementation/CLAUDE.md +83 -0
  25. package/template/stages/06-implementation/HANDOFF.md.template +76 -76
  26. package/template/stages/06-implementation/config.yaml +16 -0
  27. package/template/stages/07-refactoring/CLAUDE.md +42 -0
  28. package/template/stages/07-refactoring/HANDOFF.md.template +42 -42
  29. package/template/stages/08-qa/CLAUDE.md +44 -0
  30. package/template/stages/08-qa/HANDOFF.md.template +45 -45
  31. package/template/stages/09-testing/CLAUDE.md +44 -0
  32. package/template/stages/09-testing/HANDOFF.md.template +46 -46
  33. package/template/stages/10-deployment/CLAUDE.md +44 -0
  34. package/template/stages/10-deployment/HANDOFF.md.template +60 -60
  35. package/template/state/progress.json.template +26 -0
  36. package/template/state/templates/handoff_base.md.template +57 -57
  37. package/template/state/templates/phase_state.md.template +35 -35
@@ -108,6 +108,50 @@ npx playwright install
108
108
  - **Functions**: 80%
109
109
  - **Lines**: 80%
110
110
 
111
+ ---
112
+
113
+ ## ⚠️ Mandatory Git Commit Rule
114
+
115
+ > **CRITICAL**: Git commit is REQUIRED after every task completion in this stage.
116
+
117
+ ### Per-Task Commit Protocol
118
+ After completing each task:
119
+
120
+ 1. **Stage changes**
121
+ ```bash
122
+ git add <relevant-files>
123
+ ```
124
+
125
+ 2. **Commit with conventional format**
126
+ ```bash
127
+ git commit -m "test(test): <task description>"
128
+ ```
129
+
130
+ 3. **Verify clean state**
131
+ ```bash
132
+ git status # Should show "nothing to commit"
133
+ ```
134
+
135
+ ### Commit Message Format
136
+ | Task Type | Format | Example |
137
+ |-----------|--------|---------|
138
+ | Unit test | `test(test): ...` | `test(test): add user service unit tests` |
139
+ | Integration test | `test(test): ...` | `test(test): add API integration tests` |
140
+ | E2E test | `test(test): ...` | `test(test): add auth E2E tests` |
141
+ | Test fix | `test(test): ...` | `test(test): fix flaky async test` |
142
+
143
+ ### ❌ Prohibited
144
+ - Proceeding to next task without committing
145
+ - Batching multiple tasks into single commit
146
+ - WIP or meaningless commit messages
147
+
148
+ ### ✅ Required
149
+ - One commit per task (minimum)
150
+ - Meaningful, descriptive commit messages
151
+ - Clean working directory before next task
152
+
153
+ ---
154
+
111
155
  ## Completion Criteria
112
156
  - [ ] Unit tests written (coverage 80%+)
113
157
  - [ ] Integration tests written
@@ -1,74 +1,74 @@
1
1
  # Stage Handoff: 09-testing → 10-deployment
2
2
 
3
- **생성일**: {{TIMESTAMP}}
4
- **생성자**: Codex
5
- **소요 시간**: {{DURATION}}
3
+ **Created**: {{TIMESTAMP}}
4
+ **Creator**: Codex
5
+ **Duration**: {{DURATION}}
6
6
 
7
7
  ---
8
8
 
9
- ## 완료된 작업
9
+ ## Completed Tasks
10
10
 
11
- - [ ] 단위 테스트 작성 ({{UNIT_COUNT}})
12
- - [ ] 통합 테스트 작성 ({{INT_COUNT}})
13
- - [ ] E2E 테스트 작성 ({{E2E_COUNT}})
14
- - [ ] 모든 테스트 통과
15
- - [ ] 커버리지 보고서 생성
16
- - [ ] HANDOFF.md 생성
11
+ - [ ] Unit test writing ({{UNIT_COUNT}} tests)
12
+ - [ ] Integration test writing ({{INT_COUNT}} tests)
13
+ - [ ] E2E test writing ({{E2E_COUNT}} tests)
14
+ - [ ] All tests passing
15
+ - [ ] Coverage report generation
16
+ - [ ] HANDOFF.md generation
17
17
 
18
18
  ---
19
19
 
20
- ## 다음 에이전트를 위한 컨텍스트
20
+ ## Context for Next Agent
21
21
 
22
- ### 테스트 결과 요약
22
+ ### Test Results Summary
23
23
 
24
- | 유형 | 개수 | 통과 | 실패 | 스킵 |
25
- |------|--------|------|------|------|
24
+ | Type | Total | Passed | Failed | Skipped |
25
+ |------|-------|--------|--------|---------|
26
26
  | Unit | {{UNIT_COUNT}} | {{UNIT_PASS}} | {{UNIT_FAIL}} | {{UNIT_SKIP}} |
27
27
  | Integration | {{INT_COUNT}} | {{INT_PASS}} | {{INT_FAIL}} | {{INT_SKIP}} |
28
28
  | E2E | {{E2E_COUNT}} | {{E2E_PASS}} | {{E2E_FAIL}} | {{E2E_SKIP}} |
29
29
 
30
- ### 커버리지 보고서
30
+ ### Coverage Report
31
31
 
32
- | 메트릭 | 결과 | 목표 | 상태 |
33
- |--------|------|------|------|
32
+ | Metric | Result | Target | Status |
33
+ |--------|--------|--------|--------|
34
34
  | Statements | {{STMT_COV}}% | 80% | {{STMT_STATUS}} |
35
35
  | Branches | {{BRANCH_COV}}% | 75% | {{BRANCH_STATUS}} |
36
36
  | Functions | {{FUNC_COV}}% | 80% | {{FUNC_STATUS}} |
37
37
  | Lines | {{LINE_COV}}% | 80% | {{LINE_STATUS}} |
38
38
 
39
- ### E2E 테스트 시나리오
39
+ ### E2E Test Scenarios
40
40
 
41
- | 시나리오 | 상태 | 실행 시간 |
42
- |----------|------|-----------|
41
+ | Scenario | Status | Execution Time |
42
+ |----------|--------|----------------|
43
43
  | {{E2E_1}} | Pass | {{TIME_1}} |
44
44
  | {{E2E_2}} | Pass | {{TIME_2}} |
45
45
  | {{E2E_3}} | Pass | {{TIME_3}} |
46
46
 
47
- ### CI 통합 준비 사항
48
- - 테스트 명령어: `npm test`
49
- - 커버리지 명령어: `npm run coverage`
50
- - E2E 명령어: `npm run test:e2e`
47
+ ### CI Integration Requirements
48
+ - Test command: `npm test`
49
+ - Coverage command: `npm run coverage`
50
+ - E2E command: `npm run test:e2e`
51
51
 
52
52
  ---
53
53
 
54
- ## 생성된 산출물
54
+ ## Generated Outputs
55
55
 
56
- | 파일 | 설명 |
57
- |------|------|
58
- | tests/ | 테스트 코드 |
59
- | test_report.md | 테스트 결과 |
60
- | coverage_report.md | 커버리지 보고서 |
56
+ | File | Description |
57
+ |------|-------------|
58
+ | tests/ | Test code |
59
+ | test_report.md | Test results |
60
+ | coverage_report.md | Coverage report |
61
61
 
62
62
  ---
63
63
 
64
- ## 10-deployment 스테이지 가이드
64
+ ## 10-deployment Stage Guide
65
65
 
66
- ### 즉시 실행할 작업
67
- 1. GitHub Actions 워크플로우 설정
68
- 2. 배포 환경 설정
69
- 3. 환경 변수 구성
66
+ ### Immediate Tasks
67
+ 1. GitHub Actions workflow setup
68
+ 2. Deployment environment configuration
69
+ 3. Environment variable configuration
70
70
 
71
- ### CI/CD 파이프라인 제안
71
+ ### Proposed CI/CD Pipeline
72
72
  ```yaml
73
73
  workflow:
74
74
  - lint
@@ -80,26 +80,26 @@ workflow:
80
80
  - deploy
81
81
  ```
82
82
 
83
- ### 배포 전 체크리스트
84
- - [ ] 환경 변수 설정
85
- - [ ] 도메인 설정
86
- - [ ] SSL 인증서
87
- - [ ] 데이터베이스 마이그레이션
83
+ ### Pre-Deployment Checklist
84
+ - [ ] Environment variables configured
85
+ - [ ] Domain configured
86
+ - [ ] SSL certificate
87
+ - [ ] Database migration
88
88
 
89
89
  ---
90
90
 
91
- ## AI 호출 기록
91
+ ## AI Call Log
92
92
 
93
- | AI | 호출 시간 | 프롬프트 | 결과 | 상태 |
94
- |----|----------|---------|------|------|
93
+ | AI | Call Time | Prompt | Result | Status |
94
+ |----|-----------|--------|--------|--------|
95
95
  | {{AI_1}} | {{TIME_1}} | {{PROMPT_1}} | {{OUTPUT_1}} | {{STATUS_1}} |
96
96
  | {{AI_2}} | {{TIME_2}} | {{PROMPT_2}} | {{OUTPUT_2}} | {{STATUS_2}} |
97
97
 
98
- > 설정: `config/ai_logging.yaml`
98
+ > Configuration: `config/ai_logging.yaml`
99
99
 
100
100
  ---
101
101
 
102
- ## 메타데이터
102
+ ## Metadata
103
103
 
104
104
  ```yaml
105
105
  stage: "09-testing"
@@ -97,6 +97,50 @@ jobs:
97
97
  - **AWS**: Enterprise
98
98
  - **Cloudflare**: Edge
99
99
 
100
+ ---
101
+
102
+ ## ⚠️ Mandatory Git Commit Rule
103
+
104
+ > **CRITICAL**: Git commit is REQUIRED after every task completion in this stage.
105
+
106
+ ### Per-Task Commit Protocol
107
+ After completing each task:
108
+
109
+ 1. **Stage changes**
110
+ ```bash
111
+ git add <relevant-files>
112
+ ```
113
+
114
+ 2. **Commit with conventional format**
115
+ ```bash
116
+ git commit -m "ci(deploy): <task description>"
117
+ ```
118
+
119
+ 3. **Verify clean state**
120
+ ```bash
121
+ git status # Should show "nothing to commit"
122
+ ```
123
+
124
+ ### Commit Message Format
125
+ | Task Type | Format | Example |
126
+ |-----------|--------|---------|
127
+ | CI pipeline | `ci(deploy): ...` | `ci(deploy): configure GitHub Actions CI` |
128
+ | CD pipeline | `ci(deploy): ...` | `ci(deploy): add Vercel deployment workflow` |
129
+ | Config | `chore(deploy): ...` | `chore(deploy): add environment variables` |
130
+ | Monitoring | `ci(deploy): ...` | `ci(deploy): configure Sentry error tracking` |
131
+
132
+ ### ❌ Prohibited
133
+ - Proceeding to next task without committing
134
+ - Batching multiple tasks into single commit
135
+ - WIP or meaningless commit messages
136
+
137
+ ### ✅ Required
138
+ - One commit per task (minimum)
139
+ - Meaningful, descriptive commit messages
140
+ - Clean working directory before next task
141
+
142
+ ---
143
+
100
144
  ## Completion Criteria
101
145
  - [ ] CI pipeline configured
102
146
  - [ ] CD pipeline configured
@@ -1,55 +1,55 @@
1
1
  # Stage Handoff: 10-deployment → PROJECT COMPLETE
2
2
 
3
- **생성일**: {{TIMESTAMP}}
4
- **생성자**: ClaudeCode
5
- **소요 시간**: {{DURATION}}
3
+ **Created**: {{TIMESTAMP}}
4
+ **Creator**: ClaudeCode
5
+ **Duration**: {{DURATION}}
6
6
 
7
7
  ---
8
8
 
9
- ## 완료된 작업
9
+ ## Completed Tasks
10
10
 
11
- - [ ] CI 파이프라인 설정
12
- - [ ] CD 파이프라인 설정
13
- - [ ] 스테이징 배포 성공
14
- - [ ] 프로덕션 배포 성공
15
- - [ ] 모니터링 설정
16
- - [ ] 배포 문서 작성
17
- - [ ] HANDOFF.md 생성 (최종)
11
+ - [ ] CI pipeline setup
12
+ - [ ] CD pipeline setup
13
+ - [ ] Staging deployment successful
14
+ - [ ] Production deployment successful
15
+ - [ ] Monitoring setup
16
+ - [ ] Deployment documentation writing
17
+ - [ ] HANDOFF.md generation (final)
18
18
 
19
19
  ---
20
20
 
21
- ## 프로젝트 완료 요약
21
+ ## Project Completion Summary
22
22
 
23
- ### 배포 정보
23
+ ### Deployment Information
24
24
 
25
- | 환경 | URL | 상태 |
26
- |------|-----|------|
25
+ | Environment | URL | Status |
26
+ |-------------|-----|--------|
27
27
  | Production | {{PROD_URL}} | {{PROD_STATUS}} |
28
28
  | Staging | {{STAGE_URL}} | {{STAGE_STATUS}} |
29
29
 
30
- ### CI/CD 파이프라인
30
+ ### CI/CD Pipeline
31
31
 
32
- | 파이프라인 | 상태 | 마지막 실행 |
33
- |------------|------|-------------|
32
+ | Pipeline | Status | Last Run |
33
+ |----------|--------|----------|
34
34
  | CI | {{CI_STATUS}} | {{CI_LAST}} |
35
35
  | CD (Staging) | {{CD_STAGE_STATUS}} | {{CD_STAGE_LAST}} |
36
36
  | CD (Production) | {{CD_PROD_STATUS}} | {{CD_PROD_LAST}} |
37
37
 
38
- ### 모니터링
38
+ ### Monitoring
39
39
 
40
- | 서비스 | 용도 | 대시보드 |
41
- |--------|------|----------|
42
- | {{MONITOR_1}} | 에러 트래킹 | {{DASH_1}} |
43
- | {{MONITOR_2}} | 성능 모니터링 | {{DASH_2}} |
40
+ | Service | Purpose | Dashboard |
41
+ |---------|---------|-----------|
42
+ | {{MONITOR_1}} | Error tracking | {{DASH_1}} |
43
+ | {{MONITOR_2}} | Performance monitoring | {{DASH_2}} |
44
44
 
45
45
  ---
46
46
 
47
- ## 전체 파이프라인 회고
47
+ ## Full Pipeline Retrospective
48
48
 
49
- ### 스테이지별 소요 시간
49
+ ### Duration by Stage
50
50
 
51
- | 스테이지 | 소요 시간 | 모델 |
52
- |----------|-----------|------|
51
+ | Stage | Duration | Model |
52
+ |-------|----------|-------|
53
53
  | 01-brainstorm | {{TIME_01}} | Gemini + ClaudeCode |
54
54
  | 02-research | {{TIME_02}} | Claude |
55
55
  | 03-planning | {{TIME_03}} | Gemini |
@@ -60,81 +60,81 @@
60
60
  | 08-qa | {{TIME_08}} | ClaudeCode |
61
61
  | 09-testing | {{TIME_09}} | Codex |
62
62
  | 10-deployment | {{TIME_10}} | ClaudeCode |
63
- | **총계** | **{{TOTAL_TIME}}** | |
63
+ | **Total** | **{{TOTAL_TIME}}** | |
64
64
 
65
- ### 주요 성과
65
+ ### Key Achievements
66
66
  1. {{ACHIEVEMENT_1}}
67
67
  2. {{ACHIEVEMENT_2}}
68
68
  3. {{ACHIEVEMENT_3}}
69
69
 
70
- ### 학습 내용
70
+ ### Lessons Learned
71
71
  1. {{LEARNING_1}}
72
72
  2. {{LEARNING_2}}
73
73
 
74
- ### 향후 개선점
74
+ ### Future Improvements
75
75
  1. {{IMPROVEMENT_1}}
76
76
  2. {{IMPROVEMENT_2}}
77
77
 
78
78
  ---
79
79
 
80
- ## 운영 가이드
80
+ ## Operations Guide
81
81
 
82
- ### 배포 명령어
82
+ ### Deployment Commands
83
83
  ```bash
84
- # 스테이징 배포
84
+ # Staging deployment
85
85
  npm run deploy:staging
86
86
 
87
- # 프로덕션 배포
87
+ # Production deployment
88
88
  npm run deploy:production
89
89
 
90
- # 롤백
90
+ # Rollback
91
91
  npm run rollback
92
92
  ```
93
93
 
94
- ### 환경 변수
95
- - `DATABASE_URL`: 데이터베이스 연결 문자열
96
- - `API_KEY`: 외부 API
97
- - (`.env.example` 참조)
94
+ ### Environment Variables
95
+ - `DATABASE_URL`: Database connection string
96
+ - `API_KEY`: External API key
97
+ - (See `.env.example` for reference)
98
98
 
99
- ### 트러블슈팅
100
- - 배포 실패 시: {{TROUBLESHOOT_1}}
101
- - 성능 이슈 시: {{TROUBLESHOOT_2}}
99
+ ### Troubleshooting
100
+ - Deployment failure: {{TROUBLESHOOT_1}}
101
+ - Performance issues: {{TROUBLESHOOT_2}}
102
102
 
103
103
  ---
104
104
 
105
- ## 생성된 산출물
105
+ ## Generated Outputs
106
106
 
107
- | 파일 | 설명 |
108
- |------|------|
109
- | .github/workflows/ | CI/CD 워크플로우 |
110
- | deployment_config/ | 배포 설정 |
111
- | deployment_log.md | 배포 로그 |
107
+ | File | Description |
108
+ |------|-------------|
109
+ | .github/workflows/ | CI/CD workflows |
110
+ | deployment_config/ | Deployment configuration |
111
+ | deployment_log.md | Deployment log |
112
112
 
113
113
  ---
114
114
 
115
- ## 프로젝트 종료
115
+ ## Project Completion
116
116
 
117
- 프로젝트는 성공적으로 완료되었습니다.
117
+ This project has been successfully completed.
118
118
 
119
- ### 다음 단계 제안
120
- 1. 사용자 피드백 수집
121
- 2. 성능 모니터링 검토
122
- 3. 다음 이터레이션 계획
119
+ ### Suggested Next Steps
120
+ 1. Collect user feedback
121
+ 2. Review performance monitoring
122
+ 3. Plan next iteration
123
123
 
124
124
  ---
125
125
 
126
- ## AI 호출 기록
126
+ ## AI Call Log
127
127
 
128
- | AI | 호출 시간 | 프롬프트 | 결과 | 상태 |
129
- |----|----------|---------|------|------|
128
+ | AI | Call Time | Prompt | Result | Status |
129
+ |----|-----------|--------|--------|--------|
130
130
  | {{AI_1}} | {{TIME_1}} | {{PROMPT_1}} | {{OUTPUT_1}} | {{STATUS_1}} |
131
131
  | {{AI_2}} | {{TIME_2}} | {{PROMPT_2}} | {{OUTPUT_2}} | {{STATUS_2}} |
132
132
 
133
- > 설정: `config/ai_logging.yaml`
133
+ > Configuration: `config/ai_logging.yaml`
134
134
 
135
135
  ---
136
136
 
137
- ## 메타데이터
137
+ ## Metadata
138
138
 
139
139
  ```yaml
140
140
  stage: "10-deployment"
@@ -8,6 +8,32 @@
8
8
  "completed_at": null
9
9
  },
10
10
  "current_stage": null,
11
+ "current_iteration": {
12
+ "type": "sprint",
13
+ "current_sprint": 1,
14
+ "total_sprints": 3
15
+ },
16
+ "sprints": {
17
+ "Sprint 1": {
18
+ "status": "pending",
19
+ "tasks_total": 0,
20
+ "tasks_completed": 0,
21
+ "checkpoint_id": null
22
+ },
23
+ "Sprint 2": {
24
+ "status": "pending",
25
+ "tasks_total": 0,
26
+ "tasks_completed": 0,
27
+ "checkpoint_id": null
28
+ },
29
+ "Sprint 3": {
30
+ "status": "pending",
31
+ "tasks_total": 0,
32
+ "tasks_completed": 0,
33
+ "checkpoint_id": null
34
+ }
35
+ },
36
+ "loop_back_history": [],
11
37
  "stages": {
12
38
  "01-brainstorm": {
13
39
  "status": "pending",