claude-code-workflow 7.2.24 → 7.2.26

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 (69) hide show
  1. package/.ccw/workflows/cli-tools-usage.md +123 -521
  2. package/.claude/CLAUDE.md +20 -0
  3. package/.claude/agents/action-planning-agent.md +6 -0
  4. package/.claude/agents/cli-explore-agent.md +63 -77
  5. package/.claude/agents/cli-lite-planning-agent.md +10 -11
  6. package/.claude/agents/issue-plan-agent.md +7 -2
  7. package/.claude/commands/workflow/spec/setup.md +1 -1
  8. package/.claude/skills/brainstorm/SKILL.md +408 -408
  9. package/.claude/skills/review-cycle/SKILL.md +132 -132
  10. package/.claude/skills/review-cycle/phases/review-module.md +4 -4
  11. package/.claude/skills/review-cycle/phases/review-session.md +4 -4
  12. package/.claude/skills/spec-generator/SKILL.md +1 -1
  13. package/.claude/skills/team-designer/phases/02-scaffold-generation.md +1 -1
  14. package/.claude/skills/team-lifecycle-v4/SKILL.md +1 -1
  15. package/.claude/skills/team-review/SKILL.md +1 -1
  16. package/.claude/skills/team-ultra-analyze/SKILL.md +1 -1
  17. package/.claude/skills/workflow-multi-cli-plan/SKILL.md +3 -3
  18. package/.claude/skills/workflow-plan/SKILL.md +1 -1
  19. package/.claude/skills/workflow-plan/phases/03-conflict-resolution.md +2 -2
  20. package/.claude/skills/workflow-plan/phases/05-plan-verify.md +2 -2
  21. package/.claude/skills/workflow-tdd-plan/phases/02-context-gathering.md +3 -3
  22. package/.claude/skills/workflow-tdd-plan/phases/04-conflict-resolution.md +2 -2
  23. package/.claude/skills/workflow-test-fix/SKILL.md +1 -1
  24. package/.claude/skills/workflow-test-fix/phases/02-test-context-gather.md +2 -2
  25. package/.codex/AGENTS.md +16 -0
  26. package/.codex/skills/analyze-with-file/SKILL.md +966 -966
  27. package/.codex/skills/issue-discover/SKILL.md +361 -361
  28. package/.codex/skills/review-cycle/SKILL.md +1 -1
  29. package/.codex/skills/roadmap-with-file/SKILL.md +901 -901
  30. package/.codex/skills/spec-generator/SKILL.md +425 -425
  31. package/.codex/skills/spec-setup/SKILL.md +669 -669
  32. package/.codex/skills/team-designer/phases/02-scaffold-generation.md +1 -1
  33. package/.codex/skills/workflow-test-fix-cycle/SKILL.md +402 -402
  34. package/ccw/dist/tools/index.d.ts.map +1 -1
  35. package/ccw/dist/tools/index.js +2 -0
  36. package/ccw/dist/tools/index.js.map +1 -1
  37. package/ccw/dist/tools/json-builder.d.ts +17 -0
  38. package/ccw/dist/tools/json-builder.d.ts.map +1 -0
  39. package/ccw/dist/tools/json-builder.js +746 -0
  40. package/ccw/dist/tools/json-builder.js.map +1 -0
  41. package/ccw/dist/tools/schema-registry.d.ts +71 -0
  42. package/ccw/dist/tools/schema-registry.d.ts.map +1 -0
  43. package/ccw/dist/tools/schema-registry.js +136 -0
  44. package/ccw/dist/tools/schema-registry.js.map +1 -0
  45. package/package.json +1 -1
  46. package/.claude/skills/team-iterdev/SKILL.md +0 -127
  47. package/.claude/skills/team-iterdev/roles/architect/role.md +0 -65
  48. package/.claude/skills/team-iterdev/roles/coordinator/commands/analyze.md +0 -62
  49. package/.claude/skills/team-iterdev/roles/coordinator/commands/dispatch.md +0 -234
  50. package/.claude/skills/team-iterdev/roles/coordinator/commands/monitor.md +0 -182
  51. package/.claude/skills/team-iterdev/roles/coordinator/role.md +0 -153
  52. package/.claude/skills/team-iterdev/roles/developer/role.md +0 -74
  53. package/.claude/skills/team-iterdev/roles/reviewer/role.md +0 -66
  54. package/.claude/skills/team-iterdev/roles/tester/role.md +0 -88
  55. package/.claude/skills/team-iterdev/specs/pipelines.md +0 -94
  56. package/.claude/skills/team-iterdev/specs/team-config.json +0 -172
  57. package/.codex/prompts/prep-cycle.md +0 -416
  58. package/.codex/prompts/prep-plan.md +0 -371
  59. package/.codex/skills/team-iterdev/SKILL.md +0 -219
  60. package/.codex/skills/team-iterdev/roles/architect/role.md +0 -65
  61. package/.codex/skills/team-iterdev/roles/coordinator/commands/analyze.md +0 -62
  62. package/.codex/skills/team-iterdev/roles/coordinator/commands/dispatch.md +0 -187
  63. package/.codex/skills/team-iterdev/roles/coordinator/commands/monitor.md +0 -227
  64. package/.codex/skills/team-iterdev/roles/coordinator/role.md +0 -193
  65. package/.codex/skills/team-iterdev/roles/developer/role.md +0 -74
  66. package/.codex/skills/team-iterdev/roles/reviewer/role.md +0 -66
  67. package/.codex/skills/team-iterdev/roles/tester/role.md +0 -88
  68. package/.codex/skills/team-iterdev/specs/pipelines.md +0 -94
  69. package/.codex/skills/team-iterdev/specs/team-config.json +0 -172
@@ -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
- }