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,105 +1,101 @@
|
|
|
1
1
|
# Stage 05: Task Management
|
|
2
2
|
|
|
3
|
-
>
|
|
4
|
-
> -
|
|
5
|
-
> -
|
|
6
|
-
> - **Order**
|
|
7
|
-
> -
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
##
|
|
12
|
-
|
|
13
|
-
>
|
|
14
|
-
>
|
|
15
|
-
>
|
|
16
|
-
|
|
17
|
-
###
|
|
18
|
-
-
|
|
19
|
-
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
|
|
23
|
-
###
|
|
24
|
-
-
|
|
25
|
-
-
|
|
26
|
-
-
|
|
27
|
-
-
|
|
28
|
-
|
|
29
|
-
###
|
|
30
|
-
-
|
|
31
|
-
-
|
|
32
|
-
-
|
|
33
|
-
|
|
34
|
-
### AI
|
|
35
|
-
- **Temperature**: 0.3 (
|
|
36
|
-
-
|
|
37
|
-
|
|
38
|
-
##
|
|
39
|
-
- **Primary**: ClaudeCode (
|
|
3
|
+
> **Notion Task Creation Rules**
|
|
4
|
+
> - Tasks must be created **one at a time sequentially**
|
|
5
|
+
> - **Status** field required for all tasks (default: To Do)
|
|
6
|
+
> - Specify order with **Order** field (View sorting is manual)
|
|
7
|
+
> - Schema: `templates/task_schema.yaml` | Guide: `templates/notion_integration.md`
|
|
8
|
+
|
|
9
|
+
Task breakdown and sprint planning stage
|
|
10
|
+
|
|
11
|
+
## Persona: Project Organizer
|
|
12
|
+
|
|
13
|
+
> You are a Project Organizer.
|
|
14
|
+
> Break down all work into small, actionable units.
|
|
15
|
+
> Each task must have clear completion criteria and dependencies.
|
|
16
|
+
|
|
17
|
+
### Characteristics
|
|
18
|
+
- Systematic breakdown
|
|
19
|
+
- Dependency analysis
|
|
20
|
+
- Priority setting
|
|
21
|
+
- Actionability
|
|
22
|
+
|
|
23
|
+
### Recommended Actions
|
|
24
|
+
- Break into small units
|
|
25
|
+
- Clear completion criteria
|
|
26
|
+
- Explicit dependencies
|
|
27
|
+
- Actionable tasks
|
|
28
|
+
|
|
29
|
+
### Actions to Avoid
|
|
30
|
+
- Vague tasks
|
|
31
|
+
- Large units
|
|
32
|
+
- Ignoring dependencies
|
|
33
|
+
|
|
34
|
+
### AI Settings
|
|
35
|
+
- **Temperature**: 0.3 (high precision)
|
|
36
|
+
- **Precision**: High
|
|
37
|
+
|
|
38
|
+
## Execution Model
|
|
39
|
+
- **Primary**: ClaudeCode (structured task breakdown)
|
|
40
40
|
- **Mode**: Plan Mode
|
|
41
41
|
|
|
42
|
-
##
|
|
43
|
-
1.
|
|
44
|
-
2.
|
|
45
|
-
3.
|
|
46
|
-
4.
|
|
42
|
+
## Goals
|
|
43
|
+
1. Feature-based task breakdown
|
|
44
|
+
2. Dependency mapping
|
|
45
|
+
3. Sprint plan establishment
|
|
46
|
+
4. Deliverables per milestone definition
|
|
47
47
|
|
|
48
|
-
##
|
|
48
|
+
## Input Files
|
|
49
49
|
- `../03-planning/outputs/project_plan.md`
|
|
50
50
|
- `../03-planning/outputs/architecture.md`
|
|
51
51
|
- `../04-ui-ux/outputs/design_system.md`
|
|
52
52
|
- `../04-ui-ux/HANDOFF.md`
|
|
53
53
|
|
|
54
|
-
##
|
|
55
|
-
- `outputs/tasks.md` -
|
|
56
|
-
- `outputs/sprint_plan.md` -
|
|
57
|
-
- `outputs/milestones.md` -
|
|
58
|
-
- `HANDOFF.md` -
|
|
54
|
+
## Output Files
|
|
55
|
+
- `outputs/tasks.md` - Task list
|
|
56
|
+
- `outputs/sprint_plan.md` - Sprint plan
|
|
57
|
+
- `outputs/milestones.md` - Milestone definitions
|
|
58
|
+
- `HANDOFF.md` - Handoff document for next stage
|
|
59
59
|
|
|
60
|
-
##
|
|
60
|
+
## Workflow
|
|
61
61
|
|
|
62
|
-
### 1.
|
|
63
|
-
-
|
|
64
|
-
-
|
|
65
|
-
-
|
|
62
|
+
### 1. Task Breakdown
|
|
63
|
+
- Feature → Epic → Story → Task
|
|
64
|
+
- Estimate work effort
|
|
65
|
+
- Identify technical dependencies
|
|
66
66
|
|
|
67
|
-
### 2.
|
|
68
|
-
- MoSCoW
|
|
69
|
-
-
|
|
70
|
-
-
|
|
67
|
+
### 2. Priority Decision
|
|
68
|
+
- MoSCoW classification
|
|
69
|
+
- Business value vs technical complexity
|
|
70
|
+
- Risk-based prioritization
|
|
71
71
|
|
|
72
|
-
### 3.
|
|
73
|
-
-
|
|
74
|
-
-
|
|
75
|
-
-
|
|
72
|
+
### 3. Sprint Planning
|
|
73
|
+
- Determine sprint length
|
|
74
|
+
- Capacity-based allocation
|
|
75
|
+
- Include buffer
|
|
76
76
|
|
|
77
|
-
### 4.
|
|
78
|
-
-
|
|
79
|
-
-
|
|
80
|
-
-
|
|
77
|
+
### 4. Milestone Definition
|
|
78
|
+
- Deliverables per checkpoint
|
|
79
|
+
- Success criteria
|
|
80
|
+
- Validation methods
|
|
81
81
|
|
|
82
|
-
##
|
|
82
|
+
## Task Format
|
|
83
83
|
```markdown
|
|
84
|
-
## TASK-XXX: [
|
|
85
|
-
-
|
|
86
|
-
-
|
|
87
|
-
-
|
|
88
|
-
-
|
|
89
|
-
-
|
|
90
|
-
-
|
|
84
|
+
## TASK-XXX: [Task Name]
|
|
85
|
+
- **Epic**: [Epic Name]
|
|
86
|
+
- **Story**: [User Story]
|
|
87
|
+
- **Priority**: Must/Should/Could
|
|
88
|
+
- **Estimated Time**: Xh
|
|
89
|
+
- **Dependencies**: [TASK-YYY, TASK-ZZZ]
|
|
90
|
+
- **Assigned Stage**: 06-implementation
|
|
91
91
|
```
|
|
92
92
|
|
|
93
|
-
##
|
|
94
|
-
- [ ]
|
|
95
|
-
- [ ]
|
|
96
|
-
- [ ]
|
|
97
|
-
- [ ]
|
|
98
|
-
- [ ] HANDOFF.md
|
|
99
|
-
|
|
100
|
-
## 다음 스테이지
|
|
101
|
-
→ **06-implementation**: 핵심 기능 구현
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
93
|
+
## Completion Criteria
|
|
94
|
+
- [ ] Complete task list creation
|
|
95
|
+
- [ ] Generate dependency graph
|
|
96
|
+
- [ ] Plan 3+ sprints
|
|
97
|
+
- [ ] Define milestone deliverables
|
|
98
|
+
- [ ] Generate HANDOFF.md
|
|
105
99
|
|
|
100
|
+
## Next Stage
|
|
101
|
+
→ **06-implementation**: Core feature implementation
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
stage:
|
|
4
4
|
id: "05-task-management"
|
|
5
5
|
name: "Task Management"
|
|
6
|
-
description: "
|
|
6
|
+
description: "Task breakdown and sprint planning"
|
|
7
7
|
|
|
8
8
|
models:
|
|
9
9
|
primary: "claudecode"
|
|
@@ -28,32 +28,32 @@ inputs:
|
|
|
28
28
|
outputs:
|
|
29
29
|
required:
|
|
30
30
|
- name: "tasks.md"
|
|
31
|
-
description: "
|
|
31
|
+
description: "Task list"
|
|
32
32
|
- name: "sprint_plan.md"
|
|
33
|
-
description: "
|
|
33
|
+
description: "Sprint plan"
|
|
34
34
|
- name: "milestones.md"
|
|
35
|
-
description: "
|
|
35
|
+
description: "Milestone definitions"
|
|
36
36
|
- name: "HANDOFF.md"
|
|
37
37
|
|
|
38
|
-
# Notion
|
|
38
|
+
# Notion integration settings (Issue #4, #5, #6, #8, #16 resolution)
|
|
39
39
|
notion_integration:
|
|
40
40
|
enabled: true
|
|
41
41
|
schema: "templates/task_schema.yaml"
|
|
42
42
|
guide: "templates/notion_integration.md"
|
|
43
43
|
|
|
44
|
-
#
|
|
44
|
+
# Task creation rules
|
|
45
45
|
task_creation:
|
|
46
|
-
mode: "sequential" #
|
|
47
|
-
batch_size: 1 #
|
|
48
|
-
delay_ms: 100 #
|
|
46
|
+
mode: "sequential" # Sequential creation required!
|
|
47
|
+
batch_size: 1 # One at a time
|
|
48
|
+
delay_ms: 100 # Delay between creations
|
|
49
49
|
|
|
50
|
-
#
|
|
50
|
+
# Required fields
|
|
51
51
|
required_fields:
|
|
52
52
|
- "Task Name"
|
|
53
|
-
- "Status" # Issue #16:
|
|
54
|
-
- "Order" # Issue #5:
|
|
53
|
+
- "Status" # Issue #16: Required!
|
|
54
|
+
- "Order" # Issue #5: For sorting!
|
|
55
55
|
|
|
56
|
-
#
|
|
56
|
+
# Defaults
|
|
57
57
|
defaults:
|
|
58
58
|
status: "To Do"
|
|
59
59
|
priority: "Medium"
|
|
@@ -68,10 +68,10 @@ prompts:
|
|
|
68
68
|
|
|
69
69
|
completion:
|
|
70
70
|
checklist:
|
|
71
|
-
- "
|
|
72
|
-
- "
|
|
73
|
-
- "
|
|
74
|
-
- "
|
|
71
|
+
- "Complete task list creation"
|
|
72
|
+
- "Generate dependency graph"
|
|
73
|
+
- "Plan 3+ sprints"
|
|
74
|
+
- "Define milestone deliverables"
|
|
75
75
|
|
|
76
76
|
transition:
|
|
77
77
|
next_stage: "06-implementation"
|
|
@@ -1,53 +1,53 @@
|
|
|
1
|
-
# AI
|
|
1
|
+
# AI Collaboration Prompt - Task Management
|
|
2
2
|
|
|
3
|
-
##
|
|
3
|
+
## Collaboration Mode: Sequential Review
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
This stage uses **sequential review** mode to ensure completeness of task breakdown.
|
|
6
6
|
|
|
7
|
-
###
|
|
8
|
-
- **ClaudeCode**:
|
|
7
|
+
### Participating Models
|
|
8
|
+
- **ClaudeCode**: Task breakdown, dependency analysis
|
|
9
9
|
|
|
10
|
-
###
|
|
10
|
+
### Collaboration Prompt
|
|
11
11
|
|
|
12
12
|
```
|
|
13
|
-
#
|
|
13
|
+
# Single model with iterative review
|
|
14
14
|
/collaborate --mode sequential --chain "claudecode:decompose -> claudecode:review"
|
|
15
15
|
```
|
|
16
16
|
|
|
17
|
-
###
|
|
17
|
+
### Workflow
|
|
18
18
|
|
|
19
|
-
1.
|
|
20
|
-
2.
|
|
21
|
-
3.
|
|
19
|
+
1. **Initial Breakdown**: Feature → Epic → Story → Task
|
|
20
|
+
2. **Dependency Analysis**: Identify task relationships
|
|
21
|
+
3. **Review and Adjustment**: Identify missing/duplicate tasks
|
|
22
22
|
|
|
23
|
-
###
|
|
23
|
+
### Task Quality Criteria
|
|
24
24
|
|
|
25
|
-
|
|
|
26
|
-
|
|
27
|
-
|
|
|
28
|
-
|
|
|
29
|
-
|
|
|
30
|
-
|
|
|
25
|
+
| Criteria | Description |
|
|
26
|
+
|----------|-------------|
|
|
27
|
+
| Atomicity | Cannot be broken down further |
|
|
28
|
+
| Clarity | Clear completion criteria |
|
|
29
|
+
| Independence | Minimal dependencies |
|
|
30
|
+
| Estimable | Time estimation possible |
|
|
31
31
|
|
|
32
|
-
### Notion
|
|
32
|
+
### Notion Integration
|
|
33
33
|
|
|
34
|
-
|
|
35
|
-
-
|
|
36
|
-
- Status
|
|
37
|
-
-
|
|
34
|
+
Must follow when creating tasks:
|
|
35
|
+
- Create one at a time sequentially
|
|
36
|
+
- Status field required (default: To Do)
|
|
37
|
+
- Specify order with Order field
|
|
38
38
|
|
|
39
|
-
###
|
|
39
|
+
### Output Format
|
|
40
40
|
|
|
41
41
|
```markdown
|
|
42
|
-
##
|
|
42
|
+
## Task Breakdown Results
|
|
43
43
|
|
|
44
|
-
###
|
|
45
|
-
####
|
|
46
|
-
- TASK-001: [
|
|
47
|
-
- TASK-002: [
|
|
44
|
+
### Epic 1: [Epic Name]
|
|
45
|
+
#### Story 1.1: [Story Name]
|
|
46
|
+
- TASK-001: [Task] (2h)
|
|
47
|
+
- TASK-002: [Task] (4h)
|
|
48
48
|
...
|
|
49
49
|
|
|
50
|
-
###
|
|
50
|
+
### Dependency Graph
|
|
51
51
|
TASK-001 → TASK-003
|
|
52
52
|
TASK-002 → TASK-004
|
|
53
53
|
...
|
|
@@ -1,66 +1,66 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Output Validation Prompt - Task Management
|
|
2
2
|
|
|
3
|
-
##
|
|
3
|
+
## Validation Targets
|
|
4
4
|
|
|
5
|
-
|
|
|
6
|
-
|
|
7
|
-
| `tasks.md` |
|
|
8
|
-
| `sprint_plan.md` |
|
|
9
|
-
| `milestones.md` |
|
|
10
|
-
| `HANDOFF.md` |
|
|
5
|
+
| Output | Required Conditions | Validation Method |
|
|
6
|
+
|--------|---------------------|-------------------|
|
|
7
|
+
| `tasks.md` | Complete task list | Structure verification |
|
|
8
|
+
| `sprint_plan.md` | 3+ sprints | Count verification |
|
|
9
|
+
| `milestones.md` | Deliverables defined | Structure verification |
|
|
10
|
+
| `HANDOFF.md` | First sprint tasks | Item verification |
|
|
11
11
|
|
|
12
|
-
##
|
|
12
|
+
## Validation Command
|
|
13
13
|
|
|
14
14
|
```bash
|
|
15
15
|
/validate --stage 05-task-management
|
|
16
16
|
```
|
|
17
17
|
|
|
18
|
-
##
|
|
18
|
+
## Quality Criteria
|
|
19
19
|
|
|
20
20
|
### tasks.md
|
|
21
|
-
- [ ] MoSCoW
|
|
22
|
-
- [ ]
|
|
23
|
-
- [ ]
|
|
24
|
-
- [ ]
|
|
21
|
+
- [ ] MoSCoW classification applied
|
|
22
|
+
- [ ] Estimated time for each task
|
|
23
|
+
- [ ] Dependencies specified
|
|
24
|
+
- [ ] Assigned stage designated
|
|
25
25
|
|
|
26
26
|
### sprint_plan.md
|
|
27
|
-
- [ ]
|
|
28
|
-
- [ ]
|
|
29
|
-
- [ ]
|
|
30
|
-
- [ ]
|
|
27
|
+
- [ ] 3+ sprints
|
|
28
|
+
- [ ] Capacity calculation per sprint
|
|
29
|
+
- [ ] Buffer time included
|
|
30
|
+
- [ ] Priority-based allocation
|
|
31
31
|
|
|
32
32
|
### milestones.md
|
|
33
|
-
- [ ]
|
|
34
|
-
- [ ]
|
|
35
|
-
- [ ]
|
|
33
|
+
- [ ] Deliverables defined per milestone
|
|
34
|
+
- [ ] Success criteria specified
|
|
35
|
+
- [ ] Validation methods included
|
|
36
36
|
|
|
37
37
|
### HANDOFF.md
|
|
38
|
-
- [ ]
|
|
39
|
-
- [ ]
|
|
40
|
-
- [ ]
|
|
38
|
+
- [ ] Sprint 1 task list
|
|
39
|
+
- [ ] Dependency graph
|
|
40
|
+
- [ ] Priority implementation items
|
|
41
41
|
|
|
42
|
-
##
|
|
42
|
+
## Automated Validation Script
|
|
43
43
|
|
|
44
44
|
```bash
|
|
45
|
-
#
|
|
45
|
+
# Check task count
|
|
46
46
|
grep -c "^- TASK-" outputs/tasks.md
|
|
47
47
|
|
|
48
|
-
#
|
|
48
|
+
# Check sprint count
|
|
49
49
|
grep -c "^## Sprint" outputs/sprint_plan.md
|
|
50
50
|
|
|
51
|
-
#
|
|
51
|
+
# Check milestone count
|
|
52
52
|
grep -c "^## Milestone" outputs/milestones.md
|
|
53
53
|
|
|
54
|
-
#
|
|
54
|
+
# Check dependency graph existence
|
|
55
55
|
grep -c "→" outputs/tasks.md
|
|
56
56
|
```
|
|
57
57
|
|
|
58
|
-
##
|
|
58
|
+
## Task Quality Check
|
|
59
59
|
|
|
60
60
|
```bash
|
|
61
|
-
#
|
|
61
|
+
# Check for missing estimated time
|
|
62
62
|
grep -E "^- TASK-" outputs/tasks.md | grep -v -E "\([0-9]+h\)"
|
|
63
63
|
|
|
64
|
-
#
|
|
65
|
-
grep -E "^- TASK-" outputs/tasks.md | grep -v "
|
|
64
|
+
# Check for missing dependencies
|
|
65
|
+
grep -E "^- TASK-" outputs/tasks.md | grep -v "dependency"
|
|
66
66
|
```
|
|
@@ -1,53 +1,53 @@
|
|
|
1
|
-
# Notion
|
|
1
|
+
# Notion Integration Guide
|
|
2
2
|
|
|
3
|
-
> claude-symphony
|
|
3
|
+
> claude-symphony Task Management - Notion Database Integration
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## Important Notes (Issue #5, #6, #8, #16 Resolution)
|
|
6
6
|
|
|
7
|
-
###
|
|
7
|
+
### Sequential Creation Required
|
|
8
8
|
|
|
9
|
-
Notion API
|
|
9
|
+
When creating tasks via Notion API, **tasks must be created one at a time sequentially**.
|
|
10
10
|
|
|
11
11
|
```
|
|
12
|
-
❌
|
|
12
|
+
❌ Incorrect (parallel creation)
|
|
13
13
|
Promise.all([
|
|
14
|
-
createTask("
|
|
15
|
-
createTask("
|
|
16
|
-
createTask("
|
|
14
|
+
createTask("Task 1"),
|
|
15
|
+
createTask("Task 2"),
|
|
16
|
+
createTask("Task 3")
|
|
17
17
|
])
|
|
18
18
|
|
|
19
|
-
✅
|
|
20
|
-
await createTask("
|
|
21
|
-
await createTask("
|
|
22
|
-
await createTask("
|
|
19
|
+
✅ Correct (sequential creation)
|
|
20
|
+
await createTask("Task 1", { order: 1 })
|
|
21
|
+
await createTask("Task 2", { order: 2 })
|
|
22
|
+
await createTask("Task 3", { order: 3 })
|
|
23
23
|
```
|
|
24
24
|
|
|
25
|
-
###
|
|
25
|
+
### Status Field Required
|
|
26
26
|
|
|
27
|
-
|
|
28
|
-
-
|
|
29
|
-
-
|
|
27
|
+
All tasks must include the `Status` field.
|
|
28
|
+
- Default: `To Do`
|
|
29
|
+
- Explicitly specify when creating
|
|
30
30
|
|
|
31
|
-
###
|
|
31
|
+
### Sorting with Order Field
|
|
32
32
|
|
|
33
|
-
Notion
|
|
33
|
+
Notion database View sorting must be configured manually:
|
|
34
34
|
|
|
35
|
-
1.
|
|
36
|
-
2. `Sort`
|
|
37
|
-
3. `Order`
|
|
38
|
-
4. `Ascending`
|
|
35
|
+
1. Open database View
|
|
36
|
+
2. Click `Sort`
|
|
37
|
+
3. Select `Order` field
|
|
38
|
+
4. Set to `Ascending` order
|
|
39
39
|
|
|
40
40
|
---
|
|
41
41
|
|
|
42
|
-
##
|
|
42
|
+
## Database Creation Procedure
|
|
43
43
|
|
|
44
|
-
### 1.
|
|
44
|
+
### 1. Create Database
|
|
45
45
|
|
|
46
46
|
```javascript
|
|
47
|
-
// MCP Notion
|
|
47
|
+
// MCP Notion tool usage example
|
|
48
48
|
await notion.createDatabase({
|
|
49
|
-
parent: { page_id: "
|
|
50
|
-
title: [{ text: { content: "
|
|
49
|
+
parent: { page_id: "PROJECT_PAGE_ID" },
|
|
50
|
+
title: [{ text: { content: "Project Tasks" } }],
|
|
51
51
|
properties: {
|
|
52
52
|
"Task Name": { title: {} },
|
|
53
53
|
"Status": {
|
|
@@ -98,79 +98,79 @@ await notion.createDatabase({
|
|
|
98
98
|
})
|
|
99
99
|
```
|
|
100
100
|
|
|
101
|
-
### 2.
|
|
101
|
+
### 2. Create Tasks (Sequential)
|
|
102
102
|
|
|
103
103
|
```javascript
|
|
104
|
-
//
|
|
104
|
+
// Task list
|
|
105
105
|
const tasks = [
|
|
106
|
-
{ name: "
|
|
107
|
-
{ name: "
|
|
108
|
-
{ name: "API
|
|
106
|
+
{ name: "Project initial setup", priority: "High" },
|
|
107
|
+
{ name: "Basic UI component implementation", priority: "High" },
|
|
108
|
+
{ name: "API integration", priority: "Medium" },
|
|
109
109
|
// ...
|
|
110
110
|
];
|
|
111
111
|
|
|
112
|
-
//
|
|
112
|
+
// Sequential creation (important!)
|
|
113
113
|
for (let i = 0; i < tasks.length; i++) {
|
|
114
114
|
await notion.createPage({
|
|
115
|
-
parent: { database_id: "
|
|
115
|
+
parent: { database_id: "DATABASE_ID" },
|
|
116
116
|
properties: {
|
|
117
117
|
"Task Name": { title: [{ text: { content: tasks[i].name } }] },
|
|
118
|
-
"Status": { select: { name: "To Do" } }, //
|
|
118
|
+
"Status": { select: { name: "To Do" } }, // Required!
|
|
119
119
|
"Priority": { select: { name: tasks[i].priority } },
|
|
120
|
-
"Order": { number: i + 1 } //
|
|
120
|
+
"Order": { number: i + 1 } // Order guaranteed!
|
|
121
121
|
}
|
|
122
122
|
});
|
|
123
123
|
|
|
124
|
-
//
|
|
124
|
+
// Short delay to ensure order
|
|
125
125
|
await new Promise(resolve => setTimeout(resolve, 100));
|
|
126
126
|
}
|
|
127
127
|
```
|
|
128
128
|
|
|
129
129
|
---
|
|
130
130
|
|
|
131
|
-
## View
|
|
131
|
+
## View Settings (Manual)
|
|
132
132
|
|
|
133
|
-
|
|
133
|
+
Must be configured directly in Notion UI:
|
|
134
134
|
|
|
135
|
-
### Board View
|
|
136
|
-
1. `+ Add a view`
|
|
137
|
-
2. `Board`
|
|
138
|
-
3. `Group by` → `Status`
|
|
135
|
+
### Board View Setup
|
|
136
|
+
1. Click `+ Add a view`
|
|
137
|
+
2. Select `Board`
|
|
138
|
+
3. Set `Group by` → `Status`
|
|
139
139
|
|
|
140
|
-
### List View
|
|
141
|
-
1.
|
|
142
|
-
2. `Sort`
|
|
143
|
-
3. `+ Add a sort`
|
|
144
|
-
4. `Order` → `Ascending`
|
|
140
|
+
### List View Sort Setup
|
|
141
|
+
1. Click `...` in View
|
|
142
|
+
2. Select `Sort`
|
|
143
|
+
3. Click `+ Add a sort`
|
|
144
|
+
4. Set `Order` → `Ascending`
|
|
145
145
|
|
|
146
|
-
###
|
|
147
|
-
1. `Filter`
|
|
148
|
-
2. `Status` `is not` `Done`
|
|
146
|
+
### Filter Setup (Optional)
|
|
147
|
+
1. Click `Filter`
|
|
148
|
+
2. Add `Status` `is not` `Done`
|
|
149
149
|
|
|
150
150
|
---
|
|
151
151
|
|
|
152
|
-
##
|
|
152
|
+
## Checklist
|
|
153
153
|
|
|
154
|
-
- [ ]
|
|
155
|
-
- [ ] Status
|
|
156
|
-
- [ ] Order
|
|
157
|
-
- [ ]
|
|
158
|
-
- [ ] Board View
|
|
159
|
-
- [ ] List View
|
|
154
|
+
- [ ] Database creation complete
|
|
155
|
+
- [ ] Status field included
|
|
156
|
+
- [ ] Order field included
|
|
157
|
+
- [ ] Sequential task creation complete
|
|
158
|
+
- [ ] Board View setup (Status grouping)
|
|
159
|
+
- [ ] List View sort setup (Order ascending)
|
|
160
160
|
|
|
161
161
|
---
|
|
162
162
|
|
|
163
|
-
##
|
|
163
|
+
## Troubleshooting
|
|
164
164
|
|
|
165
|
-
###
|
|
166
|
-
1.
|
|
167
|
-
2.
|
|
168
|
-
3.
|
|
165
|
+
### Tasks are out of order
|
|
166
|
+
1. Check `Order` sort in List View
|
|
167
|
+
2. Fix tasks with missing Order values
|
|
168
|
+
3. Reassign Order values if needed
|
|
169
169
|
|
|
170
|
-
### Status
|
|
171
|
-
1.
|
|
172
|
-
2.
|
|
170
|
+
### Status field missing
|
|
171
|
+
1. Add `Status` in database properties
|
|
172
|
+
2. Assign Status values to existing tasks
|
|
173
173
|
|
|
174
|
-
### View
|
|
175
|
-
1.
|
|
176
|
-
2. `...` → `Lock database`
|
|
174
|
+
### View sort not saving
|
|
175
|
+
1. Check if it's a saved View
|
|
176
|
+
2. Verify `...` → `Lock database` is disabled
|