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.
- package/bin/create.js +139 -18
- package/package.json +3 -2
- package/template/.claude/settings.json +0 -2
- package/template/.claude/skills/context-compression/README.md +39 -0
- package/template/CLAUDE.md +64 -1
- package/template/config/ai_fallbacks.yaml +130 -0
- package/template/config/git.yaml +24 -0
- package/template/config/implementation.yaml.template +72 -72
- package/template/config/pipeline.yaml +50 -0
- package/template/config/ui-ux.yaml +31 -0
- package/template/scripts/config-manager.sh +350 -0
- package/template/scripts/context-manager.sh +55 -4
- package/template/scripts/goto-stage.sh +264 -0
- package/template/scripts/next-stage.sh +132 -0
- package/template/stages/01-brainstorm/HANDOFF.md.template +42 -42
- package/template/stages/02-research/HANDOFF.md.template +42 -42
- package/template/stages/03-planning/HANDOFF.md.template +39 -39
- package/template/stages/04-ui-ux/CLAUDE.md +40 -0
- package/template/stages/04-ui-ux/HANDOFF.md.template +38 -38
- package/template/stages/04-ui-ux/inputs/moodboard/brand-assets/.gitkeep +3 -0
- package/template/stages/04-ui-ux/inputs/moodboard/sketches/.gitkeep +3 -0
- package/template/stages/04-ui-ux/inputs/moodboard/ui-references/.gitkeep +3 -0
- package/template/stages/05-task-management/HANDOFF.md.template +38 -38
- package/template/stages/06-implementation/CLAUDE.md +83 -0
- package/template/stages/06-implementation/HANDOFF.md.template +76 -76
- package/template/stages/06-implementation/config.yaml +16 -0
- package/template/stages/07-refactoring/CLAUDE.md +42 -0
- package/template/stages/07-refactoring/HANDOFF.md.template +42 -42
- package/template/stages/08-qa/CLAUDE.md +44 -0
- package/template/stages/08-qa/HANDOFF.md.template +45 -45
- package/template/stages/09-testing/CLAUDE.md +44 -0
- package/template/stages/09-testing/HANDOFF.md.template +46 -46
- package/template/stages/10-deployment/CLAUDE.md +44 -0
- package/template/stages/10-deployment/HANDOFF.md.template +60 -60
- package/template/state/progress.json.template +26 -0
- package/template/state/templates/handoff_base.md.template +57 -57
- package/template/state/templates/phase_state.md.template +35 -35
|
@@ -1,51 +1,51 @@
|
|
|
1
1
|
# Stage Handoff: {{CURRENT_STAGE}} → {{NEXT_STAGE}}
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
3
|
+
**Created**: {{TIMESTAMP}}
|
|
4
|
+
**Creator**: {{PRIMARY_AI}}
|
|
5
|
+
**Duration**: {{DURATION}}
|
|
6
6
|
|
|
7
7
|
---
|
|
8
8
|
|
|
9
|
-
## AI
|
|
9
|
+
## AI Usage Log
|
|
10
10
|
|
|
11
|
-
>
|
|
11
|
+
> This section compares intended AI settings with actual usage to track collaboration efficiency.
|
|
12
12
|
|
|
13
|
-
###
|
|
13
|
+
### Intended vs Actual Comparison
|
|
14
14
|
|
|
15
|
-
|
|
|
16
|
-
|
|
15
|
+
| Item | Intended | Actual | Match |
|
|
16
|
+
|------|----------|--------|-------|
|
|
17
17
|
| Primary AI | {{INTENDED_PRIMARY_AI}} | {{ACTUAL_PRIMARY_AI}} | {{PRIMARY_MATCH}} |
|
|
18
18
|
| Secondary AI | {{INTENDED_SECONDARY_AI}} | {{ACTUAL_SECONDARY_AI}} | {{SECONDARY_MATCH}} |
|
|
19
|
-
|
|
|
20
|
-
|
|
|
19
|
+
| Collaboration Mode | {{INTENDED_COLLABORATION_MODE}} | {{ACTUAL_COLLABORATION_MODE}} | {{MODE_MATCH}} |
|
|
20
|
+
| External AI Call | {{INTENDED_EXTERNAL_CALL}} | {{ACTUAL_EXTERNAL_CALL}} | {{EXTERNAL_MATCH}} |
|
|
21
21
|
|
|
22
|
-
###
|
|
22
|
+
### Collaboration Mode Details
|
|
23
23
|
|
|
24
|
-
-
|
|
25
|
-
-
|
|
26
|
-
-
|
|
24
|
+
- **Configured Mode**: {{COLLABORATION_MODE}} (parallel/debate/sequential/none)
|
|
25
|
+
- **Actual Execution**: {{MODE_EXECUTED}} (Yes/No)
|
|
26
|
+
- **Reason for Non-Execution**: {{NON_EXECUTION_REASON}}
|
|
27
27
|
|
|
28
|
-
### AI
|
|
28
|
+
### AI Call Log
|
|
29
29
|
|
|
30
|
-
| AI |
|
|
31
|
-
|
|
30
|
+
| AI | Call Time | Role | Prompt | Result | Status |
|
|
31
|
+
|----|-----------|------|--------|--------|--------|
|
|
32
32
|
{{#each AI_CALLS}}
|
|
33
33
|
| {{this.model}} | {{this.timestamp}} | {{this.role}} | {{this.prompt_file}} | {{this.output_file}} | {{this.status}} |
|
|
34
34
|
{{/each}}
|
|
35
35
|
|
|
36
|
-
###
|
|
36
|
+
### Fallback Log
|
|
37
37
|
|
|
38
|
-
|
|
|
39
|
-
|
|
38
|
+
| Attempted AI | Failure Time | Error | Fallback AI | Result |
|
|
39
|
+
|--------------|--------------|-------|-------------|--------|
|
|
40
40
|
{{#each FALLBACK_EVENTS}}
|
|
41
41
|
| {{this.attempted_model}} | {{this.failure_time}} | {{this.error}} | {{this.fallback_model}} | {{this.result}} |
|
|
42
42
|
{{/each}}
|
|
43
43
|
|
|
44
|
-
>
|
|
44
|
+
> Configuration: `config/ai_collaboration.yaml`, `config/mcp_fallbacks.yaml`
|
|
45
45
|
|
|
46
46
|
---
|
|
47
47
|
|
|
48
|
-
##
|
|
48
|
+
## Completed Tasks
|
|
49
49
|
|
|
50
50
|
{{#each COMPLETED_TASKS}}
|
|
51
51
|
- [x] {{this.name}} {{#if this.ai}}({{this.ai}}){{/if}}
|
|
@@ -53,103 +53,103 @@
|
|
|
53
53
|
|
|
54
54
|
---
|
|
55
55
|
|
|
56
|
-
##
|
|
56
|
+
## Context for Next Agent
|
|
57
57
|
|
|
58
|
-
###
|
|
58
|
+
### Key Decisions
|
|
59
59
|
|
|
60
60
|
{{#each KEY_DECISIONS}}
|
|
61
61
|
- **{{this.topic}}**: {{this.decision}}
|
|
62
|
-
-
|
|
63
|
-
-
|
|
62
|
+
- Rationale: {{this.rationale}}
|
|
63
|
+
- Alternatives: {{this.alternatives}}
|
|
64
64
|
{{/each}}
|
|
65
65
|
|
|
66
|
-
###
|
|
66
|
+
### Modified Files
|
|
67
67
|
|
|
68
|
-
|
|
|
69
|
-
|
|
68
|
+
| File | Change Type | Lines Changed | Responsible AI |
|
|
69
|
+
|------|-------------|---------------|----------------|
|
|
70
70
|
{{#each MODIFIED_FILES}}
|
|
71
71
|
| `{{this.path}}` | {{this.change_type}} | {{this.lines_changed}} | {{this.ai_model}} |
|
|
72
72
|
{{/each}}
|
|
73
73
|
|
|
74
|
-
###
|
|
74
|
+
### Known Issues / Technical Debt
|
|
75
75
|
|
|
76
76
|
{{#each KNOWN_ISSUES}}
|
|
77
77
|
- **{{this.id}}**: {{this.description}}
|
|
78
|
-
-
|
|
79
|
-
-
|
|
78
|
+
- Severity: {{this.severity}}
|
|
79
|
+
- Status: {{this.status}}
|
|
80
80
|
{{/each}}
|
|
81
81
|
|
|
82
82
|
---
|
|
83
83
|
|
|
84
|
-
##
|
|
84
|
+
## Test Status (Test-First Flow)
|
|
85
85
|
|
|
86
|
-
> ⚠️
|
|
86
|
+
> ⚠️ Verify that tests were run in this stage.
|
|
87
87
|
|
|
88
|
-
###
|
|
88
|
+
### Tests Run
|
|
89
89
|
|
|
90
|
-
|
|
|
91
|
-
|
|
90
|
+
| Test Type | Run Time | Result | Coverage |
|
|
91
|
+
|-----------|----------|--------|----------|
|
|
92
92
|
{{#each TESTS_RUN}}
|
|
93
93
|
| {{this.type}} | {{this.timestamp}} | {{this.result}} | {{this.coverage}} |
|
|
94
94
|
{{/each}}
|
|
95
95
|
|
|
96
|
-
###
|
|
96
|
+
### Smoke Test Results
|
|
97
97
|
|
|
98
|
-
- **`npm run dev`
|
|
99
|
-
-
|
|
100
|
-
- **Playwright
|
|
98
|
+
- **`npm run dev` execution**: {{DEV_SERVER_STATUS}}
|
|
99
|
+
- **Basic functionality check**: {{BASIC_FUNCTIONALITY}}
|
|
100
|
+
- **Playwright smoke test**: {{PLAYWRIGHT_SMOKE}}
|
|
101
101
|
|
|
102
|
-
###
|
|
102
|
+
### Bugs Found
|
|
103
103
|
|
|
104
104
|
{{#each BUGS_FOUND}}
|
|
105
105
|
- **{{this.id}}**: {{this.description}}
|
|
106
|
-
-
|
|
107
|
-
-
|
|
108
|
-
-
|
|
106
|
+
- Found at: {{this.found_at}}
|
|
107
|
+
- Status: {{this.status}}
|
|
108
|
+
- Fix file: {{this.fix_file}}
|
|
109
109
|
{{/each}}
|
|
110
110
|
|
|
111
111
|
---
|
|
112
112
|
|
|
113
|
-
##
|
|
113
|
+
## Checkpoint Information
|
|
114
114
|
|
|
115
|
-
| ID |
|
|
116
|
-
|
|
115
|
+
| ID | Created | Description | Auto/Manual |
|
|
116
|
+
|----|---------|-------------|-------------|
|
|
117
117
|
{{#each CHECKPOINTS}}
|
|
118
118
|
| {{this.id}} | {{this.date}} | {{this.description}} | {{this.type}} |
|
|
119
119
|
{{/each}}
|
|
120
120
|
|
|
121
|
-
|
|
121
|
+
Recovery command:
|
|
122
122
|
```bash
|
|
123
123
|
scripts/restore-checkpoint.sh {{LATEST_CP_ID}}
|
|
124
124
|
```
|
|
125
125
|
|
|
126
126
|
---
|
|
127
127
|
|
|
128
|
-
##
|
|
128
|
+
## Generated Outputs
|
|
129
129
|
|
|
130
|
-
|
|
|
131
|
-
|
|
130
|
+
| File | Description | Validation Status |
|
|
131
|
+
|------|-------------|-------------------|
|
|
132
132
|
{{#each OUTPUTS}}
|
|
133
133
|
| {{this.path}} | {{this.description}} | {{this.validation_status}} |
|
|
134
134
|
{{/each}}
|
|
135
135
|
|
|
136
136
|
---
|
|
137
137
|
|
|
138
|
-
## {{NEXT_STAGE}}
|
|
138
|
+
## {{NEXT_STAGE}} Stage Guide
|
|
139
139
|
|
|
140
|
-
###
|
|
140
|
+
### Immediate Tasks
|
|
141
141
|
|
|
142
142
|
{{#each IMMEDIATE_TASKS}}
|
|
143
143
|
{{this.order}}. {{this.task}}
|
|
144
144
|
{{/each}}
|
|
145
145
|
|
|
146
|
-
###
|
|
146
|
+
### Warnings
|
|
147
147
|
|
|
148
148
|
{{#each WARNINGS}}
|
|
149
149
|
- ⚠️ {{this}}
|
|
150
150
|
{{/each}}
|
|
151
151
|
|
|
152
|
-
###
|
|
152
|
+
### Reference Files
|
|
153
153
|
|
|
154
154
|
{{#each REFERENCE_FILES}}
|
|
155
155
|
- `{{this}}`
|
|
@@ -157,7 +157,7 @@ scripts/restore-checkpoint.sh {{LATEST_CP_ID}}
|
|
|
157
157
|
|
|
158
158
|
---
|
|
159
159
|
|
|
160
|
-
##
|
|
160
|
+
## Metadata
|
|
161
161
|
|
|
162
162
|
```yaml
|
|
163
163
|
stage: "{{CURRENT_STAGE}}"
|
|
@@ -1,91 +1,91 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Work State Save - {{TIMESTAMP}}
|
|
2
2
|
|
|
3
|
-
##
|
|
4
|
-
-
|
|
5
|
-
-
|
|
3
|
+
## Context State
|
|
4
|
+
- **Remaining Context**: {{REMAINING_PERCENT}}%
|
|
5
|
+
- **Save Trigger**: {{TRIGGER_REASON}}
|
|
6
6
|
|
|
7
7
|
---
|
|
8
8
|
|
|
9
|
-
##
|
|
9
|
+
## Current Stage
|
|
10
10
|
**{{STAGE_ID}}**: {{STAGE_NAME}}
|
|
11
11
|
|
|
12
|
-
##
|
|
13
|
-
-
|
|
14
|
-
-
|
|
15
|
-
-
|
|
12
|
+
## Stage Progress
|
|
13
|
+
- Total Tasks: {{TOTAL_TASKS}}
|
|
14
|
+
- Completed: {{COMPLETED_TASKS}}
|
|
15
|
+
- Progress: {{PROGRESS_PERCENT}}%
|
|
16
16
|
|
|
17
17
|
---
|
|
18
18
|
|
|
19
|
-
##
|
|
19
|
+
## Completed Tasks
|
|
20
20
|
{{#each COMPLETED_ITEMS}}
|
|
21
21
|
- [x] {{this.name}} ({{this.completed_at}})
|
|
22
22
|
{{/each}}
|
|
23
23
|
|
|
24
|
-
##
|
|
24
|
+
## Tasks In Progress
|
|
25
25
|
{{#each IN_PROGRESS_ITEMS}}
|
|
26
26
|
- [ ] **{{this.name}}**
|
|
27
|
-
-
|
|
28
|
-
-
|
|
27
|
+
- Started: {{this.started_at}}
|
|
28
|
+
- Status: {{this.status_detail}}
|
|
29
29
|
{{/each}}
|
|
30
30
|
|
|
31
|
-
##
|
|
31
|
+
## Pending Tasks
|
|
32
32
|
{{#each PENDING_ITEMS}}
|
|
33
33
|
- [ ] {{this.name}}
|
|
34
34
|
{{/each}}
|
|
35
35
|
|
|
36
36
|
---
|
|
37
37
|
|
|
38
|
-
##
|
|
38
|
+
## Key Context
|
|
39
39
|
|
|
40
|
-
###
|
|
40
|
+
### Key Decisions
|
|
41
41
|
{{#each KEY_DECISIONS}}
|
|
42
42
|
- **{{this.topic}}**: {{this.decision}}
|
|
43
|
-
-
|
|
43
|
+
- Rationale: {{this.rationale}}
|
|
44
44
|
{{/each}}
|
|
45
45
|
|
|
46
|
-
###
|
|
46
|
+
### Modified Files
|
|
47
47
|
{{#each MODIFIED_FILES}}
|
|
48
48
|
- `{{this.path}}` - {{this.change_type}} ({{this.lines_changed}} lines)
|
|
49
49
|
{{/each}}
|
|
50
50
|
|
|
51
|
-
###
|
|
51
|
+
### Active Issues/Bugs
|
|
52
52
|
{{#each ACTIVE_ISSUES}}
|
|
53
53
|
- {{this.description}}
|
|
54
|
-
-
|
|
54
|
+
- Status: {{this.status}}
|
|
55
55
|
{{/each}}
|
|
56
56
|
|
|
57
57
|
---
|
|
58
58
|
|
|
59
|
-
## AI
|
|
60
|
-
| AI |
|
|
61
|
-
|
|
59
|
+
## AI Call Log
|
|
60
|
+
| AI | Time | Prompt File | Result File |
|
|
61
|
+
|----|------|-------------|-------------|
|
|
62
62
|
{{#each AI_CALLS}}
|
|
63
63
|
| {{this.model}} | {{this.timestamp}} | {{this.prompt_file}} | {{this.output_file}} |
|
|
64
64
|
{{/each}}
|
|
65
65
|
|
|
66
66
|
---
|
|
67
67
|
|
|
68
|
-
##
|
|
68
|
+
## Recovery Instructions
|
|
69
69
|
|
|
70
|
-
###
|
|
71
|
-
1.
|
|
72
|
-
2.
|
|
73
|
-
3.
|
|
70
|
+
### Immediate Actions (On Session Recovery)
|
|
71
|
+
1. Read this file: `state/context/{{FILENAME}}`
|
|
72
|
+
2. Reference current HANDOFF: `{{HANDOFF_FILE}}`
|
|
73
|
+
3. Resume from next task: **{{NEXT_TASK}}**
|
|
74
74
|
|
|
75
|
-
###
|
|
76
|
-
1.
|
|
77
|
-
2.
|
|
78
|
-
3.
|
|
79
|
-
4.
|
|
75
|
+
### Context Restoration Priority
|
|
76
|
+
1. Load current stage `CLAUDE.md`
|
|
77
|
+
2. Reference previous stage `HANDOFF.md`
|
|
78
|
+
3. Check active task status
|
|
79
|
+
4. Open files being modified
|
|
80
80
|
|
|
81
|
-
###
|
|
81
|
+
### Additional Reference Files
|
|
82
82
|
{{#each REFERENCE_FILES}}
|
|
83
83
|
- `{{this}}`
|
|
84
84
|
{{/each}}
|
|
85
85
|
|
|
86
86
|
---
|
|
87
87
|
|
|
88
|
-
##
|
|
88
|
+
## Metadata
|
|
89
89
|
```json
|
|
90
90
|
{
|
|
91
91
|
"created_at": "{{TIMESTAMP}}",
|