claude-symphony 0.0.1 → 0.0.3
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/assets/claude_symphony.webp +0 -0
- package/assets/claude_symphony_ascii.txt +8 -0
- package/bin/create.js +80 -69
- package/package.json +3 -2
- 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,29 +1,29 @@
|
|
|
1
1
|
# Output Validator - Validation Process
|
|
2
2
|
|
|
3
|
-
##
|
|
3
|
+
## Validation Process
|
|
4
4
|
|
|
5
5
|
```mermaid
|
|
6
6
|
graph TD
|
|
7
|
-
A[
|
|
8
|
-
B --> C[
|
|
9
|
-
C --> D{
|
|
10
|
-
D -->|No| E[
|
|
11
|
-
D -->|Yes| F[
|
|
12
|
-
F --> G{
|
|
13
|
-
G -->|No| H[
|
|
14
|
-
G -->|Yes| I[
|
|
15
|
-
I --> J{
|
|
16
|
-
J -->|No| K[
|
|
17
|
-
J -->|Yes| L[
|
|
18
|
-
L --> M[
|
|
7
|
+
A[Start validation] --> B[Load stage rules]
|
|
8
|
+
B --> C[Check required files]
|
|
9
|
+
C --> D{All files exist?}
|
|
10
|
+
D -->|No| E[Report missing files]
|
|
11
|
+
D -->|Yes| F[Content validation]
|
|
12
|
+
F --> G{Content requirements met?}
|
|
13
|
+
G -->|No| H[Report content errors]
|
|
14
|
+
G -->|Yes| I[Command validation]
|
|
15
|
+
I --> J{All commands pass?}
|
|
16
|
+
J -->|No| K[Report command failures]
|
|
17
|
+
J -->|Yes| L[Calculate quality score]
|
|
18
|
+
L --> M[Generate final report]
|
|
19
19
|
```
|
|
20
20
|
|
|
21
|
-
##
|
|
21
|
+
## Step-by-Step Validation
|
|
22
22
|
|
|
23
|
-
### 1.
|
|
23
|
+
### 1. Required File Check
|
|
24
24
|
|
|
25
25
|
```yaml
|
|
26
|
-
#
|
|
26
|
+
# Validation rule example
|
|
27
27
|
required_outputs:
|
|
28
28
|
ideas.md:
|
|
29
29
|
exists: true
|
|
@@ -34,39 +34,39 @@ required_outputs:
|
|
|
34
34
|
is_directory: true
|
|
35
35
|
```
|
|
36
36
|
|
|
37
|
-
|
|
37
|
+
**Validation Results**:
|
|
38
38
|
```markdown
|
|
39
|
-
##
|
|
39
|
+
## File Existence Check
|
|
40
40
|
✅ ideas.md (1,234 bytes)
|
|
41
41
|
✅ source_code/ (directory)
|
|
42
|
-
❌ requirements_analysis.md (
|
|
42
|
+
❌ requirements_analysis.md (missing)
|
|
43
43
|
```
|
|
44
44
|
|
|
45
|
-
### 2.
|
|
45
|
+
### 2. Content Validation
|
|
46
46
|
|
|
47
47
|
```yaml
|
|
48
48
|
content_checks:
|
|
49
49
|
min_ideas: 5
|
|
50
50
|
sections:
|
|
51
|
-
- "
|
|
52
|
-
- "
|
|
51
|
+
- "Functional Requirements"
|
|
52
|
+
- "Non-functional Requirements"
|
|
53
53
|
has_priorities: true
|
|
54
54
|
```
|
|
55
55
|
|
|
56
|
-
|
|
57
|
-
-
|
|
58
|
-
-
|
|
59
|
-
-
|
|
56
|
+
**Validation Method**:
|
|
57
|
+
- Markdown parsing for section check
|
|
58
|
+
- Pattern matching for required elements
|
|
59
|
+
- Counting for minimum requirements
|
|
60
60
|
|
|
61
|
-
|
|
61
|
+
**Validation Results**:
|
|
62
62
|
```markdown
|
|
63
|
-
##
|
|
64
|
-
✅ ideas.md: 8
|
|
65
|
-
⚠️ requirements_analysis.md: "
|
|
66
|
-
✅ project_plan.md:
|
|
63
|
+
## Content Validation
|
|
64
|
+
✅ ideas.md: 8 ideas (minimum 5)
|
|
65
|
+
⚠️ requirements_analysis.md: "Non-functional Requirements" section missing
|
|
66
|
+
✅ project_plan.md: All required sections included
|
|
67
67
|
```
|
|
68
68
|
|
|
69
|
-
### 3.
|
|
69
|
+
### 3. Command Validation
|
|
70
70
|
|
|
71
71
|
```yaml
|
|
72
72
|
validation_commands:
|
|
@@ -84,18 +84,18 @@ validation_commands:
|
|
|
84
84
|
required: true
|
|
85
85
|
```
|
|
86
86
|
|
|
87
|
-
|
|
87
|
+
**Execution and Results**:
|
|
88
88
|
```markdown
|
|
89
|
-
##
|
|
90
|
-
✅ lint:
|
|
91
|
-
✅ typecheck:
|
|
92
|
-
❌ test:
|
|
89
|
+
## Command Validation
|
|
90
|
+
✅ lint: Passed (2 warnings)
|
|
91
|
+
✅ typecheck: Passed
|
|
92
|
+
❌ test: Failed (3 tests failed)
|
|
93
93
|
- tests/auth.test.ts: loginUser should return token
|
|
94
94
|
- tests/auth.test.ts: logout should clear session
|
|
95
95
|
- tests/user.test.ts: createUser validation
|
|
96
96
|
```
|
|
97
97
|
|
|
98
|
-
### 4.
|
|
98
|
+
### 4. Quality Score Calculation
|
|
99
99
|
|
|
100
100
|
```yaml
|
|
101
101
|
quality_metrics:
|
|
@@ -110,57 +110,57 @@ quality_metrics:
|
|
|
110
110
|
target: 0.95
|
|
111
111
|
```
|
|
112
112
|
|
|
113
|
-
|
|
113
|
+
**Calculation Results**:
|
|
114
114
|
```markdown
|
|
115
|
-
##
|
|
116
|
-
|
|
|
117
|
-
|
|
115
|
+
## Quality Score
|
|
116
|
+
| Metric | Current | Target | Score |
|
|
117
|
+
|--------|---------|--------|-------|
|
|
118
118
|
| Lint | 0.95 | 0.90 | ✅ 1.0 |
|
|
119
119
|
| Coverage | 0.75 | 0.80 | ⚠️ 0.94 |
|
|
120
120
|
| Types | 0.98 | 0.95 | ✅ 1.0 |
|
|
121
121
|
|
|
122
|
-
|
|
123
|
-
|
|
122
|
+
**Overall Score**: 0.97 (weighted average)
|
|
123
|
+
**Status**: Pass (minimum 0.7)
|
|
124
124
|
```
|
|
125
125
|
|
|
126
|
-
##
|
|
126
|
+
## Final Report Format
|
|
127
127
|
|
|
128
128
|
```markdown
|
|
129
|
-
#
|
|
129
|
+
# Output Validation Report
|
|
130
130
|
|
|
131
|
-
##
|
|
132
|
-
##
|
|
131
|
+
## Stage: 06-implementation
|
|
132
|
+
## Validation Time: 2024-01-20 14:30:00
|
|
133
133
|
|
|
134
|
-
##
|
|
135
|
-
-
|
|
136
|
-
-
|
|
137
|
-
-
|
|
138
|
-
-
|
|
134
|
+
## Summary
|
|
135
|
+
- **Status**: ⚠️ Partial Pass
|
|
136
|
+
- **Overall Score**: 0.85
|
|
137
|
+
- **Passed Items**: 8/10
|
|
138
|
+
- **Failed Items**: 2
|
|
139
139
|
|
|
140
|
-
##
|
|
140
|
+
## Detailed Results
|
|
141
141
|
|
|
142
|
-
### ✅
|
|
143
|
-
1.
|
|
144
|
-
2. Lint
|
|
145
|
-
3. Type
|
|
142
|
+
### ✅ Passed Items
|
|
143
|
+
1. Required files exist
|
|
144
|
+
2. Lint check
|
|
145
|
+
3. Type check
|
|
146
146
|
...
|
|
147
147
|
|
|
148
|
-
### ❌
|
|
149
|
-
1.
|
|
150
|
-
2.
|
|
148
|
+
### ❌ Failed Items
|
|
149
|
+
1. Test failures (3)
|
|
150
|
+
2. Coverage below target (75% < 80%)
|
|
151
151
|
|
|
152
|
-
##
|
|
153
|
-
1. [ ] tests/auth.test.ts
|
|
154
|
-
2. [ ]
|
|
152
|
+
## Required Fixes
|
|
153
|
+
1. [ ] Fix tests/auth.test.ts
|
|
154
|
+
2. [ ] Increase test coverage by 5%
|
|
155
155
|
|
|
156
|
-
##
|
|
157
|
-
-
|
|
158
|
-
-
|
|
156
|
+
## Recommended Actions
|
|
157
|
+
- Review and fix failed test cases
|
|
158
|
+
- Add missing tests
|
|
159
159
|
```
|
|
160
160
|
|
|
161
|
-
##
|
|
161
|
+
## Failure Behavior
|
|
162
162
|
|
|
163
|
-
###
|
|
163
|
+
### Stage Transition Block
|
|
164
164
|
```yaml
|
|
165
165
|
on_failure:
|
|
166
166
|
action: "block_transition"
|
|
@@ -168,15 +168,15 @@ on_failure:
|
|
|
168
168
|
require_justification: true
|
|
169
169
|
```
|
|
170
170
|
|
|
171
|
-
###
|
|
171
|
+
### Override Prompt
|
|
172
172
|
```markdown
|
|
173
|
-
⚠️
|
|
173
|
+
⚠️ Stage transition blocked due to validation failure.
|
|
174
174
|
|
|
175
|
-
|
|
176
|
-
-
|
|
177
|
-
-
|
|
175
|
+
**Failures**:
|
|
176
|
+
- Test failures: 3
|
|
177
|
+
- Coverage below target: 75%
|
|
178
178
|
|
|
179
|
-
|
|
180
|
-
(
|
|
179
|
+
Force proceed anyway?
|
|
180
|
+
(Enter reason, or 'cancel' to abort)
|
|
181
181
|
> _
|
|
182
182
|
```
|
|
@@ -1,59 +1,59 @@
|
|
|
1
1
|
# Smart HANDOFF Skill
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Smart context extraction and intelligent HANDOFF generation skill
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## Overview
|
|
6
6
|
|
|
7
|
-
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
-
|
|
11
|
-
-
|
|
7
|
+
This skill automates and optimizes the HANDOFF.md generation process:
|
|
8
|
+
- Automatic context extraction
|
|
9
|
+
- Semantic-based compression
|
|
10
|
+
- Stage-specific summarization
|
|
11
|
+
- Memory system integration
|
|
12
12
|
|
|
13
|
-
##
|
|
13
|
+
## Trigger
|
|
14
14
|
|
|
15
|
-
-
|
|
16
|
-
- `/handoff --smart`
|
|
17
|
-
-
|
|
15
|
+
- Auto-activates on stage completion
|
|
16
|
+
- `/handoff --smart` command
|
|
17
|
+
- When context threshold reached
|
|
18
18
|
|
|
19
|
-
##
|
|
19
|
+
## Features
|
|
20
20
|
|
|
21
|
-
### 1.
|
|
22
|
-
-
|
|
23
|
-
-
|
|
24
|
-
-
|
|
25
|
-
-
|
|
26
|
-
- AI
|
|
21
|
+
### 1. Auto Context Extraction (extract.md)
|
|
22
|
+
- Collect completed tasks
|
|
23
|
+
- Extract key decisions
|
|
24
|
+
- List modified files
|
|
25
|
+
- Identify pending issues
|
|
26
|
+
- Organize AI call history
|
|
27
27
|
|
|
28
|
-
### 2.
|
|
29
|
-
-
|
|
30
|
-
-
|
|
31
|
-
-
|
|
32
|
-
-
|
|
28
|
+
### 2. Context Summarization (summarize.md)
|
|
29
|
+
- Completed work → Compress to key achievements
|
|
30
|
+
- File changes → Impact analysis
|
|
31
|
+
- Decisions → Include rationale and alternatives
|
|
32
|
+
- Next steps → Immediately actionable format
|
|
33
33
|
|
|
34
|
-
### 3.
|
|
35
|
-
- claude-mem
|
|
36
|
-
-
|
|
37
|
-
-
|
|
34
|
+
### 3. Memory Integration
|
|
35
|
+
- Save key info to claude-mem
|
|
36
|
+
- Load previous session context
|
|
37
|
+
- Support cross-stage learning
|
|
38
38
|
|
|
39
|
-
##
|
|
39
|
+
## Configuration
|
|
40
40
|
|
|
41
|
-
`config/handoff_intelligence.yaml`
|
|
41
|
+
See `config/handoff_intelligence.yaml`
|
|
42
42
|
|
|
43
|
-
##
|
|
43
|
+
## Usage Examples
|
|
44
44
|
|
|
45
45
|
```bash
|
|
46
|
-
#
|
|
46
|
+
# Smart HANDOFF generation
|
|
47
47
|
/handoff --smart
|
|
48
48
|
|
|
49
|
-
#
|
|
49
|
+
# Compact HANDOFF generation
|
|
50
50
|
/handoff --smart --compact
|
|
51
51
|
|
|
52
|
-
#
|
|
52
|
+
# Detailed recovery HANDOFF generation
|
|
53
53
|
/handoff --smart --recovery
|
|
54
54
|
```
|
|
55
55
|
|
|
56
|
-
##
|
|
56
|
+
## Output
|
|
57
57
|
|
|
58
58
|
- `stages/{current_stage}/HANDOFF.md`
|
|
59
|
-
-
|
|
59
|
+
- Memory save (when claude-mem connected)
|
|
@@ -1,76 +1,76 @@
|
|
|
1
1
|
# Smart HANDOFF - Context Extraction
|
|
2
2
|
|
|
3
|
-
##
|
|
3
|
+
## Auto Context Extraction Process
|
|
4
4
|
|
|
5
|
-
### 1.
|
|
5
|
+
### 1. Collect Completed Tasks
|
|
6
6
|
|
|
7
7
|
```markdown
|
|
8
|
-
##
|
|
9
|
-
- TodoWrite
|
|
10
|
-
-
|
|
11
|
-
-
|
|
8
|
+
## Extraction Target
|
|
9
|
+
- TodoWrite completed items
|
|
10
|
+
- Committed changes
|
|
11
|
+
- Generated outputs
|
|
12
12
|
|
|
13
|
-
##
|
|
14
|
-
- [ ]
|
|
13
|
+
## Format
|
|
14
|
+
- [ ] Completed task (timestamp)
|
|
15
15
|
```
|
|
16
16
|
|
|
17
|
-
### 2.
|
|
17
|
+
### 2. Extract Key Decisions
|
|
18
18
|
|
|
19
|
-
|
|
20
|
-
- "
|
|
21
|
-
- "
|
|
22
|
-
-
|
|
19
|
+
Detect following patterns from conversation:
|
|
20
|
+
- "decided", "selected", "adopted"
|
|
21
|
+
- "use B instead of A", "because..."
|
|
22
|
+
- Architecture/tech stack selection
|
|
23
23
|
|
|
24
24
|
```markdown
|
|
25
|
-
##
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
25
|
+
## Decision Format
|
|
26
|
+
**Decision**: [Decision content]
|
|
27
|
+
**Reason**: [Selection reason]
|
|
28
|
+
**Alternatives**: [Considered alternatives]
|
|
29
29
|
```
|
|
30
30
|
|
|
31
|
-
### 3.
|
|
31
|
+
### 3. List Modified Files
|
|
32
32
|
|
|
33
33
|
```bash
|
|
34
|
-
#
|
|
34
|
+
# Extract changed files via Git
|
|
35
35
|
git diff --name-only HEAD~10
|
|
36
36
|
```
|
|
37
37
|
|
|
38
38
|
```markdown
|
|
39
|
-
##
|
|
40
|
-
|
|
|
41
|
-
|
|
39
|
+
## File Format
|
|
40
|
+
| File | Change Type | Key Changes |
|
|
41
|
+
|------|-------------|-------------|
|
|
42
42
|
```
|
|
43
43
|
|
|
44
|
-
### 4.
|
|
44
|
+
### 4. Identify Pending Issues
|
|
45
45
|
|
|
46
|
-
|
|
46
|
+
Detection patterns:
|
|
47
47
|
- "TODO:", "FIXME:", "HACK:"
|
|
48
|
-
- "
|
|
49
|
-
-
|
|
48
|
+
- "later", "next time", "afterwards"
|
|
49
|
+
- Unresolved errors/warnings
|
|
50
50
|
|
|
51
51
|
```markdown
|
|
52
|
-
##
|
|
53
|
-
- [ ]
|
|
52
|
+
## Issue Format
|
|
53
|
+
- [ ] Issue description (Priority: High/Medium/Low)
|
|
54
54
|
```
|
|
55
55
|
|
|
56
|
-
### 5. AI
|
|
56
|
+
### 5. Organize AI Call History
|
|
57
57
|
|
|
58
58
|
```markdown
|
|
59
|
-
## AI
|
|
60
|
-
| AI |
|
|
61
|
-
|
|
59
|
+
## AI Call History
|
|
60
|
+
| AI | Time | Purpose | Result Summary |
|
|
61
|
+
|----|------|---------|----------------|
|
|
62
62
|
```
|
|
63
63
|
|
|
64
|
-
##
|
|
64
|
+
## Extraction Priority
|
|
65
65
|
|
|
66
|
-
1. **Critical (100)**:
|
|
67
|
-
2. **Key Decisions (90)**:
|
|
68
|
-
3. **Pending Issues (80)**:
|
|
69
|
-
4. **File Changes (70)**:
|
|
70
|
-
5. **Completed Tasks (60)**:
|
|
71
|
-
6. **AI History (50)**: AI
|
|
66
|
+
1. **Critical (100)**: Blocking issues
|
|
67
|
+
2. **Key Decisions (90)**: Core decisions
|
|
68
|
+
3. **Pending Issues (80)**: Pending issues
|
|
69
|
+
4. **File Changes (70)**: File changes
|
|
70
|
+
5. **Completed Tasks (60)**: Completed tasks
|
|
71
|
+
6. **AI History (50)**: AI call history
|
|
72
72
|
|
|
73
|
-
##
|
|
73
|
+
## Implementation
|
|
74
74
|
|
|
75
|
-
|
|
76
|
-
|
|
75
|
+
Script: `scripts/smart-handoff.sh`
|
|
76
|
+
Config: `config/handoff_intelligence.yaml`
|
|
@@ -1,86 +1,84 @@
|
|
|
1
1
|
# Smart HANDOFF Skill - AI Instructions
|
|
2
2
|
|
|
3
|
-
##
|
|
3
|
+
## Role
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
You are a Smart HANDOFF generation specialist. You analyze current stage work and generate optimized HANDOFF for next session or stage.
|
|
6
6
|
|
|
7
|
-
##
|
|
7
|
+
## Core Principles
|
|
8
8
|
|
|
9
|
-
1.
|
|
10
|
-
2.
|
|
11
|
-
3.
|
|
12
|
-
4.
|
|
9
|
+
1. **Compression**: Remove unnecessary information, keep only essentials
|
|
10
|
+
2. **Actionability**: Next steps must be immediately actionable
|
|
11
|
+
3. **Context Preservation**: Always include important decisions and their rationale
|
|
12
|
+
4. **Continuity**: Clarify connection between previous and next work
|
|
13
13
|
|
|
14
|
-
## HANDOFF
|
|
14
|
+
## HANDOFF Generation Process
|
|
15
15
|
|
|
16
|
-
### 1
|
|
16
|
+
### Step 1: Collect Context
|
|
17
17
|
```
|
|
18
|
-
-
|
|
19
|
-
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
18
|
+
- Check completed task list
|
|
19
|
+
- Identify key decisions
|
|
20
|
+
- Identify modified files
|
|
21
|
+
- Collect pending issues
|
|
22
22
|
```
|
|
23
23
|
|
|
24
|
-
### 2
|
|
24
|
+
### Step 2: Assign Priority
|
|
25
25
|
```
|
|
26
|
-
1.
|
|
27
|
-
2.
|
|
28
|
-
3.
|
|
29
|
-
4.
|
|
30
|
-
5.
|
|
26
|
+
1. Blocking issues (Critical)
|
|
27
|
+
2. Key decisions (High)
|
|
28
|
+
3. Pending issues (Medium)
|
|
29
|
+
4. File changes (Low)
|
|
30
|
+
5. Completed tasks (Context)
|
|
31
31
|
```
|
|
32
32
|
|
|
33
|
-
### 3
|
|
33
|
+
### Step 3: Compress and Summarize
|
|
34
34
|
```
|
|
35
|
-
-
|
|
36
|
-
-
|
|
37
|
-
-
|
|
35
|
+
- Compress to within 30% of original tokens
|
|
36
|
+
- Remove duplicate information
|
|
37
|
+
- Group by key achievements
|
|
38
38
|
```
|
|
39
39
|
|
|
40
|
-
### 4
|
|
40
|
+
### Step 4: Write Actionable Next Steps
|
|
41
41
|
```
|
|
42
|
-
-
|
|
43
|
-
-
|
|
44
|
-
-
|
|
42
|
+
- Include specific commands/file paths
|
|
43
|
+
- Specify dependencies/prerequisites
|
|
44
|
+
- Mention expected outputs
|
|
45
45
|
```
|
|
46
46
|
|
|
47
|
-
##
|
|
47
|
+
## Output Format
|
|
48
48
|
|
|
49
49
|
```markdown
|
|
50
50
|
# HANDOFF - {{stage_name}}
|
|
51
51
|
|
|
52
|
-
##
|
|
53
|
-
[1-2
|
|
52
|
+
## Summary
|
|
53
|
+
[1-2 sentence summary of stage completion status]
|
|
54
54
|
|
|
55
|
-
##
|
|
56
|
-
- ✅ [
|
|
57
|
-
- ✅ [
|
|
55
|
+
## Completed Work
|
|
56
|
+
- ✅ [Key achievement 1]
|
|
57
|
+
- ✅ [Key achievement 2]
|
|
58
58
|
|
|
59
|
-
##
|
|
60
|
-
### [
|
|
61
|
-
-
|
|
62
|
-
-
|
|
59
|
+
## Key Decisions
|
|
60
|
+
### [Decision 1]
|
|
61
|
+
- **Choice**: [Selected option]
|
|
62
|
+
- **Reason**: [Core rationale]
|
|
63
63
|
|
|
64
|
-
##
|
|
65
|
-
|
|
|
66
|
-
|
|
64
|
+
## Modified Files
|
|
65
|
+
| File | Change |
|
|
66
|
+
|------|--------|
|
|
67
67
|
|
|
68
|
-
##
|
|
69
|
-
- [ ] [
|
|
68
|
+
## Pending Issues
|
|
69
|
+
- [ ] [Issue 1] (priority)
|
|
70
70
|
|
|
71
|
-
##
|
|
72
|
-
1. [
|
|
73
|
-
2. [
|
|
71
|
+
## Next Steps
|
|
72
|
+
1. [First immediately actionable item]
|
|
73
|
+
2. [Second action]
|
|
74
74
|
|
|
75
|
-
##
|
|
76
|
-
- [
|
|
75
|
+
## References
|
|
76
|
+
- [Related document links]
|
|
77
77
|
```
|
|
78
78
|
|
|
79
|
-
##
|
|
80
|
-
|
|
81
|
-
- 불필요한 세부사항 포함
|
|
82
|
-
- 모호한 다음 단계 (예: "계속 작업")
|
|
83
|
-
- 결정 이유 누락
|
|
84
|
-
- 중복 정보
|
|
85
|
-
|
|
79
|
+
## Prohibited Actions
|
|
86
80
|
|
|
81
|
+
- Including unnecessary details
|
|
82
|
+
- Vague next steps (e.g., "continue work")
|
|
83
|
+
- Omitting decision rationale
|
|
84
|
+
- Duplicate information
|