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.
- package/README.md +16 -12
- package/bin/create.js +80 -69
- package/package.json +1 -1
- package/template/.claude/commands/benchmark.md +32 -32
- package/template/.claude/commands/brainstorm.md +33 -33
- package/template/.claude/commands/checkpoint.md +42 -42
- package/template/.claude/commands/codex.md +52 -52
- package/template/.claude/commands/collaborate.md +47 -47
- package/template/.claude/commands/context.md +77 -77
- package/template/.claude/commands/deploy.md +50 -50
- package/template/.claude/commands/fork.md +46 -46
- package/template/.claude/commands/gemini.md +43 -43
- package/template/.claude/commands/handoff.md +42 -42
- package/template/.claude/commands/implement.md +42 -42
- package/template/.claude/commands/init-project.md +25 -25
- package/template/.claude/commands/next.md +67 -67
- package/template/.claude/commands/planning.md +38 -38
- package/template/.claude/commands/qa.md +47 -47
- package/template/.claude/commands/refactor.md +50 -50
- package/template/.claude/commands/research.md +31 -31
- package/template/.claude/commands/restore.md +53 -53
- package/template/.claude/commands/run-stage.md +45 -45
- package/template/.claude/commands/stages.md +49 -49
- package/template/.claude/commands/status.md +41 -41
- package/template/.claude/commands/tasks.md +33 -33
- package/template/.claude/commands/test.md +45 -45
- package/template/.claude/commands/ui-ux.md +31 -31
- package/template/.claude/commands/validate.md +81 -81
- package/template/.claude/hooks/ai-selector.sh +39 -39
- package/template/.claude/hooks/auto-checkpoint.sh +30 -30
- package/template/.claude/hooks/output-validator.sh +45 -45
- package/template/.claude/hooks/post-stage.sh +28 -28
- package/template/.claude/hooks/pre-stage.sh +47 -47
- package/template/.claude/hooks/session-start.sh +27 -27
- package/template/.claude/hooks/statusline.sh +24 -24
- package/template/.claude/hooks/stop.sh +26 -26
- package/template/.claude/settings.json +32 -32
- package/template/.claude/skills/ai-collaboration/README.md +31 -31
- package/template/.claude/skills/ai-collaboration/debate.md +66 -66
- package/template/.claude/skills/ai-collaboration/parallel.md +34 -34
- package/template/.claude/skills/ai-collaboration/prompts/CLAUDE.md +59 -63
- package/template/.claude/skills/auto-checkpoint/README.md +46 -46
- package/template/.claude/skills/auto-checkpoint/prompts/CLAUDE.md +68 -72
- package/template/.claude/skills/auto-checkpoint/rollback.md +95 -95
- package/template/.claude/skills/auto-checkpoint/trigger.md +37 -37
- package/template/.claude/skills/context-compression/README.md +69 -69
- package/template/.claude/skills/context-compression/analyze.md +74 -74
- package/template/.claude/skills/context-compression/compress.md +103 -103
- package/template/.claude/skills/context-compression/prompts/compression.md +78 -78
- package/template/.claude/skills/output-validator/README.md +33 -33
- package/template/.claude/skills/output-validator/prompts/CLAUDE.md +74 -78
- package/template/.claude/skills/output-validator/validate.md +76 -76
- package/template/.claude/skills/smart-handoff/README.md +35 -35
- package/template/.claude/skills/smart-handoff/extract.md +42 -42
- package/template/.claude/skills/smart-handoff/prompts/CLAUDE.md +52 -54
- package/template/.claude/skills/smart-handoff/summarize.md +55 -55
- package/template/.claude/skills/stage-transition/README.md +50 -50
- package/template/.claude/skills/stage-transition/handoff-gen.md +89 -89
- package/template/.claude/skills/stage-transition/prompts/transition.md +74 -74
- package/template/.claude/skills/stage-transition/validate.md +41 -41
- package/template/CLAUDE.md +334 -335
- package/template/config/ai_benchmarking.yaml +22 -22
- package/template/config/ai_collaboration.yaml +18 -18
- package/template/config/ai_logging.yaml +50 -50
- package/template/config/auto_checkpoint.yaml +32 -32
- package/template/config/context.yaml +20 -20
- package/template/config/git.yaml +51 -51
- package/template/config/handoff_intelligence.yaml +23 -23
- package/template/config/mcp_fallbacks.yaml +71 -71
- package/template/config/memory_integration.yaml +23 -23
- package/template/config/model_enforcement.yaml +53 -53
- package/template/config/models.yaml +24 -24
- package/template/config/output_validation.yaml +44 -44
- package/template/config/pipeline.yaml +25 -25
- package/template/config/pipeline_forking.yaml +40 -40
- package/template/config/qa_logging.yaml +67 -67
- package/template/config/smart_rollback.yaml +48 -48
- package/template/config/stage_personas.yaml +154 -154
- package/template/config/workflow.yaml +16 -16
- package/template/scripts/ai-benchmark.sh +41 -41
- package/template/scripts/codex-wrapper.sh +32 -32
- package/template/scripts/context-manager.sh +136 -136
- package/template/scripts/create-checkpoint.sh +34 -34
- package/template/scripts/gemini-wrapper.sh +31 -31
- package/template/scripts/init-project.sh +40 -40
- package/template/scripts/list-stages.sh +30 -30
- package/template/scripts/next-stage.sh +67 -67
- package/template/scripts/output-validate.sh +2 -2
- package/template/scripts/pipeline-fork.sh +68 -68
- package/template/scripts/pre-run-check.sh +84 -84
- package/template/scripts/restore-checkpoint.sh +50 -50
- package/template/scripts/run-stage.sh +44 -44
- package/template/scripts/show-status.sh +30 -30
- package/template/scripts/smart-handoff.sh +70 -70
- package/template/stages/01-brainstorm/CLAUDE.md +70 -74
- package/template/stages/01-brainstorm/README.md +54 -54
- package/template/stages/01-brainstorm/config.yaml +18 -18
- package/template/stages/01-brainstorm/prompts/collaboration.md +24 -24
- package/template/stages/01-brainstorm/prompts/ideation.md +41 -41
- package/template/stages/01-brainstorm/prompts/persona.md +50 -50
- package/template/stages/01-brainstorm/prompts/requirements.md +55 -55
- package/template/stages/01-brainstorm/prompts/validation.md +28 -28
- package/template/stages/01-brainstorm/templates/ideas.md +47 -47
- package/template/stages/01-brainstorm/templates/requirements_analysis.md +61 -61
- package/template/stages/02-research/CLAUDE.md +72 -76
- package/template/stages/02-research/config.yaml +12 -12
- package/template/stages/02-research/prompts/collaboration.md +29 -29
- package/template/stages/02-research/prompts/feasibility.md +38 -38
- package/template/stages/02-research/prompts/market_analysis.md +29 -29
- package/template/stages/02-research/prompts/tech_stack.md +34 -34
- package/template/stages/02-research/prompts/validation.md +29 -29
- package/template/stages/03-planning/CLAUDE.md +88 -92
- package/template/stages/03-planning/config.yaml +10 -10
- package/template/stages/03-planning/prompts/architecture.md +43 -43
- package/template/stages/03-planning/prompts/collaboration.md +34 -34
- package/template/stages/03-planning/prompts/validation.md +34 -34
- package/template/stages/04-ui-ux/CLAUDE.md +68 -72
- package/template/stages/04-ui-ux/config.yaml +5 -5
- package/template/stages/04-ui-ux/prompts/collaboration.md +35 -35
- package/template/stages/04-ui-ux/prompts/validation.md +30 -30
- package/template/stages/05-task-management/CLAUDE.md +81 -85
- package/template/stages/05-task-management/config.yaml +17 -17
- package/template/stages/05-task-management/prompts/collaboration.md +30 -30
- package/template/stages/05-task-management/prompts/validation.md +33 -33
- package/template/stages/05-task-management/templates/notion_integration.md +70 -70
- package/template/stages/05-task-management/templates/parallel_groups.yaml +64 -64
- package/template/stages/05-task-management/templates/task_schema.yaml +33 -33
- package/template/stages/06-implementation/CLAUDE.md +117 -121
- package/template/stages/06-implementation/config.yaml +10 -10
- package/template/stages/06-implementation/prompts/collaboration.md +29 -29
- package/template/stages/06-implementation/prompts/validation.md +36 -36
- package/template/stages/07-refactoring/CLAUDE.md +120 -124
- package/template/stages/07-refactoring/config.yaml +11 -11
- package/template/stages/07-refactoring/prompts/collaboration.md +36 -36
- package/template/stages/07-refactoring/prompts/validation.md +40 -40
- package/template/stages/08-qa/CLAUDE.md +80 -84
- package/template/stages/08-qa/config.yaml +7 -7
- package/template/stages/08-qa/prompts/collaboration.md +34 -34
- package/template/stages/08-qa/prompts/validation.md +41 -41
- package/template/stages/09-testing/CLAUDE.md +86 -90
- package/template/stages/09-testing/config.yaml +10 -10
- package/template/stages/09-testing/prompts/collaboration.md +38 -38
- package/template/stages/09-testing/prompts/validation.md +41 -41
- package/template/stages/10-deployment/CLAUDE.md +86 -90
- package/template/stages/10-deployment/config.yaml +11 -11
- package/template/stages/10-deployment/prompts/collaboration.md +37 -37
- package/template/stages/10-deployment/prompts/validation.md +54 -54
- 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 Work → Key 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 Changes → Impact 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
|
-
-
|
|
37
|
-
-
|
|
35
|
+
### Low Impact Changes
|
|
36
|
+
- Config file updates (3)
|
|
37
|
+
- Test file additions (2)
|
|
38
38
|
```
|
|
39
39
|
|
|
40
|
-
### 3.
|
|
40
|
+
### 3. Decisions → Structured Record
|
|
41
41
|
|
|
42
42
|
```markdown
|
|
43
|
-
##
|
|
43
|
+
## Decision Record Format
|
|
44
44
|
|
|
45
|
-
### 🔷 [
|
|
46
|
-
-
|
|
47
|
-
-
|
|
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 Steps → Immediately 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
|
-
-
|
|
63
|
-
-
|
|
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
|
-
- "
|
|
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
|
|
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.
|
|
24
|
-
-
|
|
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
|
|
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.
|
|
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
|
-
|
|
67
|
+
Current: 04-ui-ux
|
|
68
68
|
|
|
69
|
-
[
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
-
|
|
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
|
-
|
|
22
|
+
Generated: {{TIMESTAMP}}
|
|
23
23
|
|
|
24
|
-
##
|
|
24
|
+
## Completed Work
|
|
25
25
|
|
|
26
|
-
- [x]
|
|
27
|
-
- [x]
|
|
28
|
-
- [x]
|
|
26
|
+
- [x] Task 1
|
|
27
|
+
- [x] Task 2
|
|
28
|
+
- [x] Task 3
|
|
29
29
|
|
|
30
|
-
##
|
|
30
|
+
## Key Decisions
|
|
31
31
|
|
|
32
|
-
###
|
|
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
|
-
-
|
|
46
|
+
(If applicable)
|
|
47
|
+
- Approach 1: [Failure reason]
|
|
48
48
|
|
|
49
|
-
##
|
|
49
|
+
## Next Steps
|
|
50
50
|
|
|
51
|
-
###
|
|
52
|
-
1. [
|
|
53
|
-
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
|
|
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
|
-
|
|
99
|
-
AI:
|
|
100
|
-
|
|
101
|
-
AI: design-system.md
|
|
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
|
-
###
|
|
104
|
+
### Output (HANDOFF.md)
|
|
105
105
|
|
|
106
106
|
```markdown
|
|
107
107
|
# Handoff: 04-ui-ux → 05-task-management
|
|
108
108
|
|
|
109
|
-
|
|
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
|
-
###
|
|
120
|
-
-
|
|
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
|
-
###
|
|
125
|
-
-
|
|
126
|
-
-
|
|
127
|
-
-
|
|
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
|
-
|
|
158
|
+
Let me know if modifications are needed.
|
|
159
|
+
Once confirmed, transition to next stage with /next.
|
|
160
160
|
```
|