claude-code-workflow 7.2.24 → 7.2.25

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.
Files changed (42) hide show
  1. package/.ccw/workflows/cli-tools-usage.md +123 -521
  2. package/.claude/skills/brainstorm/SKILL.md +408 -408
  3. package/.claude/skills/review-cycle/SKILL.md +132 -132
  4. package/.claude/skills/spec-generator/SKILL.md +1 -1
  5. package/.claude/skills/team-designer/phases/02-scaffold-generation.md +1 -1
  6. package/.claude/skills/team-lifecycle-v4/SKILL.md +1 -1
  7. package/.claude/skills/team-review/SKILL.md +1 -1
  8. package/.claude/skills/team-ultra-analyze/SKILL.md +1 -1
  9. package/.claude/skills/workflow-multi-cli-plan/SKILL.md +1 -1
  10. package/.claude/skills/workflow-plan/SKILL.md +1 -1
  11. package/.claude/skills/workflow-test-fix/SKILL.md +1 -1
  12. package/.codex/skills/analyze-with-file/SKILL.md +966 -966
  13. package/.codex/skills/issue-discover/SKILL.md +361 -361
  14. package/.codex/skills/review-cycle/SKILL.md +1 -1
  15. package/.codex/skills/roadmap-with-file/SKILL.md +901 -901
  16. package/.codex/skills/spec-generator/SKILL.md +425 -425
  17. package/.codex/skills/spec-setup/SKILL.md +669 -669
  18. package/.codex/skills/team-designer/phases/02-scaffold-generation.md +1 -1
  19. package/.codex/skills/workflow-test-fix-cycle/SKILL.md +402 -402
  20. package/package.json +1 -1
  21. package/.claude/skills/team-iterdev/SKILL.md +0 -127
  22. package/.claude/skills/team-iterdev/roles/architect/role.md +0 -65
  23. package/.claude/skills/team-iterdev/roles/coordinator/commands/analyze.md +0 -62
  24. package/.claude/skills/team-iterdev/roles/coordinator/commands/dispatch.md +0 -234
  25. package/.claude/skills/team-iterdev/roles/coordinator/commands/monitor.md +0 -182
  26. package/.claude/skills/team-iterdev/roles/coordinator/role.md +0 -153
  27. package/.claude/skills/team-iterdev/roles/developer/role.md +0 -74
  28. package/.claude/skills/team-iterdev/roles/reviewer/role.md +0 -66
  29. package/.claude/skills/team-iterdev/roles/tester/role.md +0 -88
  30. package/.claude/skills/team-iterdev/specs/pipelines.md +0 -94
  31. package/.claude/skills/team-iterdev/specs/team-config.json +0 -172
  32. package/.codex/skills/team-iterdev/SKILL.md +0 -219
  33. package/.codex/skills/team-iterdev/roles/architect/role.md +0 -65
  34. package/.codex/skills/team-iterdev/roles/coordinator/commands/analyze.md +0 -62
  35. package/.codex/skills/team-iterdev/roles/coordinator/commands/dispatch.md +0 -187
  36. package/.codex/skills/team-iterdev/roles/coordinator/commands/monitor.md +0 -227
  37. package/.codex/skills/team-iterdev/roles/coordinator/role.md +0 -193
  38. package/.codex/skills/team-iterdev/roles/developer/role.md +0 -74
  39. package/.codex/skills/team-iterdev/roles/reviewer/role.md +0 -66
  40. package/.codex/skills/team-iterdev/roles/tester/role.md +0 -88
  41. package/.codex/skills/team-iterdev/specs/pipelines.md +0 -94
  42. package/.codex/skills/team-iterdev/specs/team-config.json +0 -172
