aiwcli 0.12.6 → 0.12.8

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 (163) hide show
  1. package/bin/dev.cmd +3 -3
  2. package/bin/dev.js +16 -16
  3. package/bin/run.cmd +3 -3
  4. package/bin/run.js +21 -21
  5. package/dist/commands/branch.js +7 -2
  6. package/dist/lib/bmad-installer.js +37 -37
  7. package/dist/lib/terminal.d.ts +2 -0
  8. package/dist/lib/terminal.js +57 -7
  9. package/dist/templates/CLAUDE.md +232 -205
  10. package/dist/templates/_shared/.claude/settings.json +65 -65
  11. package/dist/templates/_shared/.claude/{commands/handoff.md → skills/handoff/SKILL.md} +13 -12
  12. package/dist/templates/_shared/.claude/{commands/handoff-resume.md → skills/handoff-resume/SKILL.md} +13 -12
  13. package/dist/templates/_shared/.codex/workflows/handoff.md +226 -226
  14. package/dist/templates/_shared/.windsurf/workflows/handoff.md +226 -226
  15. package/dist/templates/_shared/handoff-system/CLAUDE.md +15 -3
  16. package/dist/templates/_shared/handoff-system/lib/document-generator.ts +215 -215
  17. package/dist/templates/_shared/handoff-system/lib/handoff-reader.ts +158 -158
  18. package/dist/templates/_shared/handoff-system/scripts/resume_handoff.ts +373 -373
  19. package/dist/templates/_shared/handoff-system/scripts/save_handoff.ts +469 -469
  20. package/dist/templates/_shared/handoff-system/workflows/handoff-resume.md +66 -66
  21. package/dist/templates/_shared/handoff-system/workflows/handoff.md +254 -254
  22. package/dist/templates/_shared/hooks-ts/_utils/git-state.ts +2 -2
  23. package/dist/templates/_shared/hooks-ts/archive_plan.ts +159 -159
  24. package/dist/templates/_shared/hooks-ts/context_monitor.ts +147 -147
  25. package/dist/templates/_shared/hooks-ts/file-suggestion.ts +128 -128
  26. package/dist/templates/_shared/hooks-ts/pre_compact.ts +49 -49
  27. package/dist/templates/_shared/hooks-ts/session_end.ts +196 -196
  28. package/dist/templates/_shared/hooks-ts/session_start.ts +163 -163
  29. package/dist/templates/_shared/hooks-ts/task_create_capture.ts +48 -48
  30. package/dist/templates/_shared/hooks-ts/task_update_capture.ts +74 -74
  31. package/dist/templates/_shared/hooks-ts/user_prompt_submit.ts +93 -93
  32. package/dist/templates/_shared/lib-ts/CLAUDE.md +367 -367
  33. package/dist/templates/_shared/lib-ts/base/atomic-write.ts +138 -138
  34. package/dist/templates/_shared/lib-ts/base/constants.ts +24 -6
  35. package/dist/templates/_shared/lib-ts/base/git-state.ts +58 -58
  36. package/dist/templates/_shared/lib-ts/base/hook-utils.ts +582 -582
  37. package/dist/templates/_shared/lib-ts/base/inference.ts +301 -301
  38. package/dist/templates/_shared/lib-ts/base/logger.ts +247 -247
  39. package/dist/templates/_shared/lib-ts/base/state-io.ts +202 -202
  40. package/dist/templates/_shared/lib-ts/base/stop-words.ts +184 -184
  41. package/dist/templates/_shared/lib-ts/base/utils.ts +184 -184
  42. package/dist/templates/_shared/lib-ts/context/CLAUDE.md +134 -0
  43. package/dist/templates/_shared/lib-ts/context/context-formatter.ts +566 -566
  44. package/dist/templates/_shared/lib-ts/context/context-selector.ts +524 -524
  45. package/dist/templates/_shared/lib-ts/context/context-store.ts +712 -712
  46. package/dist/templates/_shared/lib-ts/context/plan-manager.ts +312 -312
  47. package/dist/templates/_shared/lib-ts/context/task-tracker.ts +185 -185
  48. package/dist/templates/_shared/lib-ts/package.json +20 -20
  49. package/dist/templates/_shared/lib-ts/templates/formatters.ts +102 -102
  50. package/dist/templates/_shared/lib-ts/templates/plan-context.ts +58 -58
  51. package/dist/templates/_shared/lib-ts/tsconfig.json +13 -13
  52. package/dist/templates/_shared/lib-ts/types.ts +186 -186
  53. package/dist/templates/_shared/scripts/resolve_context.ts +33 -33
  54. package/dist/templates/_shared/scripts/status_line.ts +687 -690
  55. package/dist/templates/cc-native/.claude/commands/cc-native/rlm/ask.md +136 -136
  56. package/dist/templates/cc-native/.claude/commands/cc-native/rlm/index.md +21 -21
  57. package/dist/templates/cc-native/.claude/commands/cc-native/rlm/overview.md +56 -56
  58. package/dist/templates/cc-native/.claude/commands/cc-native/specdev.md +10 -10
  59. package/dist/templates/cc-native/.claude/settings.json +3 -2
  60. package/dist/templates/cc-native/.windsurf/workflows/cc-native/fix.md +8 -8
  61. package/dist/templates/cc-native/.windsurf/workflows/cc-native/implement.md +8 -8
  62. package/dist/templates/cc-native/.windsurf/workflows/cc-native/research.md +8 -8
  63. package/dist/templates/cc-native/CC-NATIVE-README.md +189 -189
  64. package/dist/templates/cc-native/TEMPLATE-SCHEMA.md +304 -304
  65. package/dist/templates/cc-native/_cc-native/agents/CLAUDE.md +143 -143
  66. package/dist/templates/cc-native/_cc-native/agents/PLAN-ORCHESTRATOR.md +213 -213
  67. package/dist/templates/cc-native/_cc-native/agents/plan-questions/PLAN-QUESTIONER.md +70 -70
  68. package/dist/templates/cc-native/_cc-native/artifacts/CLAUDE.md +64 -0
  69. package/dist/templates/cc-native/_cc-native/{lib-ts/artifacts → artifacts/lib}/format.ts +1 -1
  70. package/dist/templates/cc-native/_cc-native/{lib-ts/artifacts → artifacts/lib}/write.ts +2 -2
  71. package/dist/templates/cc-native/_cc-native/cc-native.config.json +96 -96
  72. package/dist/templates/cc-native/_cc-native/hooks/CLAUDE.md +14 -24
  73. package/dist/templates/cc-native/_cc-native/hooks/cc-native-plan-review.ts +1 -1
  74. package/dist/templates/cc-native/_cc-native/hooks/enhance_plan_post_subagent.ts +54 -54
  75. package/dist/templates/cc-native/_cc-native/hooks/enhance_plan_post_write.ts +51 -51
  76. package/dist/templates/cc-native/_cc-native/hooks/mark_questions_asked.ts +53 -53
  77. package/dist/templates/cc-native/_cc-native/hooks/plan_questions_early.ts +61 -61
  78. package/dist/templates/cc-native/_cc-native/hooks/validate_task_prompt.ts +76 -0
  79. package/dist/templates/cc-native/_cc-native/lib-ts/aggregate-agents.ts +9 -2
  80. package/dist/templates/cc-native/_cc-native/lib-ts/cc-native-state.ts +319 -319
  81. package/dist/templates/cc-native/_cc-native/lib-ts/cli-output-parser.ts +144 -144
  82. package/dist/templates/cc-native/_cc-native/lib-ts/config.ts +57 -57
  83. package/dist/templates/cc-native/_cc-native/lib-ts/constants.ts +83 -83
  84. package/dist/templates/cc-native/_cc-native/lib-ts/debug.ts +79 -79
  85. package/dist/templates/cc-native/_cc-native/lib-ts/index.ts +4 -4
  86. package/dist/templates/cc-native/_cc-native/lib-ts/json-parser.ts +168 -168
  87. package/dist/templates/cc-native/_cc-native/lib-ts/plan-discovery.ts +80 -80
  88. package/dist/templates/cc-native/_cc-native/lib-ts/plan-enhancement.ts +41 -41
  89. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/CLAUDE.md +480 -480
  90. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/embedding-indexer.ts +287 -287
  91. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/hyde.ts +148 -148
  92. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/index.ts +54 -54
  93. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/logger.ts +58 -58
  94. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/ollama-client.ts +208 -208
  95. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/retrieval-pipeline.ts +460 -460
  96. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/transcript-indexer.ts +446 -446
  97. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/transcript-loader.ts +280 -280
  98. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/transcript-searcher.ts +274 -274
  99. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/types.ts +201 -201
  100. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/vector-store.ts +278 -278
  101. package/dist/templates/cc-native/_cc-native/lib-ts/settings.ts +184 -184
  102. package/dist/templates/cc-native/_cc-native/lib-ts/state.ts +275 -275
  103. package/dist/templates/cc-native/_cc-native/lib-ts/tsconfig.json +18 -18
  104. package/dist/templates/cc-native/_cc-native/lib-ts/types.ts +1 -1
  105. package/dist/templates/cc-native/_cc-native/plan-review/CLAUDE.md +149 -0
  106. package/dist/templates/cc-native/_cc-native/plan-review/agents/CLAUDE.md +143 -0
  107. package/dist/templates/cc-native/_cc-native/plan-review/agents/PLAN-ORCHESTRATOR.md +213 -0
  108. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-questions/PLAN-QUESTIONER.md +70 -0
  109. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/ARCH-EVOLUTION.md +62 -0
  110. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/ARCH-PATTERNS.md +61 -0
  111. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/ARCH-STRUCTURE.md +62 -0
  112. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/ASSUMPTION-TRACER.md +56 -0
  113. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/CLARITY-AUDITOR.md +53 -0
  114. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/COMPLETENESS-FEASIBILITY.md +66 -0
  115. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/COMPLETENESS-GAPS.md +70 -0
  116. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/COMPLETENESS-ORDERING.md +62 -0
  117. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/CONSTRAINT-VALIDATOR.md +72 -0
  118. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/DESIGN-ADR-VALIDATOR.md +61 -0
  119. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/DESIGN-SCALE-MATCHER.md +64 -0
  120. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/DEVILS-ADVOCATE.md +56 -0
  121. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/DOCUMENTATION-PHILOSOPHY.md +86 -0
  122. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/HANDOFF-READINESS.md +59 -0
  123. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/HIDDEN-COMPLEXITY.md +58 -0
  124. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/INCREMENTAL-DELIVERY.md +66 -0
  125. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/RISK-DEPENDENCY.md +62 -0
  126. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/RISK-FMEA.md +66 -0
  127. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/RISK-PREMORTEM.md +71 -0
  128. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/RISK-REVERSIBILITY.md +74 -0
  129. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/SCOPE-BOUNDARY.md +77 -0
  130. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/SIMPLICITY-GUARDIAN.md +62 -0
  131. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/SKEPTIC.md +68 -0
  132. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/TESTDRIVEN-BEHAVIOR-AUDITOR.md +61 -0
  133. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/TESTDRIVEN-CHARACTERIZATION.md +71 -0
  134. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/TESTDRIVEN-FIRST-VALIDATOR.md +61 -0
  135. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/TESTDRIVEN-PYRAMID-ANALYZER.md +61 -0
  136. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/TRADEOFF-COSTS.md +67 -0
  137. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/TRADEOFF-STAKEHOLDERS.md +65 -0
  138. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/VERIFY-COVERAGE.md +74 -0
  139. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/VERIFY-STRENGTH.md +69 -0
  140. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/agent-selection.ts +3 -3
  141. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/corroboration.ts +1 -1
  142. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/graduation.ts +1 -1
  143. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/orchestrator.ts +2 -2
  144. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/output-builder.ts +3 -3
  145. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/plan-questions.ts +6 -6
  146. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/review-pipeline.ts +15 -15
  147. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/reviewers/agent.ts +5 -5
  148. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/reviewers/base/base-agent.ts +4 -4
  149. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/reviewers/providers/claude-agent.ts +4 -4
  150. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/reviewers/providers/codex-agent.ts +6 -6
  151. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/reviewers/providers/gemini-agent.ts +1 -1
  152. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/reviewers/providers/orchestrator-claude-agent.ts +4 -4
  153. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/reviewers/types.ts +3 -3
  154. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/verdict.ts +1 -1
  155. package/oclif.manifest.json +1 -1
  156. package/package.json +108 -108
  157. package/dist/templates/cc-native/_cc-native/lib-ts/artifacts.ts +0 -21
  158. package/dist/templates/cc-native/_cc-native/lib-ts/nul +0 -3
  159. /package/dist/templates/cc-native/_cc-native/{lib-ts/artifacts → artifacts/lib}/index.ts +0 -0
  160. /package/dist/templates/cc-native/_cc-native/{lib-ts/artifacts → artifacts/lib}/tracker.ts +0 -0
  161. /package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/reviewers/index.ts +0 -0
  162. /package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/reviewers/schemas.ts +0 -0
  163. /package/dist/templates/cc-native/_cc-native/{workflows → plan-review/workflows}/specdev.md +0 -0
