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,64 +1,64 @@
|
|
|
1
1
|
# /deploy
|
|
2
2
|
|
|
3
|
-
10-deployment
|
|
3
|
+
Start the 10-deployment stage directly.
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## Usage
|
|
6
6
|
```
|
|
7
7
|
/deploy [environment]
|
|
8
8
|
```
|
|
9
9
|
|
|
10
|
-
##
|
|
10
|
+
## Stage Information
|
|
11
11
|
|
|
12
|
-
|
|
|
13
|
-
|
|
14
|
-
|
|
|
15
|
-
| AI
|
|
16
|
-
|
|
|
17
|
-
|
|
|
12
|
+
| Item | Value |
|
|
13
|
+
|------|-------|
|
|
14
|
+
| Stage | 10-deployment |
|
|
15
|
+
| AI Model | ClaudeCode |
|
|
16
|
+
| Execution Mode | Headless |
|
|
17
|
+
| Checkpoint | Optional |
|
|
18
18
|
|
|
19
|
-
##
|
|
19
|
+
## Actions
|
|
20
20
|
|
|
21
|
-
1.
|
|
22
|
-
- 09-testing
|
|
23
|
-
- test-results.md
|
|
24
|
-
-
|
|
21
|
+
1. **Prerequisite Check**
|
|
22
|
+
- 09-testing completion status
|
|
23
|
+
- test-results.md exists
|
|
24
|
+
- All tests passed
|
|
25
25
|
|
|
26
|
-
2.
|
|
27
|
-
- CI/CD
|
|
28
|
-
-
|
|
29
|
-
-
|
|
26
|
+
2. **Execute Deployment**
|
|
27
|
+
- CI/CD pipeline setup
|
|
28
|
+
- Environment-specific deployment
|
|
29
|
+
- Monitoring setup
|
|
30
30
|
|
|
31
|
-
3.
|
|
32
|
-
- CI/CD
|
|
31
|
+
3. **Output Generation**
|
|
32
|
+
- CI/CD configuration files
|
|
33
33
|
- deployment-log.md
|
|
34
34
|
|
|
35
|
-
##
|
|
35
|
+
## Execution
|
|
36
36
|
|
|
37
37
|
```bash
|
|
38
38
|
scripts/run-stage.sh 10-deployment "$ARGUMENTS"
|
|
39
39
|
```
|
|
40
40
|
|
|
41
|
-
##
|
|
41
|
+
## Input Files
|
|
42
42
|
|
|
43
43
|
- `stages/09-testing/outputs/test-results.md`
|
|
44
44
|
- `stages/06-implementation/outputs/src/`
|
|
45
|
-
-
|
|
45
|
+
- All previous stage outputs
|
|
46
46
|
|
|
47
|
-
##
|
|
47
|
+
## Output Files
|
|
48
48
|
|
|
49
49
|
- `.github/workflows/ci.yaml`
|
|
50
50
|
- `.github/workflows/cd.yaml`
|
|
51
51
|
- `stages/10-deployment/outputs/deployment-log.md`
|
|
52
52
|
|
|
53
|
-
##
|
|
53
|
+
## Deployment Environments
|
|
54
54
|
|
|
55
|
-
|
|
|
56
|
-
|
|
57
|
-
| dev |
|
|
58
|
-
| staging |
|
|
59
|
-
| prod |
|
|
55
|
+
| Environment | Description |
|
|
56
|
+
|-------------|-------------|
|
|
57
|
+
| dev | Development environment |
|
|
58
|
+
| staging | Staging |
|
|
59
|
+
| prod | Production |
|
|
60
60
|
|
|
61
|
-
## CI/CD
|
|
61
|
+
## CI/CD Workflow
|
|
62
62
|
|
|
63
63
|
```
|
|
64
64
|
Push
|
|
@@ -72,31 +72,31 @@ CD (Deploy)
|
|
|
72
72
|
Health Check
|
|
73
73
|
```
|
|
74
74
|
|
|
75
|
-
##
|
|
75
|
+
## Related Commands
|
|
76
76
|
|
|
77
|
-
- `/run-stage 10` -
|
|
78
|
-
- `/test` -
|
|
79
|
-
- `/status` -
|
|
77
|
+
- `/run-stage 10` - Start after prerequisite check
|
|
78
|
+
- `/test` - Previous stage
|
|
79
|
+
- `/status` - Pipeline status
|
|
80
80
|
|
|
81
|
-
##
|
|
81
|
+
## Deployment Checklist
|
|
82
82
|
|
|
83
|
-
- [ ]
|
|
84
|
-
- [ ]
|
|
85
|
-
- [ ]
|
|
86
|
-
- [ ] SSL
|
|
87
|
-
- [ ]
|
|
88
|
-
- [ ]
|
|
83
|
+
- [ ] Environment variables configured
|
|
84
|
+
- [ ] Secrets configured (GitHub Secrets)
|
|
85
|
+
- [ ] Domain/DNS configured
|
|
86
|
+
- [ ] SSL certificate
|
|
87
|
+
- [ ] Monitoring configured
|
|
88
|
+
- [ ] Rollback plan
|
|
89
89
|
|
|
90
|
-
##
|
|
90
|
+
## On Completion
|
|
91
91
|
|
|
92
|
-
🎉
|
|
92
|
+
🎉 **Pipeline Complete!**
|
|
93
93
|
|
|
94
|
-
|
|
95
|
-
-
|
|
96
|
-
- `state/handoffs
|
|
94
|
+
All 10 stages completed.
|
|
95
|
+
- Check final status with `/status`
|
|
96
|
+
- Review all documents in `state/handoffs/`
|
|
97
97
|
|
|
98
98
|
## Tips
|
|
99
99
|
|
|
100
|
-
-
|
|
101
|
-
-
|
|
102
|
-
-
|
|
100
|
+
- Verify in staging before prod deployment
|
|
101
|
+
- Prepare rollback script
|
|
102
|
+
- Run smoke tests after deployment
|
|
@@ -1,57 +1,57 @@
|
|
|
1
1
|
# /fork - Pipeline Forking Command
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Fork the pipeline to explore multiple approaches simultaneously.
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## Usage
|
|
6
6
|
|
|
7
7
|
```bash
|
|
8
8
|
/fork [options]
|
|
9
9
|
```
|
|
10
10
|
|
|
11
|
-
##
|
|
11
|
+
## Options
|
|
12
12
|
|
|
13
|
-
|
|
|
14
|
-
|
|
15
|
-
| `--reason` |
|
|
16
|
-
| `--name` |
|
|
17
|
-
| `--direction` |
|
|
18
|
-
| `--compare` |
|
|
19
|
-
| `--merge` |
|
|
20
|
-
| `--list` |
|
|
13
|
+
| Option | Description | Default |
|
|
14
|
+
|--------|-------------|---------|
|
|
15
|
+
| `--reason` | Fork reason (required) | - |
|
|
16
|
+
| `--name` | Fork name | auto |
|
|
17
|
+
| `--direction` | Exploration direction description | - |
|
|
18
|
+
| `--compare` | Compare with existing forks | false |
|
|
19
|
+
| `--merge` | Merge fork | false |
|
|
20
|
+
| `--list` | List active forks | false |
|
|
21
21
|
|
|
22
|
-
##
|
|
22
|
+
## Basic Usage
|
|
23
23
|
|
|
24
|
-
###
|
|
24
|
+
### Create New Fork
|
|
25
25
|
```bash
|
|
26
|
-
/fork --reason "
|
|
26
|
+
/fork --reason "architecture alternative exploration"
|
|
27
27
|
```
|
|
28
28
|
|
|
29
|
-
###
|
|
29
|
+
### Check Fork List
|
|
30
30
|
```bash
|
|
31
31
|
/fork --list
|
|
32
32
|
```
|
|
33
33
|
|
|
34
|
-
###
|
|
34
|
+
### Compare Forks
|
|
35
35
|
```bash
|
|
36
36
|
/fork --compare
|
|
37
37
|
```
|
|
38
38
|
|
|
39
|
-
###
|
|
39
|
+
### Merge Fork
|
|
40
40
|
```bash
|
|
41
41
|
/fork --merge --select "fork_03_alternative_a"
|
|
42
42
|
```
|
|
43
43
|
|
|
44
|
-
##
|
|
44
|
+
## Fork Process
|
|
45
45
|
|
|
46
46
|
```
|
|
47
|
-
1.
|
|
48
|
-
2.
|
|
49
|
-
3.
|
|
50
|
-
4.
|
|
51
|
-
5.
|
|
47
|
+
1. Create checkpoint of current state
|
|
48
|
+
2. Create fork directory (state/forks/)
|
|
49
|
+
3. Copy state
|
|
50
|
+
4. Generate fork HANDOFF
|
|
51
|
+
5. Start fork work
|
|
52
52
|
```
|
|
53
53
|
|
|
54
|
-
##
|
|
54
|
+
## Fork Comparison Output
|
|
55
55
|
|
|
56
56
|
```markdown
|
|
57
57
|
# Fork Comparison
|
|
@@ -71,46 +71,46 @@
|
|
|
71
71
|
| Maintainability | 0.88 | 0.85 | 0.80 |
|
|
72
72
|
|
|
73
73
|
## Recommendation
|
|
74
|
-
**Alt A**
|
|
74
|
+
**Alt A** recommended: Higher code quality
|
|
75
75
|
```
|
|
76
76
|
|
|
77
|
-
##
|
|
77
|
+
## Merge Strategies
|
|
78
78
|
|
|
79
79
|
### best_performer
|
|
80
80
|
```bash
|
|
81
81
|
/fork --merge --strategy best_performer
|
|
82
82
|
```
|
|
83
|
-
-
|
|
83
|
+
- Select best performing fork based on metrics
|
|
84
84
|
|
|
85
85
|
### manual
|
|
86
86
|
```bash
|
|
87
87
|
/fork --merge --strategy manual --select "fork_01"
|
|
88
88
|
```
|
|
89
|
-
-
|
|
89
|
+
- Manual selection
|
|
90
90
|
|
|
91
91
|
### cherry_pick
|
|
92
92
|
```bash
|
|
93
93
|
/fork --merge --strategy cherry_pick
|
|
94
94
|
```
|
|
95
|
-
-
|
|
95
|
+
- Select optimal parts from multiple forks
|
|
96
96
|
|
|
97
|
-
##
|
|
97
|
+
## Examples
|
|
98
98
|
|
|
99
99
|
```bash
|
|
100
|
-
#
|
|
101
|
-
/fork --reason "REST vs GraphQL
|
|
100
|
+
# Fork for architecture alternative exploration
|
|
101
|
+
/fork --reason "REST vs GraphQL comparison" --direction "GraphQL implementation"
|
|
102
102
|
|
|
103
|
-
#
|
|
103
|
+
# Check current fork status
|
|
104
104
|
/fork --list
|
|
105
105
|
|
|
106
|
-
#
|
|
106
|
+
# Compare forks and check metrics
|
|
107
107
|
/fork --compare
|
|
108
108
|
|
|
109
|
-
#
|
|
109
|
+
# Merge best performing fork
|
|
110
110
|
/fork --merge --strategy best_performer
|
|
111
111
|
```
|
|
112
112
|
|
|
113
|
-
##
|
|
113
|
+
## Fork Storage Location
|
|
114
114
|
|
|
115
115
|
```
|
|
116
116
|
state/forks/
|
|
@@ -125,18 +125,18 @@ state/forks/
|
|
|
125
125
|
└── comparison.json
|
|
126
126
|
```
|
|
127
127
|
|
|
128
|
-
##
|
|
128
|
+
## Configuration
|
|
129
129
|
|
|
130
|
-
`config/pipeline_forking.yaml`
|
|
130
|
+
See `config/pipeline_forking.yaml`
|
|
131
131
|
|
|
132
|
-
##
|
|
132
|
+
## Limitations
|
|
133
133
|
|
|
134
|
-
-
|
|
135
|
-
-
|
|
136
|
-
-
|
|
134
|
+
- Max active forks: 3
|
|
135
|
+
- Max fork execution time: 2 hours
|
|
136
|
+
- Checkpoint auto-created before merge
|
|
137
137
|
|
|
138
|
-
##
|
|
138
|
+
## Related Commands
|
|
139
139
|
|
|
140
|
-
- `/checkpoint` -
|
|
141
|
-
- `/restore` -
|
|
142
|
-
- `/status` -
|
|
140
|
+
- `/checkpoint` - Create checkpoint
|
|
141
|
+
- `/restore` - Restore checkpoint
|
|
142
|
+
- `/status` - Pipeline status
|
|
@@ -1,84 +1,84 @@
|
|
|
1
1
|
# /gemini
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Call Gemini CLI through tmux session.
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## Usage
|
|
6
6
|
```
|
|
7
7
|
/gemini [prompt]
|
|
8
8
|
```
|
|
9
9
|
|
|
10
|
-
##
|
|
10
|
+
## Actions
|
|
11
11
|
|
|
12
|
-
1. **tmux
|
|
13
|
-
-
|
|
14
|
-
-
|
|
12
|
+
1. **Check/Create tmux Session**
|
|
13
|
+
- Session name: `ax-gemini`
|
|
14
|
+
- Create new if not exists
|
|
15
15
|
|
|
16
|
-
2. **Gemini CLI
|
|
17
|
-
-
|
|
18
|
-
-
|
|
16
|
+
2. **Execute Gemini CLI**
|
|
17
|
+
- Send prompt
|
|
18
|
+
- Wait for response (wait-for method)
|
|
19
19
|
|
|
20
|
-
3.
|
|
21
|
-
-
|
|
22
|
-
-
|
|
20
|
+
3. **Capture and Return Results**
|
|
21
|
+
- Read results from output file
|
|
22
|
+
- Display to user
|
|
23
23
|
|
|
24
|
-
##
|
|
24
|
+
## Execution Script
|
|
25
25
|
|
|
26
26
|
```bash
|
|
27
27
|
scripts/gemini-wrapper.sh "$ARGUMENTS"
|
|
28
28
|
```
|
|
29
29
|
|
|
30
|
-
##
|
|
30
|
+
## Example
|
|
31
31
|
|
|
32
32
|
```
|
|
33
|
-
/gemini
|
|
33
|
+
/gemini Please summarize recent posts about Claude Code from Reddit r/programming
|
|
34
34
|
|
|
35
|
-
Gemini
|
|
36
|
-
|
|
37
|
-
|
|
35
|
+
Calling Gemini...
|
|
36
|
+
Session: ax-gemini
|
|
37
|
+
Timeout: 300 seconds
|
|
38
38
|
|
|
39
|
-
[
|
|
40
|
-
|
|
39
|
+
[Response]
|
|
40
|
+
Recent posts about Claude Code from Reddit r/programming:
|
|
41
41
|
|
|
42
|
-
1. "
|
|
43
|
-
-
|
|
44
|
-
-
|
|
45
|
-
-
|
|
42
|
+
1. "My experience refactoring an entire project with Claude Code" (3 days ago)
|
|
43
|
+
- Cleanly split functions over 200 lines
|
|
44
|
+
- Test coverage improved from 30% to 85%
|
|
45
|
+
- Pros: Context understanding, Cons: Large file processing speed
|
|
46
46
|
|
|
47
47
|
2. ...
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
-
##
|
|
50
|
+
## Usage Scenarios
|
|
51
51
|
|
|
52
|
-
### 1.
|
|
52
|
+
### 1. Brainstorming (01-brainstorm)
|
|
53
53
|
```
|
|
54
|
-
/gemini
|
|
55
|
-
[
|
|
54
|
+
/gemini Please brainstorm 10 creative ideas for the following project:
|
|
55
|
+
[project description]
|
|
56
56
|
```
|
|
57
57
|
|
|
58
|
-
### 2.
|
|
58
|
+
### 2. Web Research (02-research)
|
|
59
59
|
```
|
|
60
|
-
/gemini
|
|
60
|
+
/gemini Please search the web for latest React Server Components best practices
|
|
61
61
|
```
|
|
62
62
|
|
|
63
|
-
### 3.
|
|
63
|
+
### 3. Competitor Analysis
|
|
64
64
|
```
|
|
65
|
-
/gemini
|
|
65
|
+
/gemini Please analyze the features and UI of [competitor URL]
|
|
66
66
|
```
|
|
67
67
|
|
|
68
|
-
##
|
|
68
|
+
## Timeout
|
|
69
69
|
|
|
70
|
-
|
|
70
|
+
Default timeout: 300 seconds (5 minutes)
|
|
71
71
|
|
|
72
|
-
|
|
72
|
+
To change:
|
|
73
73
|
```
|
|
74
|
-
/gemini --timeout 600 [
|
|
74
|
+
/gemini --timeout 600 [long task prompt]
|
|
75
75
|
```
|
|
76
76
|
|
|
77
|
-
##
|
|
78
|
-
- Gemini CLI
|
|
79
|
-
- tmux
|
|
80
|
-
-
|
|
77
|
+
## Limitations
|
|
78
|
+
- Gemini CLI must be installed
|
|
79
|
+
- tmux must be installed
|
|
80
|
+
- Interactive prompts not supported (single queries only)
|
|
81
81
|
|
|
82
|
-
##
|
|
83
|
-
- `/codex`: Codex CLI
|
|
84
|
-
- `scripts/gemini-wrapper.sh`:
|
|
82
|
+
## Related
|
|
83
|
+
- `/codex`: Codex CLI call
|
|
84
|
+
- `scripts/gemini-wrapper.sh`: Wrapper script
|
|
@@ -1,80 +1,80 @@
|
|
|
1
1
|
# /handoff
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Generate the HANDOFF.md document for the current stage.
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## Usage
|
|
6
6
|
```
|
|
7
7
|
/handoff
|
|
8
8
|
```
|
|
9
9
|
|
|
10
|
-
##
|
|
10
|
+
## Actions
|
|
11
11
|
|
|
12
|
-
1.
|
|
13
|
-
- `state/progress.json
|
|
12
|
+
1. **Check Current Stage**
|
|
13
|
+
- Query current stage from `state/progress.json`
|
|
14
14
|
|
|
15
|
-
2.
|
|
16
|
-
-
|
|
17
|
-
-
|
|
15
|
+
2. **Verify Completion Criteria**
|
|
16
|
+
- Check completion.checklist in stage config.yaml
|
|
17
|
+
- Verify required output files exist
|
|
18
18
|
|
|
19
|
-
3. **HANDOFF.md
|
|
20
|
-
- `HANDOFF.md.template`
|
|
21
|
-
-
|
|
22
|
-
-
|
|
19
|
+
3. **Generate HANDOFF.md**
|
|
20
|
+
- Generate based on `HANDOFF.md.template`
|
|
21
|
+
- Variable substitution (timestamp, deliverables, etc.)
|
|
22
|
+
- Get user input (key decisions, etc.)
|
|
23
23
|
|
|
24
|
-
4.
|
|
25
|
-
- `state/progress.json`
|
|
26
|
-
- `state/handoffs/`
|
|
24
|
+
4. **Update State**
|
|
25
|
+
- Mark handoff complete in `state/progress.json`
|
|
26
|
+
- Save copy to `state/handoffs/` directory
|
|
27
27
|
|
|
28
|
-
5.
|
|
29
|
-
-
|
|
30
|
-
- `/run-stage [next]`
|
|
28
|
+
5. **Next Stage Guidance**
|
|
29
|
+
- Display next stage information
|
|
30
|
+
- Guide `/run-stage [next]` command
|
|
31
31
|
|
|
32
|
-
##
|
|
32
|
+
## Execution Script
|
|
33
33
|
|
|
34
34
|
```bash
|
|
35
35
|
scripts/create-handoff.sh
|
|
36
36
|
```
|
|
37
37
|
|
|
38
|
-
##
|
|
38
|
+
## Example
|
|
39
39
|
|
|
40
40
|
```
|
|
41
41
|
/handoff
|
|
42
42
|
|
|
43
|
-
|
|
43
|
+
Current stage: 01-brainstorm
|
|
44
44
|
|
|
45
|
-
|
|
46
|
-
✓
|
|
47
|
-
✓ 3
|
|
48
|
-
✓
|
|
45
|
+
Completion criteria verification:
|
|
46
|
+
✓ Minimum 10 ideas generated
|
|
47
|
+
✓ 3+ user personas defined
|
|
48
|
+
✓ Requirements analysis document completed
|
|
49
49
|
|
|
50
|
-
|
|
51
|
-
> MVP
|
|
50
|
+
Please enter key decisions:
|
|
51
|
+
> MVP limited to authentication, core feature A, core feature B
|
|
52
52
|
|
|
53
|
-
HANDOFF.md
|
|
54
|
-
-
|
|
55
|
-
-
|
|
53
|
+
HANDOFF.md generation complete!
|
|
54
|
+
- Location: stages/01-brainstorm/HANDOFF.md
|
|
55
|
+
- Backup: state/handoffs/01-brainstorm-20240120-1030.md
|
|
56
56
|
|
|
57
|
-
|
|
57
|
+
Next step:
|
|
58
58
|
/run-stage 02-research
|
|
59
59
|
```
|
|
60
60
|
|
|
61
|
-
##
|
|
61
|
+
## When Completion Criteria Not Met
|
|
62
62
|
|
|
63
63
|
```
|
|
64
64
|
/handoff
|
|
65
65
|
|
|
66
|
-
|
|
66
|
+
Current stage: 01-brainstorm
|
|
67
67
|
|
|
68
|
-
|
|
69
|
-
✓
|
|
70
|
-
✗ 3
|
|
71
|
-
✓
|
|
68
|
+
Completion criteria verification:
|
|
69
|
+
✓ Minimum 10 ideas generated
|
|
70
|
+
✗ 3+ user personas defined (current: 2)
|
|
71
|
+
✓ Requirements analysis document completed
|
|
72
72
|
|
|
73
|
-
|
|
74
|
-
|
|
73
|
+
Please meet the completion criteria.
|
|
74
|
+
Or use --force option to force generation:
|
|
75
75
|
/handoff --force
|
|
76
76
|
```
|
|
77
77
|
|
|
78
|
-
##
|
|
79
|
-
- `--force`:
|
|
80
|
-
- `--draft`:
|
|
78
|
+
## Options
|
|
79
|
+
- `--force`: Force generation even when completion criteria not met
|
|
80
|
+
- `--draft`: Generate as draft (cannot proceed to next stage)
|