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,95 +1,95 @@
|
|
|
1
1
|
# /refactor
|
|
2
2
|
|
|
3
|
-
07-refactoring
|
|
3
|
+
Start the 07-refactoring stage directly.
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## Usage
|
|
6
6
|
```
|
|
7
7
|
/refactor [focus-area]
|
|
8
8
|
```
|
|
9
9
|
|
|
10
|
-
##
|
|
10
|
+
## Stage Information
|
|
11
11
|
|
|
12
|
-
|
|
|
13
|
-
|
|
14
|
-
|
|
|
15
|
-
| AI
|
|
16
|
-
|
|
|
17
|
-
|
|
|
12
|
+
| Item | Value |
|
|
13
|
+
|------|-------|
|
|
14
|
+
| Stage | 07-refactoring |
|
|
15
|
+
| AI Model | Codex → ClaudeCode |
|
|
16
|
+
| Execution Mode | Deep Dive |
|
|
17
|
+
| Checkpoint | **Required** |
|
|
18
18
|
|
|
19
|
-
##
|
|
19
|
+
## Actions
|
|
20
20
|
|
|
21
|
-
1.
|
|
22
|
-
- 06-implementation
|
|
23
|
-
- src/, tests/
|
|
24
|
-
- 06
|
|
21
|
+
1. **Prerequisite Check**
|
|
22
|
+
- 06-implementation completion status
|
|
23
|
+
- src/, tests/ exist
|
|
24
|
+
- 06 checkpoint exists
|
|
25
25
|
|
|
26
|
-
2.
|
|
27
|
-
- Codex:
|
|
28
|
-
- ClaudeCode:
|
|
26
|
+
2. **Execute Refactoring**
|
|
27
|
+
- Codex: Code analysis and improvement suggestions
|
|
28
|
+
- ClaudeCode: Apply refactoring
|
|
29
29
|
|
|
30
|
-
3.
|
|
31
|
-
- (
|
|
30
|
+
3. **Output Generation**
|
|
31
|
+
- (Improved) src/
|
|
32
32
|
- refactoring-report.md
|
|
33
33
|
|
|
34
|
-
##
|
|
34
|
+
## Execution
|
|
35
35
|
|
|
36
36
|
```bash
|
|
37
37
|
scripts/run-stage.sh 07-refactoring "$ARGUMENTS"
|
|
38
38
|
```
|
|
39
39
|
|
|
40
|
-
##
|
|
40
|
+
## Workflow
|
|
41
41
|
|
|
42
42
|
```
|
|
43
|
-
Codex (
|
|
43
|
+
Codex (Analysis)
|
|
44
44
|
↓
|
|
45
|
-
|
|
45
|
+
Identify Improvements
|
|
46
46
|
↓
|
|
47
|
-
ClaudeCode (
|
|
47
|
+
ClaudeCode (Apply)
|
|
48
48
|
↓
|
|
49
|
-
|
|
49
|
+
Test Verification
|
|
50
50
|
```
|
|
51
51
|
|
|
52
|
-
##
|
|
52
|
+
## Input Files
|
|
53
53
|
|
|
54
54
|
- `stages/06-implementation/outputs/src/`
|
|
55
55
|
- `stages/06-implementation/outputs/tests/`
|
|
56
56
|
|
|
57
|
-
##
|
|
57
|
+
## Output Files
|
|
58
58
|
|
|
59
|
-
- (
|
|
59
|
+
- (Modified) `src/`
|
|
60
60
|
- `stages/07-refactoring/outputs/refactoring-report.md`
|
|
61
61
|
|
|
62
|
-
##
|
|
62
|
+
## Checkpoint Required!
|
|
63
63
|
|
|
64
|
-
|
|
64
|
+
**Checkpoint required** before and after refactoring:
|
|
65
65
|
|
|
66
66
|
```bash
|
|
67
|
-
#
|
|
68
|
-
/checkpoint "
|
|
67
|
+
# Before refactoring
|
|
68
|
+
/checkpoint "Pre-refactoring state"
|
|
69
69
|
|
|
70
|
-
#
|
|
71
|
-
/checkpoint "
|
|
70
|
+
# After refactoring
|
|
71
|
+
/checkpoint "Refactoring completed"
|
|
72
72
|
```
|
|
73
73
|
|
|
74
|
-
##
|
|
74
|
+
## Refactoring Areas
|
|
75
75
|
|
|
76
|
-
-
|
|
77
|
-
-
|
|
78
|
-
-
|
|
79
|
-
-
|
|
80
|
-
-
|
|
76
|
+
- Code duplication removal
|
|
77
|
+
- Function/class separation
|
|
78
|
+
- Naming convention unification
|
|
79
|
+
- Performance optimization
|
|
80
|
+
- Security improvements
|
|
81
81
|
|
|
82
|
-
##
|
|
82
|
+
## Related Commands
|
|
83
83
|
|
|
84
|
-
- `/run-stage 07` -
|
|
85
|
-
- `/next` -
|
|
86
|
-
- `/implement` -
|
|
87
|
-
- `/codex` - Codex CLI
|
|
88
|
-
- `/checkpoint` -
|
|
89
|
-
- `/restore` -
|
|
84
|
+
- `/run-stage 07` - Start after prerequisite check
|
|
85
|
+
- `/next` - Next stage (08-qa)
|
|
86
|
+
- `/implement` - Previous stage
|
|
87
|
+
- `/codex` - Direct Codex CLI call
|
|
88
|
+
- `/checkpoint` - Create checkpoint
|
|
89
|
+
- `/restore` - Rollback
|
|
90
90
|
|
|
91
91
|
## Tips
|
|
92
92
|
|
|
93
|
-
-
|
|
94
|
-
-
|
|
95
|
-
-
|
|
93
|
+
- Always checkpoint before refactoring
|
|
94
|
+
- Incremental improvements in small units
|
|
95
|
+
- Commit after test pass verification
|
|
@@ -1,60 +1,60 @@
|
|
|
1
1
|
# /research
|
|
2
2
|
|
|
3
|
-
02-research
|
|
3
|
+
Start the 02-research stage directly.
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## Usage
|
|
6
6
|
```
|
|
7
7
|
/research [focus-area]
|
|
8
8
|
```
|
|
9
9
|
|
|
10
|
-
##
|
|
10
|
+
## Stage Information
|
|
11
11
|
|
|
12
|
-
|
|
|
13
|
-
|
|
14
|
-
|
|
|
15
|
-
| AI
|
|
16
|
-
|
|
|
17
|
-
|
|
|
12
|
+
| Item | Value |
|
|
13
|
+
|------|-------|
|
|
14
|
+
| Stage | 02-research |
|
|
15
|
+
| AI Model | Claude + MCP |
|
|
16
|
+
| Execution Mode | Plan Mode |
|
|
17
|
+
| Checkpoint | Optional |
|
|
18
18
|
|
|
19
|
-
##
|
|
19
|
+
## Actions
|
|
20
20
|
|
|
21
|
-
1.
|
|
22
|
-
- 01-brainstorm
|
|
23
|
-
- ideas.md
|
|
21
|
+
1. **Prerequisite Check**
|
|
22
|
+
- 01-brainstorm completion status
|
|
23
|
+
- ideas.md file exists
|
|
24
24
|
|
|
25
|
-
2.
|
|
26
|
-
- MCP
|
|
27
|
-
-
|
|
28
|
-
-
|
|
25
|
+
2. **Execute Research**
|
|
26
|
+
- Use MCP tools (web search, API)
|
|
27
|
+
- Tech stack investigation
|
|
28
|
+
- Competitor analysis
|
|
29
29
|
|
|
30
|
-
3.
|
|
31
|
-
- research.md -
|
|
32
|
-
- tech-stack.md -
|
|
30
|
+
3. **Output Generation**
|
|
31
|
+
- research.md - Research results
|
|
32
|
+
- tech-stack.md - Tech stack recommendations
|
|
33
33
|
|
|
34
|
-
##
|
|
34
|
+
## Execution
|
|
35
35
|
|
|
36
36
|
```bash
|
|
37
37
|
scripts/run-stage.sh 02-research "$ARGUMENTS"
|
|
38
38
|
```
|
|
39
39
|
|
|
40
|
-
##
|
|
40
|
+
## Input Files
|
|
41
41
|
|
|
42
42
|
- `stages/01-brainstorm/outputs/ideas.md`
|
|
43
43
|
- `stages/01-brainstorm/outputs/decisions.md`
|
|
44
44
|
|
|
45
|
-
##
|
|
45
|
+
## Output Files
|
|
46
46
|
|
|
47
47
|
- `stages/02-research/outputs/research.md`
|
|
48
48
|
- `stages/02-research/outputs/tech-stack.md`
|
|
49
49
|
|
|
50
|
-
##
|
|
50
|
+
## Related Commands
|
|
51
51
|
|
|
52
|
-
- `/run-stage 02` -
|
|
53
|
-
- `/next` -
|
|
54
|
-
- `/brainstorm` -
|
|
52
|
+
- `/run-stage 02` - Start after prerequisite check
|
|
53
|
+
- `/next` - Next stage (03-planning)
|
|
54
|
+
- `/brainstorm` - Previous stage
|
|
55
55
|
|
|
56
|
-
## MCP
|
|
56
|
+
## MCP Tool Utilization
|
|
57
57
|
|
|
58
|
-
- Context7 -
|
|
59
|
-
- WebFetch -
|
|
60
|
-
- WebSearch -
|
|
58
|
+
- Context7 - Library documentation
|
|
59
|
+
- WebFetch - Web page analysis
|
|
60
|
+
- WebSearch - Search result collection
|
|
@@ -1,39 +1,39 @@
|
|
|
1
1
|
# /restore
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Restore project state from a checkpoint.
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## Usage
|
|
6
6
|
```
|
|
7
|
-
/restore --list #
|
|
8
|
-
/restore --latest #
|
|
9
|
-
/restore [CP-ID] #
|
|
7
|
+
/restore --list # View checkpoint list
|
|
8
|
+
/restore --latest # Restore to latest checkpoint
|
|
9
|
+
/restore [CP-ID] # Restore to specific checkpoint
|
|
10
10
|
```
|
|
11
11
|
|
|
12
|
-
##
|
|
12
|
+
## Actions
|
|
13
13
|
|
|
14
|
-
###
|
|
15
|
-
1. `state/checkpoints/`
|
|
16
|
-
2.
|
|
17
|
-
3.
|
|
14
|
+
### View List (`--list`)
|
|
15
|
+
1. Scan `state/checkpoints/` directory
|
|
16
|
+
2. Read each checkpoint's metadata
|
|
17
|
+
3. Output in table format
|
|
18
18
|
|
|
19
|
-
###
|
|
20
|
-
1.
|
|
21
|
-
2.
|
|
22
|
-
3.
|
|
23
|
-
- progress.json
|
|
24
|
-
- outputs
|
|
25
|
-
- HANDOFF.md
|
|
26
|
-
4.
|
|
19
|
+
### Restore (`[CP-ID]` or `--latest`)
|
|
20
|
+
1. **Confirmation prompt** (if not in automation mode)
|
|
21
|
+
2. **Backup current state** (optional)
|
|
22
|
+
3. **Restore checkpoint files**
|
|
23
|
+
- Restore progress.json
|
|
24
|
+
- Restore outputs files
|
|
25
|
+
- Restore HANDOFF.md (if exists)
|
|
26
|
+
4. **Update state**
|
|
27
27
|
|
|
28
|
-
##
|
|
28
|
+
## Execution Script
|
|
29
29
|
|
|
30
30
|
```bash
|
|
31
31
|
scripts/restore-checkpoint.sh "$ARGUMENTS"
|
|
32
32
|
```
|
|
33
33
|
|
|
34
|
-
##
|
|
34
|
+
## Output Examples
|
|
35
35
|
|
|
36
|
-
###
|
|
36
|
+
### View List
|
|
37
37
|
```
|
|
38
38
|
/restore --list
|
|
39
39
|
|
|
@@ -46,68 +46,68 @@ scripts/restore-checkpoint.sh "$ARGUMENTS"
|
|
|
46
46
|
CP-06-20240120-1430 06-implementation 2024-01-20 14:30
|
|
47
47
|
CP-07-20240121-0900 07-refactoring 2024-01-21 09:00
|
|
48
48
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
49
|
-
|
|
49
|
+
Total 3 checkpoints | Restore with /restore [ID]
|
|
50
50
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
51
51
|
```
|
|
52
52
|
|
|
53
|
-
###
|
|
53
|
+
### Execute Restore
|
|
54
54
|
```
|
|
55
55
|
/restore CP-06-20240120-1430
|
|
56
56
|
|
|
57
57
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
58
|
-
⚠️
|
|
58
|
+
⚠️ Checkpoint Restore
|
|
59
59
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
60
|
+
Checkpoint: CP-06-20240120-1430
|
|
61
|
+
Stage: 06-implementation
|
|
62
|
+
Description: Sprint 1 completed
|
|
63
|
+
Created: 2024-01-20 14:30
|
|
64
64
|
|
|
65
|
-
⚠️
|
|
66
|
-
|
|
65
|
+
⚠️ Warning: Current state will be restored to that point.
|
|
66
|
+
Current changes may be lost.
|
|
67
67
|
|
|
68
|
-
|
|
68
|
+
Proceed with restore? [y/N] y
|
|
69
69
|
|
|
70
|
-
|
|
71
|
-
✓ progress.json
|
|
72
|
-
✓ outputs
|
|
73
|
-
✓ HANDOFF.md
|
|
70
|
+
Restoring...
|
|
71
|
+
✓ progress.json restored
|
|
72
|
+
✓ outputs files restored (42 files)
|
|
73
|
+
✓ HANDOFF.md restored
|
|
74
74
|
|
|
75
75
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
76
|
-
✅
|
|
77
|
-
|
|
76
|
+
✅ Checkpoint restore complete!
|
|
77
|
+
Current stage: 06-implementation
|
|
78
78
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
79
79
|
```
|
|
80
80
|
|
|
81
|
-
##
|
|
81
|
+
## Options
|
|
82
82
|
|
|
83
|
-
|
|
|
84
|
-
|
|
85
|
-
| `--list` |
|
|
86
|
-
| `--latest` |
|
|
87
|
-
| `--force` |
|
|
88
|
-
| `--backup` |
|
|
89
|
-
| `--dry-run` |
|
|
83
|
+
| Option | Description |
|
|
84
|
+
|--------|-------------|
|
|
85
|
+
| `--list` | Display checkpoint list |
|
|
86
|
+
| `--latest` | Restore to latest checkpoint |
|
|
87
|
+
| `--force` | Force restore without confirmation |
|
|
88
|
+
| `--backup` | Backup current state before restore |
|
|
89
|
+
| `--dry-run` | Preview only without actual restore |
|
|
90
90
|
|
|
91
|
-
##
|
|
91
|
+
## Cautions
|
|
92
92
|
|
|
93
|
-
-
|
|
94
|
-
-
|
|
95
|
-
- `--backup`
|
|
93
|
+
- Current work will be **overwritten** during restore
|
|
94
|
+
- Run `/checkpoint` first if you have important changes
|
|
95
|
+
- Use `--backup` option for automatic current state backup
|
|
96
96
|
|
|
97
|
-
##
|
|
97
|
+
## Use Cases
|
|
98
98
|
|
|
99
|
-
1.
|
|
99
|
+
1. **Rollback after failed implementation**
|
|
100
100
|
```
|
|
101
101
|
/restore --latest
|
|
102
102
|
```
|
|
103
103
|
|
|
104
|
-
2.
|
|
104
|
+
2. **Restore to specific point**
|
|
105
105
|
```
|
|
106
106
|
/restore --list
|
|
107
107
|
/restore CP-06-20240120-1030
|
|
108
108
|
```
|
|
109
109
|
|
|
110
|
-
3.
|
|
110
|
+
3. **Safe restore (with backup)**
|
|
111
111
|
```
|
|
112
112
|
/restore CP-06-20240120-1030 --backup
|
|
113
113
|
```
|
|
@@ -1,78 +1,78 @@
|
|
|
1
1
|
# /run-stage
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Run a specific stage.
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## Usage
|
|
6
6
|
```
|
|
7
7
|
/run-stage [stage-id]
|
|
8
8
|
```
|
|
9
9
|
|
|
10
|
-
##
|
|
11
|
-
- `01-brainstorm` -
|
|
12
|
-
- `02-research` -
|
|
13
|
-
- `03-planning` -
|
|
14
|
-
- `04-ui-ux` - UI/UX
|
|
15
|
-
- `05-task-management` -
|
|
16
|
-
- `06-implementation` -
|
|
17
|
-
- `07-refactoring` -
|
|
10
|
+
## Stage IDs
|
|
11
|
+
- `01-brainstorm` - Brainstorming
|
|
12
|
+
- `02-research` - Research
|
|
13
|
+
- `03-planning` - Planning
|
|
14
|
+
- `04-ui-ux` - UI/UX Design
|
|
15
|
+
- `05-task-management` - Task Management
|
|
16
|
+
- `06-implementation` - Implementation
|
|
17
|
+
- `07-refactoring` - Refactoring
|
|
18
18
|
- `08-qa` - QA
|
|
19
|
-
- `09-testing` -
|
|
20
|
-
- `10-deployment` -
|
|
19
|
+
- `09-testing` - Testing
|
|
20
|
+
- `10-deployment` - Deployment
|
|
21
21
|
|
|
22
|
-
##
|
|
22
|
+
## Actions
|
|
23
23
|
|
|
24
|
-
1.
|
|
25
|
-
-
|
|
26
|
-
-
|
|
27
|
-
-
|
|
24
|
+
1. **Prerequisite Validation**
|
|
25
|
+
- Check previous stage completion
|
|
26
|
+
- Check previous stage HANDOFF.md exists
|
|
27
|
+
- Check required input files exist
|
|
28
28
|
|
|
29
|
-
2.
|
|
30
|
-
- `stages/[stage-id]/config.yaml`
|
|
31
|
-
- `stages/[stage-id]/CLAUDE.md`
|
|
29
|
+
2. **Load Stage Configuration**
|
|
30
|
+
- Load `stages/[stage-id]/config.yaml`
|
|
31
|
+
- Load `stages/[stage-id]/CLAUDE.md`
|
|
32
32
|
|
|
33
|
-
3.
|
|
34
|
-
- `state/progress.json`
|
|
35
|
-
-
|
|
33
|
+
3. **Update State**
|
|
34
|
+
- Update current stage in `state/progress.json`
|
|
35
|
+
- Record start time
|
|
36
36
|
|
|
37
|
-
4.
|
|
38
|
-
-
|
|
39
|
-
-
|
|
37
|
+
4. **Execute Stage**
|
|
38
|
+
- Follow stage CLAUDE.md instructions
|
|
39
|
+
- Use prompt templates
|
|
40
40
|
|
|
41
|
-
##
|
|
41
|
+
## Execution Script
|
|
42
42
|
|
|
43
43
|
```bash
|
|
44
44
|
scripts/run-stage.sh "$ARGUMENTS"
|
|
45
45
|
```
|
|
46
46
|
|
|
47
|
-
##
|
|
47
|
+
## Example
|
|
48
48
|
|
|
49
49
|
```
|
|
50
50
|
/run-stage 02-research
|
|
51
51
|
|
|
52
|
-
|
|
53
|
-
✓
|
|
54
|
-
- 01-brainstorm:
|
|
55
|
-
- HANDOFF.md:
|
|
56
|
-
✓
|
|
57
|
-
✓
|
|
52
|
+
Output:
|
|
53
|
+
✓ Prerequisite validation complete
|
|
54
|
+
- 01-brainstorm: complete ✓
|
|
55
|
+
- HANDOFF.md: exists ✓
|
|
56
|
+
✓ Stage configuration loaded
|
|
57
|
+
✓ Current stage: 02-research
|
|
58
58
|
|
|
59
|
-
[02-research CLAUDE.md
|
|
59
|
+
[02-research CLAUDE.md content displayed]
|
|
60
60
|
```
|
|
61
61
|
|
|
62
|
-
##
|
|
62
|
+
## Prerequisite Failure
|
|
63
63
|
|
|
64
64
|
```
|
|
65
65
|
/run-stage 03-planning
|
|
66
66
|
|
|
67
|
-
|
|
68
|
-
✗
|
|
69
|
-
- 02-research:
|
|
70
|
-
- 02-research HANDOFF.md:
|
|
67
|
+
Error:
|
|
68
|
+
✗ Prerequisite not met
|
|
69
|
+
- 02-research: in progress (not complete)
|
|
70
|
+
- 02-research HANDOFF.md: not found
|
|
71
71
|
|
|
72
|
-
|
|
73
|
-
/handoff
|
|
72
|
+
Please complete the 02-research stage first.
|
|
73
|
+
Run /handoff to generate the handoff document.
|
|
74
74
|
```
|
|
75
75
|
|
|
76
|
-
##
|
|
77
|
-
-
|
|
78
|
-
-
|
|
76
|
+
## Cautions
|
|
77
|
+
- Stage skipping not allowed (sequential execution)
|
|
78
|
+
- Checkpoint-required stages (06, 07) cannot proceed without checkpoint
|