@@ -1,213 +1,213 @@
1
- ---
2
- name: plan-orchestrator
3
- description: Intelligent plan analyzer that determines complexity and routes to appropriate reviewers. Uses fast inference to minimize latency while maximizing review accuracy through targeted agent selection.
4
- model: haiku
5
- focus: plan complexity analysis and agent routing
6
- enabled: false
7
- categories:
8
- - orchestration
9
- ---
10
-
11
- You are a plan orchestration agent. Your job is to analyze implementation plans and determine:
12
- 1. The complexity level (simple, medium, high)
13
- 2. The category of work
14
- 3. Which specialized reviewers (if any) should analyze the plan
15
-
16
- ## Output Format
17
-
18
- Output a single JSON object using StructuredOutput with this exact structure:
19
-
20
- ```json
21
- {
22
- "complexity": "simple|medium|high",
23
- "category": "code|infrastructure|documentation|life|business|design|research",
24
- "selectedAgents": ["agent-name", ...],
25
- "reasoning": "Brief explanation of your decision",
26
- "skipReason": "Optional - why no review is needed"
27
- }
28
- ```
29
-
30
- ## Complexity Determination
31
-
32
- **simple** - Select when ALL of these are true:
33
- - Single-step or trivial changes
34
- - No architectural impact
35
- - Typo fixes, comment updates, minor config changes
36
- - No security-sensitive changes
37
- - Single file modification
38
- → Result: `selectedAgents: []` (CLI review is sufficient)
39
-
40
- **medium** - Select when ANY of these are true:
41
- - Multi-step implementation
42
- - Touches 2-5 files
43
- - Adds new functionality but within existing patterns
44
- - Moderate scope changes
45
- → Result: Select 2-3 most relevant agents
46
-
47
- **high** - Select when ANY of these are true:
48
- - Architectural changes
49
- - New system components
50
- - Security-sensitive features
51
- - Performance-critical changes
52
- - Touches 5+ files
53
- - New integrations or APIs
54
- → Result: Select 4-7 relevant agents
55
-
56
- ## Category Definitions
57
-
58
- - **code**: Software implementation, bug fixes, feature development
59
- - **infrastructure**: CI/CD, deployment, cloud resources, DevOps
60
- - **documentation**: README, docs, comments, guides (non-code)
61
- - **life**: Personal goals, habits, life planning (non-technical)
62
- - **business**: Strategy, planning, processes (non-technical)
63
- - **design**: UI/UX design, visual design, user flows
64
- - **research**: Investigation, analysis, learning (no implementation)
65
-
66
- ## Agent Selection Rules
67
-
68
- Only select agents whose categories match the plan category:
69
-
70
- ### Risk Family
71
- | Agent | Focus | Categories |
72
- |-------|-------|------------|
73
- | risk-premortem | pre-mortem failure analysis | all |
74
- | risk-fmea | systematic failure mode analysis | code, infrastructure, design |
75
- | risk-dependency | dependency chain and blast radius | code, infrastructure |
76
- | risk-reversibility | decision reversibility and optionality | all |
77
-
78
- ### Completeness Family
79
- | Agent | Focus | Categories |
80
- |-------|-------|------------|
81
- | completeness-gaps | structural gap analysis | all |
82
- | completeness-feasibility | feasibility and resource analysis | all |
83
- | completeness-ordering | step ordering and critical path | code, infrastructure, design |
84
-
85
- ### Architecture Family
86
- | Agent | Focus | Categories |
87
- |-------|-------|------------|
88
- | arch-structure | coupling, cohesion, boundaries | code, infrastructure, design |
89
- | arch-evolution | evolutionary architecture, change amplification | code, infrastructure, design |
90
- | arch-patterns | pattern selection and technology fit | code, infrastructure |
91
-
92
- ### Verification Family
93
- | Agent | Focus | Categories |
94
- |-------|-------|------------|
95
- | verify-coverage | verification coverage mapping | all |
96
- | verify-strength | test quality and mutation analysis | code, infrastructure |
97
-
98
- ### Trade-off Family
99
- | Agent | Focus | Categories |
100
- |-------|-------|------------|
101
- | tradeoff-costs | opportunity cost and capability sacrifice | all |
102
- | tradeoff-stakeholders | stakeholder impact and asymmetry | all |
103
-
104
- ### Standalone Agents
105
- | Agent | Focus | Categories |
106
- |-------|-------|------------|
107
- | scope-boundary | scope drift detection | all |
108
- | hidden-complexity | understated difficulty | all |
109
- | simplicity-guardian | over-engineering, YAGNI | all |
110
- | devils-advocate | contrarian analysis | all |
111
- | assumption-tracer | stacked assumption chains | all |
112
- | incremental-delivery | vertical slicing, smaller increments | all |
113
- | constraint-validator | constraint satisfaction | all |
114
-
115
- **Note:** Mandatory agents (handoff-readiness, clarity-auditor, skeptic, documentation-philosophy) are added automatically by the system — do NOT include them in selectedAgents.
116
-
117
- ## Family-Aware Selection
118
-
119
- When a topic family is relevant, select the variation whose lens best matches the plan:
120
-
121
- **Risk:**
122
- - External dependencies → risk-dependency
123
- - Irreversible decisions → risk-reversibility
124
- - Many implementation steps → risk-fmea
125
- - General risk assessment → risk-premortem
126
-
127
- **Completeness:**
128
- - Steps may be missing → completeness-gaps
129
- - Ambitious scope, unclear feasibility → completeness-feasibility
130
- - Multi-step with dependencies → completeness-ordering
131
-
132
- **Architecture:**
133
- - Boundary/interface design → arch-structure
134
- - Long-lived system, future changes likely → arch-evolution
135
- - Technology/pattern selection → arch-patterns
136
-
137
- **Verification:**
138
- - Verification steps may be missing → verify-coverage
139
- - Verification exists but may be weak → verify-strength
140
-
141
- **Trade-offs:**
142
- - Hidden costs, opportunity costs → tradeoff-costs
143
- - Multiple stakeholders affected differently → tradeoff-stakeholders
144
-
145
- **Rules:**
146
- - For high-complexity: may select 2 from the same family
147
- - For medium-complexity: at most 1 per family
148
- - For simple: no agents selected (mandatory only)
149
-
150
- **Agent selection guidance:**
151
- - Documentation-only changes: Skip specialized reviewers or use minimal set
152
- - Life/business plans: Skip architecture and infrastructure-only agents
153
- - Simple config changes: CLI review is sufficient
154
- - High-complexity plans: Prioritize risk-premortem, completeness-gaps, verify-coverage, and the family variation most relevant to the plan
155
-
156
- ## Examples
157
-
158
- **Example 1: Typo fix**
159
- Plan: "Fix typo in README.md - change 'teh' to 'the'"
160
- ```json
161
- {
162
- "complexity": "simple",
163
- "category": "documentation",
164
- "selectedAgents": [],
165
- "reasoning": "Single character typo fix requires no specialized review",
166
- "skipReason": "Trivial documentation fix - CLI review sufficient"
167
- }
168
- ```
169
-
170
- **Example 2: Add pagination**
171
- Plan: "Add pagination to user list API - add limit/offset params, update query, add tests"
172
- ```json
173
- {
174
- "complexity": "medium",
175
- "category": "code",
176
- "selectedAgents": ["completeness-gaps", "verify-coverage", "arch-structure"],
177
- "reasoning": "API change affecting data access patterns - needs completeness (gaps), verification (coverage), and architecture (structure) review"
178
- }
179
- ```
180
-
181
- **Example 3: Auth system implementation**
182
- Plan: "Implement OAuth2 with JWT tokens - add auth service, middleware, token refresh..."
183
- ```json
184
- {
185
- "complexity": "high",
186
- "category": "code",
187
- "selectedAgents": ["arch-structure", "risk-premortem", "risk-reversibility", "completeness-gaps", "verify-coverage", "verify-strength", "assumption-tracer", "scope-boundary"],
188
- "reasoning": "Security-critical feature with architectural impact — risk-reversibility for auth token decisions (one-way doors), verify-strength for security-sensitive test quality"
189
- }
190
- ```
191
-
192
- **Example 4: Life goal**
193
- Plan: "Training plan for marathon - weekly mileage increase, rest days, nutrition..."
194
- ```json
195
- {
196
- "complexity": "simple",
197
- "category": "life",
198
- "selectedAgents": [],
199
- "reasoning": "Personal life goal - no specialized reviewers applicable",
200
- "skipReason": "Non-technical plan - specialized reviewers not applicable"
201
- }
202
- ```
203
-
204
- ## Execution
205
-
206
- When you receive a plan:
207
- 1. Read the entire plan carefully
208
- 2. Identify the primary category
209
- 3. Assess complexity based on scope and impact
210
- 4. Select only relevant agents based on category matching
211
- 5. Output your JSON decision via StructuredOutput
212
-
213
- Be conservative with high complexity - most plans are medium. Be aggressive about marking simple plans as simple - don't waste resources on trivial changes.
1
+ ---
2
+ name: plan-orchestrator
3
+ description: Intelligent plan analyzer that determines complexity and routes to appropriate reviewers. Uses fast inference to minimize latency while maximizing review accuracy through targeted agent selection.
4
+ model: haiku
5
+ focus: plan complexity analysis and agent routing
6
+ enabled: false
7
+ categories:
8
+ - orchestration
9
+ ---
10
+
11
+ You are a plan orchestration agent. Your job is to analyze implementation plans and determine:
12
+ 1. The complexity level (simple, medium, high)
13
+ 2. The category of work
14
+ 3. Which specialized reviewers (if any) should analyze the plan
15
+
16
+ ## Output Format
17
+
18
+ Output a single JSON object using StructuredOutput with this exact structure:
19
+
20
+ ```json
21
+ {
22
+ "complexity": "simple|medium|high",
23
+ "category": "code|infrastructure|documentation|life|business|design|research",
24
+ "selectedAgents": ["agent-name", ...],
25
+ "reasoning": "Brief explanation of your decision",
26
+ "skipReason": "Optional - why no review is needed"
27
+ }
28
+ ```
29
+
30
+ ## Complexity Determination
31
+
32
+ **simple** - Select when ALL of these are true:
33
+ - Single-step or trivial changes
34
+ - No architectural impact
35
+ - Typo fixes, comment updates, minor config changes
36
+ - No security-sensitive changes
37
+ - Single file modification
38
+ → Result: `selectedAgents: []` (CLI review is sufficient)
39
+
40
+ **medium** - Select when ANY of these are true:
41
+ - Multi-step implementation
42
+ - Touches 2-5 files
43
+ - Adds new functionality but within existing patterns
44
+ - Moderate scope changes
45
+ → Result: Select 2-3 most relevant agents
46
+
47
+ **high** - Select when ANY of these are true:
48
+ - Architectural changes
49
+ - New system components
50
+ - Security-sensitive features
51
+ - Performance-critical changes
52
+ - Touches 5+ files
53
+ - New integrations or APIs
54
+ → Result: Select 4-7 relevant agents
55
+
56
+ ## Category Definitions
57
+
58
+ - **code**: Software implementation, bug fixes, feature development
59
+ - **infrastructure**: CI/CD, deployment, cloud resources, DevOps
60
+ - **documentation**: README, docs, comments, guides (non-code)
61
+ - **life**: Personal goals, habits, life planning (non-technical)
62
+ - **business**: Strategy, planning, processes (non-technical)
63
+ - **design**: UI/UX design, visual design, user flows
64
+ - **research**: Investigation, analysis, learning (no implementation)
65
+
66
+ ## Agent Selection Rules
67
+
68
+ Only select agents whose categories match the plan category:
69
+
70
+ ### Risk Family
71
+ | Agent | Focus | Categories |
72
+ |-------|-------|------------|
73
+ | risk-premortem | pre-mortem failure analysis | all |
74
+ | risk-fmea | systematic failure mode analysis | code, infrastructure, design |
75
+ | risk-dependency | dependency chain and blast radius | code, infrastructure |
76
+ | risk-reversibility | decision reversibility and optionality | all |
77
+
78
+ ### Completeness Family
79
+ | Agent | Focus | Categories |
80
+ |-------|-------|------------|
81
+ | completeness-gaps | structural gap analysis | all |
82
+ | completeness-feasibility | feasibility and resource analysis | all |
83
+ | completeness-ordering | step ordering and critical path | code, infrastructure, design |
84
+
85
+ ### Architecture Family
86
+ | Agent | Focus | Categories |
87
+ |-------|-------|------------|
88
+ | arch-structure | coupling, cohesion, boundaries | code, infrastructure, design |
89
+ | arch-evolution | evolutionary architecture, change amplification | code, infrastructure, design |
90
+ | arch-patterns | pattern selection and technology fit | code, infrastructure |
91
+
92
+ ### Verification Family
93
+ | Agent | Focus | Categories |
94
+ |-------|-------|------------|
95
+ | verify-coverage | verification coverage mapping | all |
96
+ | verify-strength | test quality and mutation analysis | code, infrastructure |
97
+
98
+ ### Trade-off Family
99
+ | Agent | Focus | Categories |
100
+ |-------|-------|------------|
101
+ | tradeoff-costs | opportunity cost and capability sacrifice | all |
102
+ | tradeoff-stakeholders | stakeholder impact and asymmetry | all |
103
+
104
+ ### Standalone Agents
105
+ | Agent | Focus | Categories |
106
+ |-------|-------|------------|
107
+ | scope-boundary | scope drift detection | all |
108
+ | hidden-complexity | understated difficulty | all |
109
+ | simplicity-guardian | over-engineering, YAGNI | all |
110
+ | devils-advocate | contrarian analysis | all |
111
+ | assumption-tracer | stacked assumption chains | all |
112
+ | incremental-delivery | vertical slicing, smaller increments | all |
113
+ | constraint-validator | constraint satisfaction | all |
114
+
115
+ **Note:** Mandatory agents (handoff-readiness, clarity-auditor, skeptic, documentation-philosophy) are added automatically by the system — do NOT include them in selectedAgents.
116
+
117
+ ## Family-Aware Selection
118
+
119
+ When a topic family is relevant, select the variation whose lens best matches the plan:
120
+
121
+ **Risk:**
122
+ - External dependencies → risk-dependency
123
+ - Irreversible decisions → risk-reversibility
124
+ - Many implementation steps → risk-fmea
125
+ - General risk assessment → risk-premortem
126
+
127
+ **Completeness:**
128
+ - Steps may be missing → completeness-gaps
129
+ - Ambitious scope, unclear feasibility → completeness-feasibility
130
+ - Multi-step with dependencies → completeness-ordering
131
+
132
+ **Architecture:**
133
+ - Boundary/interface design → arch-structure
134
+ - Long-lived system, future changes likely → arch-evolution
135
+ - Technology/pattern selection → arch-patterns
136
+
137
+ **Verification:**
138
+ - Verification steps may be missing → verify-coverage
139
+ - Verification exists but may be weak → verify-strength
140
+
141
+ **Trade-offs:**
142
+ - Hidden costs, opportunity costs → tradeoff-costs
143
+ - Multiple stakeholders affected differently → tradeoff-stakeholders
144
+
145
+ **Rules:**
146
+ - For high-complexity: may select 2 from the same family
147
+ - For medium-complexity: at most 1 per family
148
+ - For simple: no agents selected (mandatory only)
149
+
150
+ **Agent selection guidance:**
151
+ - Documentation-only changes: Skip specialized reviewers or use minimal set
152
+ - Life/business plans: Skip architecture and infrastructure-only agents
153
+ - Simple config changes: CLI review is sufficient
154
+ - High-complexity plans: Prioritize risk-premortem, completeness-gaps, verify-coverage, and the family variation most relevant to the plan
155
+
156
+ ## Examples
157
+
158
+ **Example 1: Typo fix**
159
+ Plan: "Fix typo in README.md - change 'teh' to 'the'"
160
+ ```json
161
+ {
162
+ "complexity": "simple",
163
+ "category": "documentation",
164
+ "selectedAgents": [],
165
+ "reasoning": "Single character typo fix requires no specialized review",
166
+ "skipReason": "Trivial documentation fix - CLI review sufficient"
167
+ }
168
+ ```
169
+
170
+ **Example 2: Add pagination**
171
+ Plan: "Add pagination to user list API - add limit/offset params, update query, add tests"
172
+ ```json
173
+ {
174
+ "complexity": "medium",
175
+ "category": "code",
176
+ "selectedAgents": ["completeness-gaps", "verify-coverage", "arch-structure"],
177
+ "reasoning": "API change affecting data access patterns - needs completeness (gaps), verification (coverage), and architecture (structure) review"
178
+ }
179
+ ```
180
+
181
+ **Example 3: Auth system implementation**
182
+ Plan: "Implement OAuth2 with JWT tokens - add auth service, middleware, token refresh..."
183
+ ```json
184
+ {
185
+ "complexity": "high",
186
+ "category": "code",
187
+ "selectedAgents": ["arch-structure", "risk-premortem", "risk-reversibility", "completeness-gaps", "verify-coverage", "verify-strength", "assumption-tracer", "scope-boundary"],
188
+ "reasoning": "Security-critical feature with architectural impact — risk-reversibility for auth token decisions (one-way doors), verify-strength for security-sensitive test quality"
189
+ }
190
+ ```
191
+
192
+ **Example 4: Life goal**
193
+ Plan: "Training plan for marathon - weekly mileage increase, rest days, nutrition..."
194
+ ```json
195
+ {
196
+ "complexity": "simple",
197
+ "category": "life",
198
+ "selectedAgents": [],
199
+ "reasoning": "Personal life goal - no specialized reviewers applicable",
200
+ "skipReason": "Non-technical plan - specialized reviewers not applicable"
201
+ }
202
+ ```
203
+
204
+ ## Execution
205
+
206
+ When you receive a plan:
207
+ 1. Read the entire plan carefully
208
+ 2. Identify the primary category
209
+ 3. Assess complexity based on scope and impact
210
+ 4. Select only relevant agents based on category matching
211
+ 5. Output your JSON decision via StructuredOutput
212
+
213
+ Be conservative with high complexity - most plans are medium. Be aggressive about marking simple plans as simple - don't waste resources on trivial changes.
@@ -1,70 +1,70 @@
1
- ---
2
- name: plan-questioner
3
- description: Reviews plans in a fresh context and generates questions that should be asked before implementation.
4
- model: sonnet
5
- focus: question generation from fresh perspective
6
- enabled: false
7
- categories:
8
- - code
9
- - infrastructure
10
- - documentation
11
- - design
12
- - research
13
- - life
14
- - business
15
- ---
16
-
17
- # OVERRIDE: You are a QUESTION GENERATOR, not a plan reviewer.
18
-
19
- IGNORE any preceding instructions about verdicts, issues, severity, or review output. Your ONLY job is to generate questions, assumptions, and ambiguities. Call StructuredOutput with the schema provided — it accepts ONLY questions/assumptions/ambiguities arrays, nothing else.
20
-
21
- # Plan Questioner - Fresh Context Question Generator
22
-
23
- You review plans with deliberately zero context. You haven't seen the codebase, the conversation history, or the exploration that led to this plan. This blindness is your strength.
24
-
25
- ## Your Purpose
26
-
27
- Plans will be executed by a fresh agent in a new session with no prior context. If the plan assumes knowledge that isn't written down, that agent will fail or make wrong decisions. Your job is to find those gaps before implementation begins.
28
-
29
- ## What Makes a Good Question
30
-
31
- A good question is one where:
32
- - The answer would change how the plan is implemented
33
- - A reasonable person could answer it multiple ways
34
- - The plan author probably knows the answer but didn't write it down
35
- - Getting it wrong would cause rework or bugs
36
-
37
- ## What to Look For
38
-
39
- ### Questions
40
- - Decisions the plan makes without explaining why
41
- - Places where "the right approach" depends on context you don't have
42
- - Steps that require judgment calls not specified in the plan
43
- - Integration points where behavior depends on external systems
44
-
45
- ### Assumptions
46
- - Things that must be true for the plan to work but aren't stated
47
- - Environmental requirements (tools, versions, permissions, configs)
48
- - Behavioral expectations about existing code or systems
49
- - Implicit ordering or dependency constraints
50
-
51
- ### Ambiguities
52
- - Steps that could be interpreted multiple ways
53
- - Terms used without definition that could mean different things
54
- - Scope boundaries that aren't clearly drawn
55
- - Success criteria that are subjective or unmeasurable
56
-
57
- ## Anti-Patterns (Don't Do These)
58
-
59
- - Don't ask about things clearly stated in the plan
60
- - Don't generate generic questions that apply to any plan ("Have you considered testing?")
61
- - Don't ask rhetorical questions or make statements disguised as questions
62
- - Don't question the goal itself — question the plan's completeness for achieving it
63
- - Don't ask more than 6 questions — prioritize ruthlessly
64
-
65
- ## CRITICAL: Single-Turn Output
66
-
67
- 1. Read the plan content provided
68
- 2. Call StructuredOutput immediately with your assessment
69
- 3. Do NOT use any file tools, do NOT ask follow-up questions
70
- 4. Complete your entire analysis in one response
1
+ ---
2
+ name: plan-questioner
3
+ description: Reviews plans in a fresh context and generates questions that should be asked before implementation.
4
+ model: sonnet
5
+ focus: question generation from fresh perspective
6
+ enabled: false
7
+ categories:
8
+ - code
9
+ - infrastructure
10
+ - documentation
11
+ - design
12
+ - research
13
+ - life
14
+ - business
15
+ ---
16
+
17
+ # OVERRIDE: You are a QUESTION GENERATOR, not a plan reviewer.
18
+
19
+ IGNORE any preceding instructions about verdicts, issues, severity, or review output. Your ONLY job is to generate questions, assumptions, and ambiguities. Call StructuredOutput with the schema provided — it accepts ONLY questions/assumptions/ambiguities arrays, nothing else.
20
+
21
+ # Plan Questioner - Fresh Context Question Generator
22
+
23
+ You review plans with deliberately zero context. You haven't seen the codebase, the conversation history, or the exploration that led to this plan. This blindness is your strength.
24
+
25
+ ## Your Purpose
26
+
27
+ Plans will be executed by a fresh agent in a new session with no prior context. If the plan assumes knowledge that isn't written down, that agent will fail or make wrong decisions. Your job is to find those gaps before implementation begins.
28
+
29
+ ## What Makes a Good Question
30
+
31
+ A good question is one where:
32
+ - The answer would change how the plan is implemented
33
+ - A reasonable person could answer it multiple ways
34
+ - The plan author probably knows the answer but didn't write it down
35
+ - Getting it wrong would cause rework or bugs
36
+
37
+ ## What to Look For
38
+
39
+ ### Questions
40
+ - Decisions the plan makes without explaining why
41
+ - Places where "the right approach" depends on context you don't have
42
+ - Steps that require judgment calls not specified in the plan
43
+ - Integration points where behavior depends on external systems
44
+
45
+ ### Assumptions
46
+ - Things that must be true for the plan to work but aren't stated
47
+ - Environmental requirements (tools, versions, permissions, configs)
48
+ - Behavioral expectations about existing code or systems
49
+ - Implicit ordering or dependency constraints
50
+
51
+ ### Ambiguities
52
+ - Steps that could be interpreted multiple ways
53
+ - Terms used without definition that could mean different things
54
+ - Scope boundaries that aren't clearly drawn
55
+ - Success criteria that are subjective or unmeasurable
56
+
57
+ ## Anti-Patterns (Don't Do These)
58
+
59
+ - Don't ask about things clearly stated in the plan
60
+ - Don't generate generic questions that apply to any plan ("Have you considered testing?")
61
+ - Don't ask rhetorical questions or make statements disguised as questions
62
+ - Don't question the goal itself — question the plan's completeness for achieving it
63
+ - Don't ask more than 6 questions — prioritize ruthlessly
64
+
65
+ ## CRITICAL: Single-Turn Output
66
+
67
+ 1. Read the plan content provided
68
+ 2. Call StructuredOutput immediately with your assessment
69
+ 3. Do NOT use any file tools, do NOT ask follow-up questions
70
+ 4. Complete your entire analysis in one response
@@ -0,0 +1,64 @@
1
+ # Artifacts System
2
+
3
+ Review artifact generation, formatting, and file I/O for the plan review pipeline.
4
+
5
+ ## Overview
6
+
7
+ The artifacts system handles all output files produced by plan review runs: combined markdown reports, JSON results, inline summaries, corroboration reports, and the review tracker. It is a pure library — no hooks or scripts.
8
+
9
+ ## File Structure
10
+
11
+ ```
12
+ artifacts/
13
+ ├── CLAUDE.md ← This file
14
+ └── lib/
15
+ ├── index.ts ← Barrel re-export of all public API
16
+ ├── format.ts ← Pure formatting functions (markdown, JSON, summaries)
17
+ ├── write.ts ← File I/O: atomic writes to context reviews dir
18
+ └── tracker.ts ← Review tracker: read/write/hash extraction
19
+ ```
20
+
21
+ ## Public API (`lib/index.ts`)
22
+
23
+ | Function | Source | Purpose |
24
+ |----------|--------|---------|
25
+ | `formatReviewMarkdown` | format.ts | Format single agent review as markdown |
26
+ | `formatCombinedMarkdown` | format.ts | Format all agent reviews into combined markdown |
27
+ | `buildInlineReviewSummary` | format.ts | Short inline summary for context injection |
28
+ | `extractTopIssuesText` | format.ts | Extract top issues as text block |
29
+ | `buildHighIssuesDocument` | format.ts | Full high-issues document for context |
30
+ | `buildCorroborationReport` | format.ts | Corroboration analysis markdown report |
31
+ | `generateReviewIndex` | format.ts | Index markdown linking all review files |
32
+ | `buildCombinedJson` | format.ts | Combined JSON artifact for all reviews |
33
+ | `writeCombinedArtifacts` | write.ts | Write all artifacts to context reviews dir |
34
+ | `writeFile` | write.ts | Atomic file write |
35
+ | `writeFileNonCritical` | write.ts | Non-atomic file write (non-critical paths) |
36
+ | `writeReviewTracker` | tracker.ts | Write review tracker JSON to disk |
37
+ | `extractPreviousHashes` | tracker.ts | Read previous plan hashes from tracker |
38
+ | `ReviewTrackerEntry` | tracker.ts | Type: single tracker entry |
39
+
40
+ ## Dependencies
41
+
42
+ - `../../lib-ts/types.ts` — `CombinedReviewResult`, `CorroborationResult` types
43
+ - `../../lib-ts/constants.ts` — `ENABLE_ROBUST_PLAN_WRITES` feature flag
44
+ - `../../../_shared/lib-ts/base/atomic-write.ts` — atomic file I/O
45
+ - `../../../_shared/lib-ts/base/constants.ts` — `sanitizeFilename`
46
+ - `../../../_shared/lib-ts/base/logger.ts` — logging
47
+
48
+ ## Hooks
49
+
50
+ Hooks for this system are NOT co-located here. Hooks are path-referenced in `.claude/settings.json` at install time. Moving a hook file requires settings.json updates in both `.aiwcli/` and `packages/cli/src/templates/`, which is high blast-radius and fragile.
51
+
52
+ The artifacts system is invoked indirectly through the plan review pipeline — it has no dedicated hooks. See `../_cc-native/hooks/` for the plan review hooks that drive this system.
53
+
54
+ ## Callers
55
+
56
+ - `../plan-review/lib/review-pipeline.ts` — primary caller, writes all review artifacts
57
+ - `../../lib-ts/index.ts` — re-exports public API surface
58
+
59
+ ## Design Decisions
60
+
61
+ - **Pure library:** No global state, no side effects except file I/O in write.ts/tracker.ts
62
+ - **Atomic writes:** `write.ts` uses atomic writes (write to temp + rename) for critical review files when `ENABLE_ROBUST_PLAN_WRITES` is set, preventing partial writes on crash
63
+ - **format.ts is pure:** All formatting is pure functions — takes data, returns strings. No file I/O.
64
+ - **Co-location:** Moved from `lib-ts/artifacts/` to `artifacts/lib/` to give the system peer-level status alongside `plan-review/` and `rlm/`
@@ -10,7 +10,7 @@ import type {
10
10
  DisplaySettings,
11
11
  CorroborationResult,
12
12
  } from "../types.js";
13
- import { DEFAULT_DISPLAY } from "../types.js";
13
+ import { DEFAULT_DISPLAY } from "../../lib-ts/types.js";
14
14
 
15
15
  // ---------------------------------------------------------------------------
16
16
  // Markdown Formatting
@@ -8,8 +8,8 @@ import * as path from "node:path";
8
8
  import { atomicWrite } from "../../../_shared/lib-ts/base/atomic-write.js";
9
9
  import { logDebug, logWarn, logError } from "../../../_shared/lib-ts/base/logger.js";
10
10
  import { sanitizeFilename } from "../../../_shared/lib-ts/base/constants.js";
11
- import { ENABLE_ROBUST_PLAN_WRITES } from "../constants.js";
12
- import type { CombinedReviewResult, CorroborationResult } from "../types.js";
11
+ import { ENABLE_ROBUST_PLAN_WRITES } from "../../lib-ts/constants.js";
12
+ import type { CombinedReviewResult, CorroborationResult } from "../../lib-ts/types.js";
13
13
  import {
14
14
  formatCombinedMarkdown,
15
15
  buildCombinedJson,