@@ -1,153 +0,0 @@
1
- # Coordinator Role
2
-
3
- Orchestrate team-iterdev: analyze -> dispatch -> spawn -> monitor -> report.
4
-
5
- ## Identity
6
- - Name: coordinator | Tag: [coordinator]
7
- - Responsibility: Analyze task -> Create team -> Dispatch tasks -> Monitor progress -> Report results
8
-
9
- ## Boundaries
10
-
11
- ### MUST
12
- - Use `team-worker` agent type for all worker spawns (NOT `general-purpose`)
13
- - Follow Command Execution Protocol for dispatch and monitor commands
14
- - Respect pipeline stage dependencies (blockedBy)
15
- - Stop after spawning workers -- wait for callbacks
16
- - Handle developer<->reviewer GC loop (max 3 rounds)
17
- - Maintain task-ledger.json for real-time progress
18
- - Execute completion action in Phase 5
19
-
20
- ### MUST NOT
21
- - Implement domain logic (designing, coding, testing, reviewing) -- workers handle this
22
- - Spawn workers without creating tasks first
23
- - Write source code directly
24
- - Force-advance pipeline past failed review/validation
25
- - Modify task outputs (workers own their deliverables)
26
-
27
- ## Command Execution Protocol
28
-
29
- When coordinator needs to execute a command:
30
- 1. Read `commands/<command>.md`
31
- 2. Follow the workflow defined in the command
32
- 3. Commands are inline execution guides, NOT separate agents
33
- 4. Execute synchronously, complete before proceeding
34
-
35
- ## Entry Router
36
-
37
- | Detection | Condition | Handler |
38
- |-----------|-----------|---------|
39
- | Worker callback | Message contains [architect], [developer], [tester], [reviewer] | -> handleCallback (monitor.md) |
40
- | Status check | Args contain "check" or "status" | -> handleCheck (monitor.md) |
41
- | Manual resume | Args contain "resume" or "continue" | -> handleResume (monitor.md) |
42
- | Pipeline complete | All tasks completed | -> handleComplete (monitor.md) |
43
- | Interrupted session | Active/paused session in .workflow/.team/IDS-* | -> Phase 0 |
44
- | New session | None of above | -> Phase 1 |
45
-
46
- For callback/check/resume/complete: load @commands/monitor.md, execute handler, STOP.
47
-
48
- ## Phase 0: Session Resume Check
49
-
50
- 1. Scan `.workflow/.team/IDS-*/.msg/meta.json` for active/paused sessions
51
- 2. No sessions -> Phase 1
52
- 3. Single session -> reconcile (audit TaskList, reset in_progress->pending, rebuild team, kick first ready task)
53
- 4. Multiple -> AskUserQuestion for selection
54
-
55
- ## Phase 1: Requirement Clarification
56
-
57
- TEXT-LEVEL ONLY. No source code reading.
58
-
59
- 1. Parse user task description from $ARGUMENTS
60
- 2. Delegate to @commands/analyze.md
61
- 3. Assess complexity for pipeline selection:
62
-
63
- | Signal | Weight |
64
- |--------|--------|
65
- | Changed files > 10 | +3 |
66
- | Changed files 3-10 | +2 |
67
- | Structural change (refactor, architect, restructure) | +3 |
68
- | Cross-cutting (multiple, across, cross) | +2 |
69
- | Simple fix (fix, bug, typo, patch) | -2 |
70
-
71
- | Score | Pipeline |
72
- |-------|----------|
73
- | >= 5 | multi-sprint |
74
- | 2-4 | sprint |
75
- | 0-1 | patch |
76
-
77
- 4. Ask for missing parameters via AskUserQuestion (mode selection)
78
- 5. Record requirement with scope, pipeline mode
79
- 6. CRITICAL: Always proceed to Phase 2, never skip team workflow
80
-
81
- ## Phase 2: Session & Team Setup
82
-
83
- 1. Resolve workspace paths (MUST do first):
84
- - `project_root` = result of `Bash({ command: "pwd" })`
85
- - `skill_root` = `<project_root>/.claude/skills/team-iterdev`
86
- 2. Generate session ID: `IDS-<slug>-<YYYY-MM-DD>`
87
- 3. Create session folder structure:
88
- ```
89
- mkdir -p .workflow/.team/<session-id>/{design,code,verify,review,wisdom}
90
- ```
91
- 4. Create team: `TeamCreate({ team_name: "iterdev" })`
92
- 5. Read specs/pipelines.md -> select pipeline based on complexity
93
- 6. Initialize wisdom directory (learnings.md, decisions.md, conventions.md, issues.md)
94
- 7. Write session.json
95
- 8. Initialize task-ledger.json
96
- 9. Initialize meta.json with pipeline metadata:
97
- ```typescript
98
- mcp__ccw-tools__team_msg({
99
- operation: "log", session_id: "<id>", from: "coordinator",
100
- type: "state_update", summary: "Session initialized",
101
- data: {
102
- pipeline_mode: "<patch|sprint|multi-sprint>",
103
- pipeline_stages: ["architect", "developer", "tester", "reviewer"],
104
- roles: ["coordinator", "architect", "developer", "tester", "reviewer"],
105
- team_name: "iterdev"
106
- }
107
- })
108
- ```
109
-
110
- ## Phase 3: Task Chain Creation
111
-
112
- Delegate to @commands/dispatch.md:
113
- 1. Read specs/pipelines.md for selected pipeline task registry
114
- 2. Create tasks via TaskCreate, then TaskUpdate with addBlockedBy
115
- 3. Update task-ledger.json
116
-
117
- ## Phase 4: Spawn-and-Stop
118
-
119
- Delegate to @commands/monitor.md#handleSpawnNext:
120
- 1. Find ready tasks (pending + all addBlockedBy dependencies resolved)
121
- 2. Spawn team-worker agents (see SKILL.md Spawn Template)
122
- 3. Output status summary
123
- 4. STOP
124
-
125
- ## Phase 5: Report + Completion Action
126
-
127
- 1. Load session state -> count completed tasks, calculate duration
128
- 2. Record sprint learning to .msg/meta.json sprint_history
129
- 3. List deliverables:
130
-
131
- | Deliverable | Path |
132
- |-------------|------|
133
- | Design Document | <session>/design/design-001.md |
134
- | Task Breakdown | <session>/design/task-breakdown.json |
135
- | Dev Log | <session>/code/dev-log.md |
136
- | Verification Results | <session>/verify/verify-001.json |
137
- | Review Report | <session>/review/review-001.md |
138
-
139
- 4. Execute completion action per session.completion_action:
140
- - interactive -> AskUserQuestion (Archive/Keep/Export)
141
- - auto_archive -> Archive & Clean (status=completed, TeamDelete)
142
- - auto_keep -> Keep Active (status=paused)
143
-
144
- ## Error Handling
145
-
146
- | Error | Resolution |
147
- |-------|------------|
148
- | Task too vague | AskUserQuestion for clarification |
149
- | Session corruption | Attempt recovery, fallback to manual |
150
- | Worker crash | Reset task to pending, respawn |
151
- | GC loop exceeds 3 rounds | Accept with warning, record in shared memory |
152
- | Sprint velocity drops below 50% | Alert user, suggest scope reduction |
153
- | Task ledger corrupted | Rebuild from TaskList state |
@@ -1,74 +0,0 @@
1
- ---
2
- role: developer
3
- prefix: DEV
4
- inner_loop: true
5
- message_types:
6
- success: dev_complete
7
- progress: dev_progress
8
- error: error
9
- ---
10
-
11
- # Developer
12
-
13
- Code implementer. Implements code according to design, incremental delivery. Acts as Generator in Generator-Critic loop (paired with reviewer).
14
-
15
- ## Phase 2: Context Loading
16
-
17
- | Input | Source | Required |
18
- |-------|--------|----------|
19
- | Task description | From task subject/description | Yes |
20
- | Session path | Extracted from task description | Yes |
21
- | .msg/meta.json | <session>/.msg/meta.json | Yes |
22
- | Design document | <session>/design/design-001.md | For non-fix tasks |
23
- | Task breakdown | <session>/design/task-breakdown.json | For non-fix tasks |
24
- | Review feedback | <session>/review/*.md | For fix tasks |
25
- | Wisdom files | <session>/wisdom/ | No |
26
-
27
- 1. Extract session path from task description
28
- 2. Read .msg/meta.json for shared context
29
- 3. Detect task type:
30
-
31
- | Task Type | Detection | Loading |
32
- |-----------|-----------|---------|
33
- | Fix task | Subject contains "fix" | Read latest review file for feedback |
34
- | Normal task | No "fix" in subject | Read design document + task breakdown |
35
-
36
- 4. Load previous implementation_context from .msg/meta.json
37
- 5. Read wisdom files for conventions and known issues
38
-
39
- ## Phase 3: Code Implementation
40
-
41
- **Implementation strategy selection**:
42
-
43
- | Task Count | Complexity | Strategy |
44
- |------------|------------|----------|
45
- | <= 2 tasks | Low | Direct: inline Edit/Write |
46
- | 3-5 tasks | Medium | Single agent: one code-developer for all |
47
- | > 5 tasks | High | Batch agent: group by module, one agent per batch |
48
-
49
- **Fix Task Mode** (GC Loop):
50
- - Focus on review feedback items only
51
- - Fix critical issues first, then high, then medium
52
- - Do NOT change code that was not flagged
53
- - Maintain existing code style and patterns
54
-
55
- **Normal Task Mode**:
56
- - Read target files, apply changes using Edit or Write
57
- - Follow execution order from task breakdown
58
- - Validate syntax after each major change
59
-
60
- ## Phase 4: Self-Validation
61
-
62
- | Check | Method | Pass Criteria |
63
- |-------|--------|---------------|
64
- | Syntax | tsc --noEmit or equivalent | No errors |
65
- | File existence | Verify all planned files exist | All files present |
66
- | Import resolution | Check no broken imports | All imports resolve |
67
-
68
- 1. Run syntax check: `tsc --noEmit` / `python -m py_compile` / equivalent
69
- 2. Auto-fix if validation fails (max 2 attempts)
70
- 3. Write dev log to `<session>/code/dev-log.md`:
71
- - Changed files count, syntax status, fix task flag, file list
72
- 4. Update implementation_context in .msg/meta.json:
73
- - task, changed_files, is_fix, syntax_clean
74
- 5. Write discoveries to wisdom/learnings.md
@@ -1,66 +0,0 @@
1
- ---
2
- role: reviewer
3
- prefix: REVIEW
4
- inner_loop: false
5
- message_types:
6
- success: review_passed
7
- revision: review_revision
8
- critical: review_critical
9
- error: error
10
- ---
11
-
12
- # Reviewer
13
-
14
- Code reviewer. Multi-dimensional review, quality scoring, improvement suggestions. Acts as Critic in Generator-Critic loop (paired with developer).
15
-
16
- ## Phase 2: Context Loading
17
-
18
- | Input | Source | Required |
19
- |-------|--------|----------|
20
- | Task description | From task subject/description | Yes |
21
- | Session path | Extracted from task description | Yes |
22
- | .msg/meta.json | <session>/.msg/meta.json | Yes |
23
- | Design document | <session>/design/design-001.md | For requirements alignment |
24
- | Changed files | Git diff | Yes |
25
-
26
- 1. Extract session path from task description
27
- 2. Read .msg/meta.json for shared context and previous review_feedback_trends
28
- 3. Read design document for requirements alignment
29
- 4. Get changed files via git diff, read file contents (limit 20 files)
30
-
31
- ## Phase 3: Multi-Dimensional Review
32
-
33
- **Review dimensions**:
34
-
35
- | Dimension | Weight | Focus Areas |
36
- |-----------|--------|-------------|
37
- | Correctness | 30% | Logic correctness, boundary handling |
38
- | Completeness | 25% | Coverage of design requirements |
39
- | Maintainability | 25% | Readability, code style, DRY |
40
- | Security | 20% | Vulnerabilities, input validation |
41
-
42
- Per-dimension: scan modified files, record findings with severity (CRITICAL/HIGH/MEDIUM/LOW), include file:line references and suggestions.
43
-
44
- **Scoring**: Weighted average of dimension scores (1-10 each).
45
-
46
- **Output review report** (`<session>/review/review-<num>.md`):
47
- - Files reviewed count, quality score, issue counts by severity
48
- - Per-finding: severity, file:line, dimension, description, suggestion
49
- - Scoring breakdown by dimension
50
- - Signal: CRITICAL / REVISION_NEEDED / APPROVED
51
- - Design alignment notes
52
-
53
- ## Phase 4: Trend Analysis + Verdict
54
-
55
- 1. Compare with previous review_feedback_trends from .msg/meta.json
56
- 2. Identify recurring issues, improvement areas, new issues
57
-
58
- | Verdict Condition | Message Type |
59
- |-------------------|--------------|
60
- | criticalCount > 0 | review_critical |
61
- | score < 7 | review_revision |
62
- | else | review_passed |
63
-
64
- 3. Update review_feedback_trends in .msg/meta.json:
65
- - review_id, score, critical count, high count, dimensions, gc_round
66
- 4. Write discoveries to wisdom/learnings.md
@@ -1,88 +0,0 @@
1
- ---
2
- role: tester
3
- prefix: VERIFY
4
- inner_loop: false
5
- message_types:
6
- success: verify_passed
7
- failure: verify_failed
8
- fix: fix_required
9
- error: error
10
- ---
11
-
12
- # Tester
13
-
14
- Test validator. Test execution, fix cycles, and regression detection.
15
-
16
- ## Phase 2: Environment Detection
17
-
18
- | Input | Source | Required |
19
- |-------|--------|----------|
20
- | Task description | From task subject/description | Yes |
21
- | Session path | Extracted from task description | Yes |
22
- | .msg/meta.json | <session>/.msg/meta.json | Yes |
23
- | Changed files | Git diff | Yes |
24
-
25
- 1. Extract session path from task description
26
- 2. Read .msg/meta.json for shared context
27
- 3. Get changed files via git diff
28
- 4. Detect test framework and command:
29
-
30
- | Detection | Method |
31
- |-----------|--------|
32
- | Test command | Check package.json scripts, pytest.ini, Makefile |
33
- | Coverage tool | Check for nyc, coverage.py, jest --coverage config |
34
-
35
- Common commands: npm test, pytest, go test ./..., cargo test
36
-
37
- ## Phase 3: Execution + Fix Cycle
38
-
39
- **Iterative test-fix cycle** (max 5 iterations):
40
-
41
- | Step | Action |
42
- |------|--------|
43
- | 1 | Run test command |
44
- | 2 | Parse results, check pass rate |
45
- | 3 | Pass rate >= 95% -> exit loop (success) |
46
- | 4 | Extract failing test details |
47
- | 5 | Apply fix using CLI tool |
48
- | 6 | Increment iteration counter |
49
- | 7 | iteration >= MAX (5) -> exit loop (report failures) |
50
- | 8 | Go to Step 1 |
51
-
52
- **Fix delegation**: Use CLI tool to fix failing tests:
53
-
54
- ```bash
55
- ccw cli -p "PURPOSE: Fix failing tests; success = all listed tests pass
56
- TASK: • Analyze test failure output • Identify root cause in changed files • Apply minimal fix
57
- MODE: write
58
- CONTEXT: @<changed-files> | Memory: Test output from current iteration
59
- EXPECTED: Code fixes that make failing tests pass without breaking other tests
60
- CONSTRAINTS: Only modify files in changed list | Minimal changes
61
- Test output: <test-failure-details>
62
- Changed files: <file-list>" --tool gemini --mode write --rule development-debug-runtime-issues
63
- ```
64
-
65
- Wait for CLI completion before re-running tests.
66
-
67
- ## Phase 4: Regression Check + Report
68
-
69
- 1. Run full test suite for regression: `<test-command> --all`
70
-
71
- | Check | Method | Pass Criteria |
72
- |-------|--------|---------------|
73
- | Regression | Run full test suite | No FAIL in output |
74
- | Coverage | Run coverage tool | >= 80% (if configured) |
75
-
76
- 2. Write verification results to `<session>/verify/verify-<num>.json`:
77
- - verify_id, pass_rate, iterations, passed, timestamp, regression_passed
78
-
79
- 3. Determine message type:
80
-
81
- | Condition | Message Type |
82
- |-----------|--------------|
83
- | passRate >= 0.95 | verify_passed |
84
- | passRate < 0.95 && iterations >= MAX | fix_required |
85
- | passRate < 0.95 | verify_failed |
86
-
87
- 4. Update .msg/meta.json with test_patterns entry
88
- 5. Write discoveries to wisdom/issues.md
@@ -1,94 +0,0 @@
1
- # IterDev Pipeline Definitions
2
-
3
- ## Three-Pipeline Architecture
4
-
5
- ### Patch Pipeline (2 beats, serial)
6
-
7
- ```
8
- DEV-001 -> VERIFY-001
9
- [developer] [tester]
10
- ```
11
-
12
- ### Sprint Pipeline (4 beats, with parallel window)
13
-
14
- ```
15
- DESIGN-001 -> DEV-001 -> [VERIFY-001 + REVIEW-001] (parallel)
16
- [architect] [developer] [tester] [reviewer]
17
- ```
18
-
19
- ### Multi-Sprint Pipeline (N beats, iterative)
20
-
21
- ```
22
- Sprint 1: DESIGN-001 -> DEV-001 -> DEV-002(incremental) -> VERIFY-001 -> DEV-fix -> REVIEW-001
23
- Sprint 2: DESIGN-002(refined) -> DEV-003 -> VERIFY-002 -> REVIEW-002
24
- ...
25
- ```
26
-
27
- ## Generator-Critic Loop (developer <-> reviewer)
28
-
29
- ```
30
- DEV -> REVIEW -> (if review.critical_count > 0 || review.score < 7)
31
- -> DEV-fix -> REVIEW-2 -> (if still issues) -> DEV-fix-2 -> REVIEW-3
32
- -> (max 3 rounds, then accept with warning)
33
- ```
34
-
35
- ## Pipeline Selection Logic
36
-
37
- | Signal | Score |
38
- |--------|-------|
39
- | Changed files > 10 | +3 |
40
- | Changed files 3-10 | +2 |
41
- | Structural change | +3 |
42
- | Cross-cutting concern | +2 |
43
- | Simple fix | -2 |
44
-
45
- | Score | Pipeline |
46
- |-------|----------|
47
- | >= 5 | multi-sprint |
48
- | 2-4 | sprint |
49
- | 0-1 | patch |
50
-
51
- ## Task Metadata Registry
52
-
53
- | Task ID | Role | Pipeline | Dependencies | Description |
54
- |---------|------|----------|-------------|-------------|
55
- | DESIGN-001 | architect | sprint/multi | (none) | Technical design and task breakdown |
56
- | DEV-001 | developer | all | DESIGN-001 (sprint/multi) or (none for patch) | Code implementation |
57
- | DEV-002 | developer | multi | DEV-001 | Incremental implementation |
58
- | DEV-fix | developer | sprint/multi | REVIEW-* (GC loop trigger) | Fix issues from review |
59
- | VERIFY-001 | tester | all | DEV-001 (or last DEV) | Test execution and fix cycles |
60
- | REVIEW-001 | reviewer | sprint/multi | DEV-001 (or last DEV) | Code review and quality scoring |
61
-
62
- ## Checkpoints
63
-
64
- | Trigger Condition | Location | Behavior |
65
- |-------------------|----------|----------|
66
- | GC loop exceeds max rounds | After REVIEW-3 | Stop iteration, accept with warning, record in wisdom |
67
- | Sprint transition | End of Sprint N | Pause, retrospective, user confirms `resume` for Sprint N+1 |
68
- | Pipeline stall | No ready + no running tasks | Check missing tasks, report blockedBy chain to user |
69
-
70
- ## Multi-Sprint Dynamic Downgrade
71
-
72
- If Sprint N metrics are strong (velocity >= expected, review avg >= 8), coordinator may downgrade Sprint N+1 from multi-sprint to sprint pipeline for efficiency.
73
-
74
- ## Task Ledger Schema
75
-
76
- | Field | Description |
77
- |-------|-------------|
78
- | `sprint_id` | Current sprint identifier |
79
- | `sprint_goal` | Sprint objective |
80
- | `tasks[]` | Array of task entries |
81
- | `metrics` | Aggregated metrics: total, completed, in_progress, blocked, velocity |
82
-
83
- **Task Entry Fields**:
84
-
85
- | Field | Description |
86
- |-------|-------------|
87
- | `id` | Task identifier |
88
- | `title` | Task title |
89
- | `owner` | Assigned role |
90
- | `status` | pending / in_progress / completed / blocked |
91
- | `started_at` / `completed_at` | Timestamps |
92
- | `gc_rounds` | Generator-Critic iteration count |
93
- | `review_score` | Reviewer score (null until reviewed) |
94
- | `test_pass_rate` | Tester pass rate (null until tested) |
@@ -1,172 +0,0 @@
1
- {
2
- "team_name": "team-iterdev",
3
- "team_display_name": "Team IterDev",
4
- "description": "Iterative development team with Generator-Critic loop, task ledger, sprint learning, dynamic pipeline, conflict handling, concurrency control, rollback strategy, user feedback loop, and tech debt tracking",
5
- "version": "1.2.0",
6
-
7
- "roles": {
8
- "coordinator": {
9
- "task_prefix": null,
10
- "responsibility": "Sprint planning, backlog management, task ledger maintenance, GC loop control, Phase 1: conflict handling, concurrency control, rollback strategy, Phase 3: user feedback loop, tech debt tracking",
11
- "message_types": [
12
- "sprint_started", "gc_loop_trigger", "sprint_complete", "task_unblocked", "error", "shutdown",
13
- "conflict_detected", "conflict_resolved", "resource_locked", "resource_unlocked", "resource_contention",
14
- "rollback_initiated", "rollback_completed", "rollback_failed",
15
- "user_feedback_received", "tech_debt_identified"
16
- ]
17
- },
18
- "architect": {
19
- "task_prefix": "DESIGN",
20
- "responsibility": "Technical design, task decomposition, architecture decisions",
21
- "message_types": ["design_ready", "design_revision", "error"]
22
- },
23
- "developer": {
24
- "task_prefix": "DEV",
25
- "responsibility": "Code implementation, incremental delivery",
26
- "message_types": ["dev_complete", "dev_progress", "error"]
27
- },
28
- "tester": {
29
- "task_prefix": "VERIFY",
30
- "responsibility": "Test execution, fix cycle, regression detection",
31
- "message_types": ["verify_passed", "verify_failed", "fix_required", "error"]
32
- },
33
- "reviewer": {
34
- "task_prefix": "REVIEW",
35
- "responsibility": "Code review, quality scoring, improvement suggestions",
36
- "message_types": ["review_passed", "review_revision", "review_critical", "error"]
37
- }
38
- },
39
-
40
- "pipelines": {
41
- "patch": {
42
- "description": "Simple fix: implement → verify",
43
- "task_chain": ["DEV-001", "VERIFY-001"],
44
- "gc_loops": 0
45
- },
46
- "sprint": {
47
- "description": "Standard feature: design → implement → verify + review (parallel)",
48
- "task_chain": ["DESIGN-001", "DEV-001", "VERIFY-001", "REVIEW-001"],
49
- "gc_loops": 3,
50
- "parallel_groups": [["VERIFY-001", "REVIEW-001"]]
51
- },
52
- "multi-sprint": {
53
- "description": "Large feature: multiple sprint cycles with incremental delivery",
54
- "task_chain": "dynamic — coordinator creates per-sprint chains",
55
- "gc_loops": 3,
56
- "sprint_count": "dynamic"
57
- }
58
- },
59
-
60
- "innovation_patterns": {
61
- "generator_critic": {
62
- "generator": "developer",
63
- "critic": "reviewer",
64
- "max_rounds": 3,
65
- "convergence_trigger": "review.critical_count === 0 && review.score >= 7"
66
- },
67
- "task_ledger": {
68
- "file": "task-ledger.json",
69
- "updated_by": "coordinator",
70
- "tracks": ["status", "gc_rounds", "review_score", "test_pass_rate", "velocity"],
71
- "phase1_extensions": {
72
- "conflict_info": {
73
- "fields": ["status", "conflicting_files", "resolution_strategy", "resolved_by_task_id"],
74
- "default": { "status": "none", "conflicting_files": [], "resolution_strategy": null, "resolved_by_task_id": null }
75
- },
76
- "rollback_info": {
77
- "fields": ["snapshot_id", "rollback_procedure", "last_successful_state_id"],
78
- "default": { "snapshot_id": null, "rollback_procedure": null, "last_successful_state_id": null }
79
- }
80
- }
81
- },
82
- "shared_memory": {
83
- "file": "shared-memory.json",
84
- "fields": {
85
- "architect": "architecture_decisions",
86
- "developer": "implementation_context",
87
- "tester": "test_patterns",
88
- "reviewer": "review_feedback_trends"
89
- },
90
- "persistent_fields": ["sprint_history", "what_worked", "what_failed", "patterns_learned"],
91
- "phase1_extensions": {
92
- "resource_locks": {
93
- "description": "Concurrency control: resource locking state",
94
- "lock_timeout_ms": 300000,
95
- "deadlock_detection": true
96
- }
97
- }
98
- },
99
- "dynamic_pipeline": {
100
- "selector": "coordinator",
101
- "criteria": "file_count + module_count + complexity_assessment",
102
- "downgrade_rule": "velocity >= expected && review_avg >= 8 → simplify next sprint"
103
- }
104
- },
105
-
106
- "phase1_features": {
107
- "conflict_handling": {
108
- "enabled": true,
109
- "detection_strategy": "file_overlap",
110
- "resolution_strategies": ["manual", "auto_merge", "abort"]
111
- },
112
- "concurrency_control": {
113
- "enabled": true,
114
- "lock_timeout_minutes": 5,
115
- "deadlock_detection": true,
116
- "resources": ["task-ledger.json", "shared-memory.json"]
117
- },
118
- "rollback_strategy": {
119
- "enabled": true,
120
- "snapshot_trigger": "task_complete",
121
- "default_procedure": "git revert HEAD"
122
- }
123
- },
124
-
125
- "phase2_features": {
126
- "external_dependency_management": {
127
- "enabled": true,
128
- "validation_trigger": "task_start",
129
- "supported_sources": ["npm", "maven", "pip", "git"],
130
- "version_check_command": {
131
- "npm": "npm list {name}",
132
- "pip": "pip show {name}",
133
- "maven": "mvn dependency:tree"
134
- }
135
- },
136
- "state_recovery": {
137
- "enabled": true,
138
- "checkpoint_trigger": "phase_complete",
139
- "max_checkpoints_per_task": 5,
140
- "checkpoint_dir": "checkpoints/"
141
- }
142
- },
143
-
144
- "phase3_features": {
145
- "user_feedback_loop": {
146
- "enabled": true,
147
- "collection_trigger": "sprint_complete",
148
- "max_feedback_items": 50,
149
- "severity_levels": ["low", "medium", "high", "critical"],
150
- "status_flow": ["new", "reviewed", "addressed", "closed"]
151
- },
152
- "tech_debt_tracking": {
153
- "enabled": true,
154
- "detection_sources": ["review", "test", "architect"],
155
- "categories": ["code", "design", "test", "documentation"],
156
- "severity_levels": ["low", "medium", "high", "critical"],
157
- "status_flow": ["open", "in_progress", "resolved", "deferred"],
158
- "report_trigger": "sprint_retrospective"
159
- }
160
- },
161
-
162
- "collaboration_patterns": ["CP-1", "CP-3", "CP-5", "CP-6"],
163
-
164
- "session_dirs": {
165
- "base": ".workflow/.team/IDS-{slug}-{YYYY-MM-DD}/",
166
- "design": "design/",
167
- "code": "code/",
168
- "verify": "verify/",
169
- "review": "review/",
170
- "messages": ".workflow/.team-msg/{team-name}/"
171
- }
172
- }