ocmm 0.5.4 → 0.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.codex/agents/dw-builder.toml +1 -1
- package/.codex/agents/dw-clarifier.toml +1 -1
- package/.codex/agents/dw-code-search.toml +1 -1
- package/.codex/agents/dw-coding.toml +1 -1
- package/.codex/agents/dw-complex.toml +1 -1
- package/.codex/agents/dw-creative.toml +1 -1
- package/.codex/agents/dw-deep.toml +1 -1
- package/.codex/agents/dw-doc-search.toml +1 -1
- package/.codex/agents/dw-documenting.toml +1 -1
- package/.codex/agents/dw-explore.toml +1 -1
- package/.codex/agents/dw-frontend.toml +1 -1
- package/.codex/agents/dw-hard-reasoning.toml +1 -1
- package/.codex/agents/dw-media-reader.toml +1 -1
- package/.codex/agents/dw-normal-task.toml +1 -1
- package/.codex/agents/dw-oracle-2nd.toml +8 -0
- package/.codex/agents/dw-oracle.toml +1 -1
- package/.codex/agents/dw-orchestrator.toml +1 -1
- package/.codex/agents/dw-plan-critic.toml +1 -1
- package/.codex/agents/dw-planner.toml +1 -1
- package/.codex/agents/dw-quick.toml +1 -1
- package/.codex/agents/dw-research.toml +1 -1
- package/.codex/agents/dw-reviewer.toml +1 -1
- package/README.md +158 -13
- package/dist/cli/shim.d.ts +4 -2
- package/dist/cli/shim.js +26 -11
- package/dist/cli/shim.js.map +1 -1
- package/dist/codex/plugin-generator.js +82 -56
- package/dist/codex/plugin-generator.js.map +1 -1
- package/dist/config/load.d.ts +32 -23
- package/dist/config/load.js +384 -90
- package/dist/config/load.js.map +1 -1
- package/dist/config/merge.d.ts +18 -0
- package/dist/config/merge.js +46 -0
- package/dist/config/merge.js.map +1 -0
- package/dist/config/normalize.d.ts +1 -0
- package/dist/config/normalize.js +22 -16
- package/dist/config/normalize.js.map +1 -1
- package/dist/config/profile-aliases.d.ts +12 -0
- package/dist/config/profile-aliases.js +127 -0
- package/dist/config/profile-aliases.js.map +1 -0
- package/dist/config/profile-types.d.ts +13 -0
- package/dist/config/profile-types.js +2 -0
- package/dist/config/profile-types.js.map +1 -0
- package/dist/config/review-agent-migration.d.ts +89 -0
- package/dist/config/review-agent-migration.js +237 -0
- package/dist/config/review-agent-migration.js.map +1 -0
- package/dist/config/schema.d.ts +1364 -222
- package/dist/config/schema.js +169 -37
- package/dist/config/schema.js.map +1 -1
- package/dist/config/tolerant-parse.d.ts +41 -0
- package/dist/config/tolerant-parse.js +164 -0
- package/dist/config/tolerant-parse.js.map +1 -0
- package/dist/data/agents.d.ts +1 -1
- package/dist/data/agents.js +7 -7
- package/dist/data/agents.js.map +1 -1
- package/dist/hooks/chat-params.d.ts +2 -0
- package/dist/hooks/chat-params.js +113 -4
- package/dist/hooks/chat-params.js.map +1 -1
- package/dist/hooks/config.d.ts +14 -2
- package/dist/hooks/config.js +538 -60
- package/dist/hooks/config.js.map +1 -1
- package/dist/hooks/event.d.ts +3 -11
- package/dist/hooks/event.js +5 -9
- package/dist/hooks/event.js.map +1 -1
- package/dist/index.js +21 -14
- package/dist/index.js.map +1 -1
- package/dist/permissions/index.d.ts +3 -0
- package/dist/permissions/index.js +43 -28
- package/dist/permissions/index.js.map +1 -1
- package/dist/review-agents/expand.d.ts +36 -0
- package/dist/review-agents/expand.js +157 -0
- package/dist/review-agents/expand.js.map +1 -0
- package/dist/review-agents/names.d.ts +16 -0
- package/dist/review-agents/names.js +55 -0
- package/dist/review-agents/names.js.map +1 -0
- package/dist/routing/effective-route.d.ts +19 -0
- package/dist/routing/effective-route.js +133 -0
- package/dist/routing/effective-route.js.map +1 -0
- package/dist/routing/model-upgrades.d.ts +5 -0
- package/dist/routing/model-upgrades.js +59 -12
- package/dist/routing/model-upgrades.js.map +1 -1
- package/dist/routing/resolver.d.ts +8 -1
- package/dist/routing/resolver.js +29 -9
- package/dist/routing/resolver.js.map +1 -1
- package/dist/routing/route-registry.d.ts +13 -0
- package/dist/routing/route-registry.js +84 -0
- package/dist/routing/route-registry.js.map +1 -0
- package/dist/runtime-fallback/dispatcher.d.ts +1 -0
- package/dist/runtime-fallback/dispatcher.js +7 -5
- package/dist/runtime-fallback/dispatcher.js.map +1 -1
- package/dist/runtime-fallback/error-classifier.d.ts +3 -1
- package/dist/runtime-fallback/error-classifier.js +135 -1
- package/dist/runtime-fallback/error-classifier.js.map +1 -1
- package/dist/runtime-fallback/event-handler-generic-fallback.d.ts +26 -0
- package/dist/runtime-fallback/event-handler-generic-fallback.js +54 -0
- package/dist/runtime-fallback/event-handler-generic-fallback.js.map +1 -0
- package/dist/runtime-fallback/event-handler-idle-continuation.d.ts +9 -0
- package/dist/runtime-fallback/event-handler-idle-continuation.js +48 -0
- package/dist/runtime-fallback/event-handler-idle-continuation.js.map +1 -0
- package/dist/runtime-fallback/event-handler-support.d.ts +39 -0
- package/dist/runtime-fallback/event-handler-support.js +194 -0
- package/dist/runtime-fallback/event-handler-support.js.map +1 -0
- package/dist/runtime-fallback/event-handler-test-fixtures.d.ts +874 -0
- package/dist/runtime-fallback/event-handler-test-fixtures.js +150 -0
- package/dist/runtime-fallback/event-handler-test-fixtures.js.map +1 -0
- package/dist/runtime-fallback/event-handler.d.ts +13 -1
- package/dist/runtime-fallback/event-handler.js +334 -192
- package/dist/runtime-fallback/event-handler.js.map +1 -1
- package/dist/runtime-fallback/fallback-state.d.ts +8 -5
- package/dist/runtime-fallback/fallback-state.js +9 -6
- package/dist/runtime-fallback/fallback-state.js.map +1 -1
- package/dist/runtime-fallback/index.d.ts +21 -1
- package/dist/runtime-fallback/index.js +7 -1
- package/dist/runtime-fallback/index.js.map +1 -1
- package/dist/runtime-fallback/interruption-output-adapter.d.ts +7 -0
- package/dist/runtime-fallback/interruption-output-adapter.js +91 -0
- package/dist/runtime-fallback/interruption-output-adapter.js.map +1 -0
- package/dist/runtime-fallback/subagent-429-controller-fixture.d.ts +105 -0
- package/dist/runtime-fallback/subagent-429-controller-fixture.js +116 -0
- package/dist/runtime-fallback/subagent-429-controller-fixture.js.map +1 -0
- package/dist/runtime-fallback/subagent-429-controller.d.ts +167 -0
- package/dist/runtime-fallback/subagent-429-controller.js +334 -0
- package/dist/runtime-fallback/subagent-429-controller.js.map +1 -0
- package/dist/runtime-fallback/subagent-429-policy.d.ts +13 -0
- package/dist/runtime-fallback/subagent-429-policy.js +37 -0
- package/dist/runtime-fallback/subagent-429-policy.js.map +1 -0
- package/dist/runtime-fallback/subagent-429-session.d.ts +48 -0
- package/dist/runtime-fallback/subagent-429-session.js +316 -0
- package/dist/runtime-fallback/subagent-429-session.js.map +1 -0
- package/dist/shared/opencode-events.d.ts +22 -0
- package/dist/shared/opencode-events.js +75 -0
- package/dist/shared/opencode-events.js.map +1 -0
- package/dist/shared/types.d.ts +12 -1
- package/package.json +1 -1
- package/plugins/deepwork/.codex-plugin/plugin.json +1 -1
- package/plugins/deepwork/README.md +2 -1
- package/plugins/deepwork/agents/dw-builder.toml +1 -1
- package/plugins/deepwork/agents/dw-clarifier.toml +1 -1
- package/plugins/deepwork/agents/dw-code-search.toml +1 -1
- package/plugins/deepwork/agents/dw-coding.toml +1 -1
- package/plugins/deepwork/agents/dw-complex.toml +1 -1
- package/plugins/deepwork/agents/dw-creative.toml +1 -1
- package/plugins/deepwork/agents/dw-deep.toml +1 -1
- package/plugins/deepwork/agents/dw-doc-search.toml +1 -1
- package/plugins/deepwork/agents/dw-documenting.toml +1 -1
- package/plugins/deepwork/agents/dw-explore.toml +1 -1
- package/plugins/deepwork/agents/dw-frontend.toml +1 -1
- package/plugins/deepwork/agents/dw-hard-reasoning.toml +1 -1
- package/plugins/deepwork/agents/dw-media-reader.toml +1 -1
- package/plugins/deepwork/agents/dw-normal-task.toml +1 -1
- package/plugins/deepwork/agents/dw-oracle-2nd.toml +8 -0
- package/plugins/deepwork/agents/dw-oracle.toml +1 -1
- package/plugins/deepwork/agents/dw-orchestrator.toml +1 -1
- package/plugins/deepwork/agents/dw-plan-critic.toml +1 -1
- package/plugins/deepwork/agents/dw-planner.toml +1 -1
- package/plugins/deepwork/agents/dw-quick.toml +1 -1
- package/plugins/deepwork/agents/dw-research.toml +1 -1
- package/plugins/deepwork/agents/dw-reviewer.toml +1 -1
- package/plugins/deepwork/dist/cli/shim.d.ts +4 -2
- package/plugins/deepwork/dist/cli/shim.js +26 -11
- package/plugins/deepwork/dist/cli/shim.js.map +1 -1
- package/plugins/deepwork/dist/shared/opencode-events.d.ts +22 -0
- package/plugins/deepwork/dist/shared/opencode-events.js +75 -0
- package/plugins/deepwork/dist/shared/opencode-events.js.map +1 -0
- package/plugins/deepwork/dist/shared/types.d.ts +12 -1
- package/plugins/deepwork/package.json +1 -1
- package/plugins/deepwork/skills/deepwork/SKILL.md +30 -14
- package/plugins/deepwork/skills/deepwork-requesting-code-review/SKILL.md +53 -31
- package/plugins/deepwork/skills/deepwork-requesting-code-review/code-reviewer.md +11 -7
- package/plugins/deepwork/skills/deepwork-subagent-driven-development/SKILL.md +28 -19
- package/plugins/deepwork/skills/deepwork-subagent-driven-development/implementer-prompt.md +10 -3
- package/prompts/codex/agents/clarifier.md +4 -0
- package/prompts/codex/agents/orchestrator.md +12 -2
- package/prompts/codex/agents/plan-critic.md +4 -0
- package/prompts/codex/agents/planner.md +15 -10
- package/prompts/codex/agents/reviewer.md +8 -2
- package/prompts/codex/deepwork/gpt-5.6.md +20 -37
- package/prompts/omo/agents/clarifier.md +4 -0
- package/prompts/omo/agents/orchestrator.md +11 -0
- package/prompts/omo/agents/plan-critic.md +4 -0
- package/prompts/omo/agents/planner.md +15 -3
- package/prompts/omo/agents/reviewer.md +8 -2
- package/prompts/omo/deepwork/gpt-5.6.md +20 -37
- package/prompts/v1/agents/clarifier.md +4 -0
- package/prompts/v1/agents/orchestrator.md +12 -2
- package/prompts/v1/agents/plan-critic.md +4 -0
- package/prompts/v1/agents/planner.md +15 -10
- package/prompts/v1/agents/reviewer.md +8 -2
- package/prompts/v1/deepwork/gpt-5.6.md +20 -37
- package/skills/v1/requesting-code-review/SKILL.md +53 -31
- package/skills/v1/requesting-code-review/code-reviewer.md +11 -7
- package/skills/v1/subagent-driven-development/SKILL.md +28 -19
- package/skills/v1/subagent-driven-development/implementer-prompt.md +10 -3
- package/.codex/agents/dw-oracle-high.toml +0 -8
- package/plugins/deepwork/agents/dw-oracle-high.toml +0 -8
|
@@ -30,8 +30,7 @@ When a Deepwork role maps to a generated agent, use the exact Codex agent type w
|
|
|
30
30
|
|
|
31
31
|
- Plan review: `[@dw-plan-critic](subagent://dw-plan-critic)` or `multi_agent_v1.spawn_agent(agent_type="dw-plan-critic", fork_context=false, message="Review the plan at <path>.")`
|
|
32
32
|
- Code/work review: `[@dw-reviewer](subagent://dw-reviewer)` or `multi_agent_v1.spawn_agent(agent_type="dw-reviewer", fork_context=false, message="<bounded review task>")`
|
|
33
|
-
-
|
|
34
|
-
- Optional supplemental high-effort review: `[@dw-oracle-high](subagent://dw-oracle-high)` or `multi_agent_v1.spawn_agent(agent_type="dw-oracle-high", fork_context=false, message="<supplemental high-effort review task>")` — only when explicitly configured by user/profile, available in the current catalog/dispatch surface, and not disabled
|
|
33
|
+
- Ordered Oracle review: `[@dw-oracle](subagent://dw-oracle)` first, then `[@dw-oracle-2nd](subagent://dw-oracle-2nd)` through configured later slots only when additional independent evidence is explicitly needed.
|
|
35
34
|
|
|
36
35
|
When Codex exposes MultiAgentV2 flat tools, map Deepwork delegation to the available flat tool names instead of forcing V1 syntax: use `spawn_agent` to create a bounded agent, `wait_agent` to wait for completion, `followup_task` to continue an existing agent, `interrupt_agent` to stop a runaway agent, and `fork_turns` only for explicit branch-style exploration. If those names are not callable in the current thread, fall back to the route order below.
|
|
37
36
|
|
|
@@ -80,7 +79,7 @@ If an exact `dw-*` invocation returns `unknown agent_type`, continue at route 2
|
|
|
80
79
|
| dw-media-reader | high | media-reader |
|
|
81
80
|
| dw-normal-task | high | normal-task |
|
|
82
81
|
| dw-oracle | xhigh | oracle |
|
|
83
|
-
| dw-oracle-
|
|
82
|
+
| dw-oracle-2nd | xhigh | oracle-2nd |
|
|
84
83
|
| dw-orchestrator | high | orchestrator |
|
|
85
84
|
| dw-plan-critic | xhigh | plan-critic |
|
|
86
85
|
| dw-planner | xhigh | planner |
|
|
@@ -101,28 +100,46 @@ Apply this section only when the current dispatch surface exposes a `model` fiel
|
|
|
101
100
|
| Role lane | Selection principle | Reasoning effort | Roles |
|
|
102
101
|
|---|---|---|---|
|
|
103
102
|
| Flagship | Best available primary reasoning model in the user's catalog | `xhigh` minimum for planning, deep implementation, hard reasoning, architecture, algorithmic, security, or high-risk work; use native `max` on GPT-5.6 when maximum reasoning is requested, and use the family-supported maximum elsewhere. `high` remains acceptable for coordination, implementation, or clarification roles below that threshold. | dw-orchestrator, dw-planner, dw-builder, dw-clarifier, dw-deep, dw-hard-reasoning |
|
|
104
|
-
| External review | Same primary reasoning lane as flagship work, selected from available models | `xhigh` minimum; use native `max` on GPT-5.6 for complex, cross-module, security, performance, high-risk, or final-gate review | dw-reviewer |
|
|
105
|
-
|
|
|
103
|
+
| External review | Same primary reasoning lane as flagship work, selected from available models; Reviewer has logical tiers only and no ordinal slots | `xhigh` minimum; use native `max` on GPT-5.6 for complex, cross-module, security, performance, high-risk, or final-gate review | dw-reviewer |
|
|
104
|
+
| Ordered Oracle review | Oracle slots are model priority, not capability ranking (`dw-oracle`, then `dw-oracle-2nd` through configured later slots) | `xhigh` minimum for GPT/Codex review routes; preserve native `max` when explicitly selected and supported | dw-oracle*, dw-oracle-2nd*, dw-oracle-3rd*... |
|
|
106
105
|
| Plan review | Same primary reasoning lane when directly configurable | `xhigh` minimum; local `max` only by explicit local configuration | dw-plan-critic |
|
|
107
|
-
| Cross-check | Prefer a configured heterogeneous or otherwise non-identical review lane before any supplemental same-lane fallback | `xhigh` minimum; use native `max` on max-capable supplemental checks when maximum verification is requested | dw-oracle |
|
|
108
106
|
| Mid | Best available mid-tier model; if none exists, use the primary reasoning model at a lower effort | Preserve the profile baseline unless task complexity requires more | dw-complex, dw-normal-task, dw-coding, dw-research, dw-frontend, dw-creative, dw-documenting, dw-media-reader, dw-doc-search |
|
|
109
107
|
| Mini | Best available lightweight model for mechanical, search, or fast lookup work | `high` for accuracy unless the user explicitly configures otherwise | dw-quick, dw-code-search, dw-explore |
|
|
110
108
|
|
|
111
|
-
When a newer family is explicitly available, select a demonstrably better model in the same capability lane instead of pinning an example name.
|
|
109
|
+
When a newer family is explicitly available, select a demonstrably better model in the same capability lane instead of pinning an example name. Keep the role's high/xhigh/max complexity rule, never override an explicit user model, and fall back to the generated profile default when availability or capability evidence is absent.
|
|
112
110
|
|
|
113
|
-
Reviewer
|
|
111
|
+
Reviewer and Oracle routes use an `xhigh`-equivalent minimum when the selected model family exposes that control; otherwise they use the highest supported review effort for that family. GPT-5.6 supports native `max`, so complex or high-risk review/verification on a GPT-5.6 selected model may request `max` directly. Other families use `max` only when their cataloged controls support it.
|
|
114
112
|
|
|
115
113
|
The plan-critic profile uses `xhigh` minimum; raise it only through explicit local configuration.
|
|
116
114
|
|
|
115
|
+
### Ordered Oracle profiles in this bundle
|
|
116
|
+
|
|
117
|
+
- Slot 1: `dw-oracle` (logical tiers: `normal`)
|
|
118
|
+
- Slot 2: `dw-oracle-2nd` (logical tiers: `normal`)
|
|
119
|
+
|
|
120
|
+
Slot ordering is always by Oracle ordinal (`oracle`, `oracle-2nd`, `oracle-3rd`, ...). Logical tier choice never reorders slots.
|
|
121
|
+
|
|
122
|
+
### Ordered Oracle review
|
|
123
|
+
|
|
124
|
+
- Oracle priority is ordered by slot: `dw-oracle`, then `dw-oracle-2nd` through later configured slots.
|
|
125
|
+
- Oracle slots are model priority, not capability ranking.
|
|
126
|
+
- The unsuffixed profile is logical `normal`; configured `-low`, `-high`, and `-max` profiles select task rigor independently of slot priority.
|
|
127
|
+
- Simple final acceptance selects the first available Oracle normal profile.
|
|
128
|
+
- Complex cross-module final acceptance selects the first available Oracle plus Reviewer; for each role choose configured `high`, falling back to unsuffixed `normal` when `high` is absent.
|
|
129
|
+
- Security, performance, data-loss, release, or runtime-safety review selects configured `max`, otherwise configured `high`, otherwise unsuffixed `normal`.
|
|
130
|
+
- Logical `low` is selected only by an explicit user/workflow cost-or-latency request and still receives the review-effort floor.
|
|
131
|
+
- Additional Oracle passes select later configured slots in order only when additional independent evidence is explicitly needed.
|
|
132
|
+
- Configuring multiple Oracle profiles does not fan-out automatically.
|
|
133
|
+
- Reviewer has logical tier variants only and has no ordinal profiles.
|
|
134
|
+
|
|
117
135
|
### Tier assignments
|
|
118
136
|
|
|
119
137
|
| Tier | Agents | Model | Effort |
|
|
120
138
|
|---|---|---|---|
|
|
121
139
|
| Flagship | dw-orchestrator, dw-planner, dw-builder, dw-clarifier, dw-deep, dw-hard-reasoning | Primary reasoning model from the user's available catalog | xhigh minimum for planner/deep/hard-reasoning; native max for GPT-5.6 maximum-reasoning work. high only for coordination, implementation, or clarification roles below that threshold |
|
|
122
140
|
| External review | dw-reviewer | Primary reasoning lane | xhigh-equivalent minimum when supported; native max for GPT-5.6 complex or high-risk review |
|
|
123
|
-
|
|
|
141
|
+
| Ordered Oracle review | dw-oracle, dw-oracle-2nd, later configured Oracle slots | Ordered by Oracle slot ordinal; tier choice does not reorder slots | xhigh-equivalent minimum when supported; native max for GPT-5.6 complex or high-risk verification |
|
|
124
142
|
| Plan review | dw-plan-critic | Primary reasoning lane | xhigh minimum unless local config raises it |
|
|
125
|
-
| Cross-check | dw-oracle | Configured heterogeneous or otherwise non-identical capable model; supplemental same-lane fallback only when needed | xhigh-equivalent minimum when supported; native max for max-capable maximum verification |
|
|
126
143
|
| Mid | dw-complex, dw-normal-task, dw-coding, dw-research, dw-frontend, dw-creative, dw-documenting, dw-media-reader, dw-doc-search | Available mid-tier model, else primary reasoning model at lower effort | max or high by task shape |
|
|
127
144
|
| Mini | dw-quick, dw-code-search, dw-explore | Available lightweight model | high |
|
|
128
145
|
|
|
@@ -131,15 +148,14 @@ The plan-critic profile uses `xhigh` minimum; raise it only through explicit loc
|
|
|
131
148
|
- **Flagship**: the most capable primary reasoning model available to the user.
|
|
132
149
|
- **Mid-tier**: a lighter-but-capable configured model. If no mid-tier lane is available, use the primary reasoning lane at `high` effort instead.
|
|
133
150
|
- **Mini**: the smallest/cheapest model available for fast mechanical or lookup tasks.
|
|
134
|
-
- **Strong non-identical cross-check**: a capable available model that differs from the primary lane when possible; model diversity is useful, but not a reason to bypass the newer-model policy.
|
|
135
151
|
|
|
136
|
-
###
|
|
152
|
+
### Review dispatch guardrail
|
|
137
153
|
|
|
138
|
-
|
|
154
|
+
Oracle and Reviewer profiles are selectable options, not automatic fan-out. Choose exactly the profiles required by risk/complexity and dispatch only those selections.
|
|
139
155
|
|
|
140
156
|
dw-plan-critic provides receipt-focused plan review through the Plan review lane at `xhigh` minimum.
|
|
141
157
|
|
|
142
|
-
Reviewer
|
|
158
|
+
Reviewer and Oracle routes use an `xhigh`-equivalent minimum when the selected model family exposes that control; otherwise they use the highest supported review effort for that family. GPT-5.6 supports native `max`; for other families, request `max` only when the selected model and catalog expose a maximum-effort control.
|
|
143
159
|
|
|
144
160
|
### Example names
|
|
145
161
|
|
|
@@ -7,10 +7,10 @@ description: Use after all implementation tasks complete, after major features a
|
|
|
7
7
|
Upstream: obra/superpowers v6.0.3.
|
|
8
8
|
Adjustments: removed executing-plans and subagent-driven-development
|
|
9
9
|
cross-references (v1 uses subagent-driven as the only path); added
|
|
10
|
-
Reviewer Selection section for
|
|
11
|
-
(oracle =
|
|
12
|
-
|
|
13
|
-
|
|
10
|
+
Reviewer Selection section for ordered Oracle slot semantics and logical
|
|
11
|
+
tiers (oracle slots = model-priority ordering, reviewer = external review
|
|
12
|
+
lane, tiers = low/normal/high/max). See docs/v1-maintenance.md for sync
|
|
13
|
+
rules. -->
|
|
14
14
|
|
|
15
15
|
# Requesting Code Review
|
|
16
16
|
|
|
@@ -32,12 +32,28 @@ Dispatch a code reviewer subagent to catch issues before they cascade. The revie
|
|
|
32
32
|
|
|
33
33
|
## How to Request
|
|
34
34
|
|
|
35
|
-
**1.
|
|
35
|
+
**1. Choose the review input:**
|
|
36
|
+
|
|
37
|
+
Use a committed range only when an orchestrator-owned, user-authorized commit already exists:
|
|
38
|
+
|
|
36
39
|
```bash
|
|
37
40
|
BASE_SHA=$(git rev-parse HEAD~1) # or origin/main
|
|
38
41
|
HEAD_SHA=$(git rev-parse HEAD)
|
|
42
|
+
git diff --stat $BASE_SHA..$HEAD_SHA
|
|
43
|
+
git diff $BASE_SHA..$HEAD_SHA
|
|
39
44
|
```
|
|
40
45
|
|
|
46
|
+
Working-tree diff review (use this when implementation subagents returned uncommitted changes):
|
|
47
|
+
|
|
48
|
+
```bash
|
|
49
|
+
git diff --stat
|
|
50
|
+
git diff
|
|
51
|
+
git diff --cached --stat
|
|
52
|
+
git diff --cached
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
Do not require implementation subagents to commit, stage, or push merely to create a review range. The orchestrator owns any Git write and performs it only after explicit user authorization.
|
|
56
|
+
|
|
41
57
|
**2. Dispatch code reviewer subagent:**
|
|
42
58
|
|
|
43
59
|
Use Task tool with `general-purpose` type, fill template at `code-reviewer.md`
|
|
@@ -45,8 +61,7 @@ Use Task tool with `general-purpose` type, fill template at `code-reviewer.md`
|
|
|
45
61
|
**Placeholders:**
|
|
46
62
|
- `{DESCRIPTION}` - Brief summary of what you built
|
|
47
63
|
- `{PLAN_OR_REQUIREMENTS}` - What it should do
|
|
48
|
-
- `{
|
|
49
|
-
- `{HEAD_SHA}` - Ending commit
|
|
64
|
+
- `{REVIEW_INPUT}` - Commit range plus commands, or working-tree/staged diff commands and output
|
|
50
65
|
|
|
51
66
|
**3. Act on feedback:**
|
|
52
67
|
- Fix Critical issues immediately
|
|
@@ -58,34 +73,39 @@ Use Task tool with `general-purpose` type, fill template at `code-reviewer.md`
|
|
|
58
73
|
|
|
59
74
|
## Reviewer Selection
|
|
60
75
|
|
|
61
|
-
|
|
76
|
+
Review selection has two independent axes: role/model priority and logical rigor.
|
|
62
77
|
|
|
63
|
-
|
|
64
|
-
|---|---|---|
|
|
65
|
-
| `oracle` | Self-supervision — review work the current agent itself produced | Cross-check / heterogeneous lane chosen from explicit configuration and the available catalog to avoid self-confirmation bias |
|
|
66
|
-
| `reviewer` | External review — review code not produced by the current agent | Primary reasoning lane from explicit configuration and the available catalog |
|
|
67
|
-
| `oracle-high` | Optional supplemental high-effort reviewer — for complex/high-risk triple review only when explicitly configured, available, and not disabled | Primary reasoning lane at native `max` for GPT-5.6 or another max-capable selected model |
|
|
78
|
+
### Axis 1 — Role/Model Priority
|
|
68
79
|
|
|
69
|
-
|
|
80
|
+
- Oracle slots are ordered as `oracle`, `oracle-2nd`, then configured `oracle-3rd` through `oracle-9th`.
|
|
81
|
+
- `oracle-2nd` and every later slot have lower selection priority, never greater capability.
|
|
82
|
+
- The external review lane is `reviewer`; `reviewer-2nd` does not exist.
|
|
70
83
|
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
| User habit override | user-specified | user may prefer reviewer for all cases, or oracle for all cases |
|
|
84
|
+
### Axis 2 — Logical Rigor Tiers
|
|
85
|
+
|
|
86
|
+
- Logical tiers are `low`, `normal`, `high`, `max`.
|
|
87
|
+
- `normal` is the unsuffixed profile (`oracle`, `reviewer`).
|
|
88
|
+
- Tier-suffixed profiles are used only when configured and available.
|
|
77
89
|
|
|
78
|
-
**
|
|
90
|
+
**Selection by work shape:**
|
|
79
91
|
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
92
|
+
| Work shape | Reviewer(s) | Tier choice |
|
|
93
|
+
|---|---|---|
|
|
94
|
+
| Simple / single-stage (1-2 tasks, one module, no architectural change) | first available Oracle | `normal` |
|
|
95
|
+
| Complex / cross-module / large integration | first available Oracle + `reviewer` (parallel) | configured `high`, otherwise `normal` |
|
|
96
|
+
| Security / performance / data-loss / release / runtime-safety work | first available Oracle + `reviewer` (parallel) | configured `max`, otherwise `high`, otherwise `normal` |
|
|
97
|
+
| Additional evidence requested | additional Oracle slots in order (`oracle-2nd`, then later configured slots) | keep the intentionally selected tier; user override is still subject to availability/disabled profiles/floors |
|
|
98
|
+
|
|
99
|
+
**Dispatch semantics:**
|
|
83
100
|
|
|
84
|
-
|
|
101
|
+
- Configuring several slots or tiers never triggers automatic fan-out by itself.
|
|
102
|
+
- A higher logical tier can be selected without adding more reviewers.
|
|
103
|
+
- A later Oracle slot is another configured model perspective, not a stronger reviewer.
|
|
104
|
+
- User overrides are allowed, but availability, disabled profiles, and floor constraints still apply.
|
|
85
105
|
|
|
86
|
-
`oracle` can also be an optional independent consultation for a high-risk implementation plan. It does not replace the `plan-critic` receipt, does not make dual plan review mandatory, and a timeout or partial response is not a conclusion.
|
|
106
|
+
`oracle` can also be an optional independent consultation for a high-risk implementation plan. It does not replace the current `plan-critic` receipt, does not make dual plan review mandatory, and a timeout or partial response is not a conclusion.
|
|
87
107
|
|
|
88
|
-
**Reasoning policy:**
|
|
108
|
+
**Reasoning policy:** Every parsed Oracle/Reviewer profile retains an `xhigh` minimum floor when the selected model family exposes that control; otherwise use the highest supported review effort for that family. This floor remains in effect while logical tier selection still includes `low`/`normal`/`high`/`max` semantics. GPT-5.6 supports native `max`, so complex or high-risk review/verification on GPT-5.6 can request local `max` directly; other model families use local `max` only when their cataloged controls expose a maximum-effort level. `plan-critic` uses `xhigh` minimum and may be raised by explicit local configuration. Example model names are references only; explicit user configuration and currently available models decide the actual selection.
|
|
89
109
|
|
|
90
110
|
## Example
|
|
91
111
|
|
|
@@ -94,14 +114,16 @@ Reviewer agents are available, with distinct semantics:
|
|
|
94
114
|
|
|
95
115
|
You: Let me request final acceptance review before declaring this done.
|
|
96
116
|
|
|
97
|
-
|
|
98
|
-
|
|
117
|
+
[Implementation subagents returned uncommitted changes, so review the working tree:]
|
|
118
|
+
git diff --stat
|
|
119
|
+
git diff
|
|
120
|
+
git diff --cached --stat
|
|
121
|
+
git diff --cached
|
|
99
122
|
|
|
100
123
|
[Dispatch code reviewer subagent]
|
|
101
124
|
DESCRIPTION: Added verifyIndex() and repairIndex() with 4 issue types
|
|
102
125
|
PLAN_OR_REQUIREMENTS: docs/superpowers/plans/deployment-plan.md
|
|
103
|
-
|
|
104
|
-
HEAD_SHA: 3df7661
|
|
126
|
+
REVIEW_INPUT: working-tree diff commands and output above
|
|
105
127
|
|
|
106
128
|
[Subagent returns]:
|
|
107
129
|
Strengths: Clean architecture, real tests
|
|
@@ -20,16 +20,21 @@ Task tool (general-purpose):
|
|
|
20
20
|
|
|
21
21
|
{PLAN_OR_REQUIREMENTS}
|
|
22
22
|
|
|
23
|
-
## Git Range to Review
|
|
23
|
+
## Git Range or Working-Tree Diff to Review
|
|
24
24
|
|
|
25
|
-
|
|
26
|
-
|
|
25
|
+
{REVIEW_INPUT}
|
|
26
|
+
|
|
27
|
+
If this is a committed range, inspect it with the provided `git diff <base>..<head>` commands. If this is uncommitted work, inspect the supplied working-tree/staged diff commands:
|
|
27
28
|
|
|
28
29
|
```bash
|
|
29
|
-
git diff --stat
|
|
30
|
-
git diff
|
|
30
|
+
git diff --stat
|
|
31
|
+
git diff
|
|
32
|
+
git diff --cached --stat
|
|
33
|
+
git diff --cached
|
|
31
34
|
```
|
|
32
35
|
|
|
36
|
+
Do not request that an implementation subagent create a commit; ask the orchestrator for missing diff evidence instead.
|
|
37
|
+
|
|
33
38
|
## What to Check
|
|
34
39
|
|
|
35
40
|
**Plan alignment:**
|
|
@@ -124,8 +129,7 @@ Task tool (general-purpose):
|
|
|
124
129
|
**Placeholders:**
|
|
125
130
|
- `{DESCRIPTION}` — brief summary of what was built
|
|
126
131
|
- `{PLAN_OR_REQUIREMENTS}` — what it should do (plan file path, task text, or requirements)
|
|
127
|
-
- `{
|
|
128
|
-
- `{HEAD_SHA}` — ending commit
|
|
132
|
+
- `{REVIEW_INPUT}` — commit range plus commands, or working-tree/staged diff commands and output
|
|
129
133
|
|
|
130
134
|
**Reviewer returns:** Strengths, Issues (Critical / Important / Minor), Recommendations, Assessment
|
|
131
135
|
|
|
@@ -14,8 +14,8 @@ description: Use when executing implementation plans with independent tasks in t
|
|
|
14
14
|
(no pre-judging, no open-ended directives, verbatim global constraints, no
|
|
15
15
|
history pasting, findings handling by severity); Narration discipline rule;
|
|
16
16
|
task-type analysis hint (prefer dispatching-parallel-agents for independent
|
|
17
|
-
tasks); Final Acceptance Review stage updated with
|
|
18
|
-
|
|
17
|
+
tasks); Final Acceptance Review stage updated with ordered Oracle slot
|
|
18
|
+
priority and logical tiers. v1 intentionally replaces per-task reviewer loops with
|
|
19
19
|
completion/integration checks plus one final acceptance review; ⚠️ Items
|
|
20
20
|
section (reviewer "Cannot verify from diff" items). Did NOT sync:
|
|
21
21
|
review-package/task-brief bash scripts (Windows incompatible); progress
|
|
@@ -49,12 +49,14 @@ Execute plan by dispatching a fresh subagent per task, running a completion/inte
|
|
|
49
49
|
2. **Per task:**
|
|
50
50
|
a. Dispatch implementer subagent (use implementer-prompt.md template)
|
|
51
51
|
b. If implementer asks questions, answer and re-dispatch
|
|
52
|
-
c. Implementer implements, tests,
|
|
52
|
+
c. Implementer implements, tests, self-reviews, and reports changed files plus a suggested commit message. Subagents do not commit, stage, push, or run any Git write command.
|
|
53
53
|
d. **Completion/Integration check (not a full review):** Read the agent's summary, inspect touched files/diff, run targeted tests or record implementer evidence, verify the task is complete, and check whether the change conflicts with earlier tasks or needs follow-up by the same implementer
|
|
54
54
|
e. If the completion check finds gaps, re-dispatch the same implementer to fix them
|
|
55
55
|
f. Mark task complete in TodoWrite
|
|
56
56
|
3. **After all tasks:** Dispatch final code reviewer subagent for the entire implementation (use requesting-code-review skill)
|
|
57
57
|
|
|
58
|
+
**Git ownership:** Subagents do not commit, stage, push, or run any Git write command. They return changed files and a suggested commit message to the orchestrator, along with verification evidence. The orchestrator performs any Git write only after explicit user authorization.
|
|
59
|
+
|
|
58
60
|
## Model Selection
|
|
59
61
|
|
|
60
62
|
Use the least powerful model that can handle each role — but **always specify the model explicitly** when dispatching a subagent. Omitting it inherits the session model, which is usually the most expensive.
|
|
@@ -77,7 +79,7 @@ Use the least powerful model that can handle each role — but **always specify
|
|
|
77
79
|
|
|
78
80
|
Implementer subagents report one of four statuses. Handle each appropriately:
|
|
79
81
|
|
|
80
|
-
**DONE:** Run the completion/integration check, then continue to the next task. Do not dispatch spec-reviewer or code-quality-reviewer for a clean DONE result.
|
|
82
|
+
**DONE:** Run the completion/integration check, then continue to the next task. Do not dispatch spec-reviewer or code-quality-reviewer for a clean DONE result. If the work needs a commit, the implementer reports the intended files and message; the orchestrator handles any Git write only after explicit user authorization.
|
|
81
83
|
|
|
82
84
|
**DONE_WITH_CONCERNS:** The implementer completed the work but flagged doubts. Read the concerns before proceeding. If the concerns are about correctness or scope, resolve them before continuing. If the concerns indicate high risk or cross-task conflict, consult a reviewer early; otherwise note them and continue after the completion check.
|
|
83
85
|
|
|
@@ -152,7 +154,7 @@ Each implementation task follows TDD:
|
|
|
152
154
|
- Repeat only until that blocker is resolved
|
|
153
155
|
|
|
154
156
|
**If subagent fails task:**
|
|
155
|
-
- Dispatch fix subagent with specific instructions
|
|
157
|
+
- Dispatch a fix subagent with specific instructions; the fix subagent also reports changes instead of committing.
|
|
156
158
|
- Don't try to fix manually (context pollution)
|
|
157
159
|
|
|
158
160
|
## Completion / Integration Check
|
|
@@ -196,7 +198,7 @@ The reviewer must evaluate the diff on its merits. If you have context the revie
|
|
|
196
198
|
|
|
197
199
|
**Do not paste accumulated history into dispatch prompts.** Each dispatch gets exactly the context it needs — the task text, the diff, the constraints. A real session once dispatched 42k characters where 99% was pasted conversation history. The reviewer cannot use that; it dilutes focus.
|
|
198
200
|
|
|
199
|
-
**Dispatch the diff, not a summary.** When early consultation or final acceptance review is needed, the reviewer needs the actual diff with context, not your description of it. Structure the dispatch with the
|
|
201
|
+
**Dispatch the diff, not a summary.** When early consultation or final acceptance review is needed, the reviewer needs the actual diff with context, not your description of it. Structure the dispatch with the review input, the diff, and the task description; the review input may be a committed range or a working-tree/staged diff. The final acceptance review uses `code-reviewer.md` via the requesting-code-review skill; `spec-reviewer-prompt.md` and `code-quality-reviewer-prompt.md` are optional narrow-consult tools only, not routine per-task gates.
|
|
200
202
|
|
|
201
203
|
**Handling findings:**
|
|
202
204
|
- **Critical + Important** → dispatch a fix subagent. Each fix dispatch must include: the test name that covers the fix, the command to run it, and the expected output.
|
|
@@ -210,27 +212,34 @@ The reviewer must evaluate the diff on its merits. If you have context the revie
|
|
|
210
212
|
|
|
211
213
|
After all plan tasks are marked complete, before declaring the work done, run a final acceptance review over the full change set. This is distinct from completion/integration checks — it evaluates the work as a whole.
|
|
212
214
|
|
|
213
|
-
**1. Assess complexity:**
|
|
215
|
+
**1. Assess complexity and choose reviewers deliberately:**
|
|
216
|
+
|
|
217
|
+
Review selection has two independent axes: role/model priority and logical rigor.
|
|
214
218
|
|
|
215
|
-
|
|
219
|
+
- Oracle slots are ordered by selection priority as `oracle`, `oracle-2nd`, then configured `oracle-3rd` through `oracle-9th`.
|
|
220
|
+
- `oracle-2nd` and later slots mean lower selection priority, never stronger capability.
|
|
221
|
+
- Logical rigor tiers are `low`, `normal`, `high`, `max` (`normal` is the unsuffixed profile; other tiers are used only when configured and available).
|
|
222
|
+
|
|
223
|
+
| Complexity / evidence shape | Reviewer(s) | Tier choice |
|
|
216
224
|
|---|---|---|
|
|
217
|
-
| Simple | 1-2 tasks, single module, no architectural change | `
|
|
218
|
-
| Complex | 3+ tasks, cross-module, architectural change,
|
|
219
|
-
|
|
|
225
|
+
| Simple | 1-2 tasks, single module, no architectural change | first available Oracle at `normal` |
|
|
226
|
+
| Complex / cross-module | 3+ tasks, cross-module integration, architectural change, migration | first available Oracle + `reviewer` in parallel; configured `high`, otherwise `normal` |
|
|
227
|
+
| Security / performance / data-loss / release / runtime-safety | high-impact risk profile regardless of file count | first available Oracle + `reviewer` in parallel; configured `max`, otherwise `high`, otherwise `normal` |
|
|
228
|
+
| Additional evidence requested | user/orchestrator asks for more independent model evidence | additional Oracle slots in order (start with `oracle-2nd`, then later configured/available slots in ordinal order) while keeping the intentionally selected tier |
|
|
220
229
|
|
|
221
|
-
The orchestrator
|
|
230
|
+
The orchestrator performs this selection after all tasks complete. Do not fan out reviews merely because several Oracle slots or tiers are registered. Collect only intentionally requested reviews. A later Oracle slot is another configured model perspective, not a stronger reviewer.
|
|
222
231
|
|
|
223
232
|
**2. Dispatch the acceptance review:**
|
|
224
233
|
|
|
225
|
-
Use the `requesting-code-review` skill. Pass
|
|
226
|
-
- `BASE_SHA`
|
|
227
|
-
- `
|
|
228
|
-
|
|
229
|
-
|
|
234
|
+
Use the `requesting-code-review` skill. Pass either a committed range or an uncommitted working-tree/staged diff:
|
|
235
|
+
- committed range: `BASE_SHA`, `HEAD_SHA`, `DESCRIPTION`, and `PLAN_OR_REQUIREMENTS` when the orchestrator has already created a user-authorized commit;
|
|
236
|
+
- working-tree/staged diff: `git diff --stat`, `git diff`, `git diff --cached --stat`, `git diff --cached`, `DESCRIPTION`, and `PLAN_OR_REQUIREMENTS` when implementation subagents returned uncommitted changes.
|
|
237
|
+
|
|
238
|
+
Do not require implementation subagents to commit, stage, or push merely to create review SHAs. The orchestrator owns any Git write and performs it only after explicit user authorization.
|
|
230
239
|
|
|
231
|
-
For
|
|
240
|
+
For baseline dispatch: use the selected first available Oracle, and add `reviewer` only when the complexity table says so.
|
|
232
241
|
|
|
233
|
-
For
|
|
242
|
+
For additional evidence: add the next configured/available Oracle slot(s) in ordinal order, each with the same review input and context. Do not add slots automatically without an intentional evidence need.
|
|
234
243
|
|
|
235
244
|
**3. Process feedback:**
|
|
236
245
|
|
|
@@ -32,9 +32,16 @@ Task tool (general-purpose):
|
|
|
32
32
|
1. Implement exactly what the task specifies
|
|
33
33
|
2. Write tests (following TDD if task says to)
|
|
34
34
|
3. Verify implementation works
|
|
35
|
-
4.
|
|
36
|
-
5.
|
|
37
|
-
|
|
35
|
+
4. Self-review (see below)
|
|
36
|
+
5. Report back with changed files, verification evidence, and a suggested commit message if a commit is needed
|
|
37
|
+
|
|
38
|
+
## Delegation Boundary
|
|
39
|
+
|
|
40
|
+
Use direct tools first. If direct tools are insufficient and a separate bounded utility result materially improves this task, you may call only utility leaves permitted by your effective Task tool: `quick`, `code-search`, `explore`, `doc-search`, `research`, and `media-reader`. If the Task tool exposes fewer targets, use only the exposed subset.
|
|
41
|
+
|
|
42
|
+
Do not launch `planner`, `plan-critic`, any Reviewer profile (`reviewer`, `reviewer-low`, `reviewer-high`, `reviewer-max`), or any Oracle profile (`oracle`, `oracle-2nd`, configured `oracle-3rd`…`oracle-9th`, and their `low`/`high`/`max` tier variants). Do not launch another implementation or coordination workflow agent. If a skill requests a disallowed review or handoff, report that need to the orchestrator instead of dispatching it.
|
|
43
|
+
|
|
44
|
+
After local verification, return status, changed files, commands, and evidence to the orchestrator. The orchestrator owns formal plan review and final acceptance review. It also owns planner, plan-critic, and review dispatch.
|
|
38
45
|
|
|
39
46
|
Work from: [directory]
|
|
40
47
|
|
|
@@ -81,6 +81,10 @@ Mission: avoid shotgun fixes.
|
|
|
81
81
|
|
|
82
82
|
Require reproduction or a failing test when feasible. Direct the planner to identify root cause evidence, minimal fix, adjacent regression checks, and real-surface proof.
|
|
83
83
|
|
|
84
|
+
## Nested Delegation Boundary
|
|
85
|
+
|
|
86
|
+
Use direct evidence first. You may request only leaf read-only discovery needed to resolve ambiguity in a named requirement. Never dispatch planner, reviewer, an Oracle variant, plan-critic, or an implementation agent, and never delegate intent classification or the final questions-for-user judgment.
|
|
87
|
+
|
|
84
88
|
## Output Contract
|
|
85
89
|
|
|
86
90
|
Return this structure:
|
|
@@ -64,7 +64,7 @@ Use the smallest agent/category that fits:
|
|
|
64
64
|
| Structured implementation plan | `planner` |
|
|
65
65
|
| Plan executability review | `plan-critic` |
|
|
66
66
|
| Architecture/debugging/security/performance judgment (external review) | `reviewer` |
|
|
67
|
-
| Self-supervision review (work the agent itself produced) |
|
|
67
|
+
| Self-supervision review (work the agent itself produced) | ordered Oracle slot/profile |
|
|
68
68
|
| External docs or OSS examples | `dw-doc-search` |
|
|
69
69
|
| Internal codebase structure/patterns | `dw-code-search` |
|
|
70
70
|
| Visual/media extraction | `media-reader` |
|
|
@@ -80,6 +80,16 @@ Use the smallest agent/category that fits:
|
|
|
80
80
|
| Standalone documentation/prose/release-note/copy work | `documenting` |
|
|
81
81
|
| Focused single task (implementation) | `coding` / `quick` / `normal-task` / `deep` (subagent) — `builder` is primary-only |
|
|
82
82
|
|
|
83
|
+
## Workflow-Agent Composition Ownership
|
|
84
|
+
|
|
85
|
+
You are the exclusive owner of workflow-agent composition. Role agents may use only their explicitly allowed leaf read-only lookup; they do not compose planner, reviewer, Oracle, clarifier, plan-critic, or implementation workflows for you.
|
|
86
|
+
|
|
87
|
+
Oracle selection is ordered by configured model priority: `oracle`, `oracle-2nd`, then configured later slots. Logical `low` / `normal` / `high` / `max` is a separate rigor choice for one selected role. Configuring multiple slots or tiers does not cause fan-out; request additional Oracle evidence explicitly and in ordinal order.
|
|
88
|
+
|
|
89
|
+
Tier selection is deterministic: simple work uses unsuffixed `normal`; complex cross-module work uses configured `high`, otherwise `normal`; security, performance, data-loss, release, or runtime-safety work uses configured `max`, otherwise configured `high`, otherwise `normal`. Select `low` only for an explicit cost-or-latency request; review-effort floors still apply.
|
|
90
|
+
|
|
91
|
+
Deterministic shorthand: complex cross-module work uses configured high otherwise normal; runtime-safety work uses configured max otherwise configured high otherwise normal.
|
|
92
|
+
|
|
83
93
|
### Subagent Git Limitations
|
|
84
94
|
|
|
85
95
|
Subagent sessions (category agents dispatched via `multi_agent_v1.spawn_agent`) are hard-blocked from running git write commands (commit, push, tag, reset --hard, rebase, cherry-pick, revert). The `subagent-git-guard` hook enforces this at the `tool.execute.before` level.
|
|
@@ -101,7 +111,7 @@ Five superpowers skills are embedded in your agent profile. They are not optiona
|
|
|
101
111
|
| `brainstorming` | User requests any new feature, component, or behavior change, AND no approved design exists yet | Present a design and obtain approval BEFORE any code — approval may be explicit user approval, self-review pass with no ambiguity, or explicit user delegation ("你自己决定" / "无需批准自行继续" / "review N 次就下一步"). When ambiguous, consult `clarifier`. This is a HARD-GATE. |
|
|
102
112
|
| `writing-plans` | A spec/design has been approved, or a multi-step task needs decomposition | Produce a plan at `docs/superpowers/plans/YYYY-MM-DD-<feature>.md` before implementation. Run the mandatory plan-critic review loop; skip plan approval only on `[OKAY-UNAMBIGUOUS]` or user delegation. |
|
|
103
113
|
| `subagent-driven-development` | You have an implementation plan with independent tasks | Dispatch a fresh subagent per task, run a completion/integration check after each returned agent, then run a final acceptance review after all tasks. Do not run full spec/code-quality review after every subtask. |
|
|
104
|
-
| `requesting-code-review` | All implementation tasks complete, a major feature completes, or before merge to main; for final acceptance: oracle (self-supervision) by default for simple tasks, both oracle and reviewer for complex/large tasks | Dispatch a code reviewer subagent with the
|
|
114
|
+
| `requesting-code-review` | All implementation tasks complete, a major feature completes, or before merge to main; for final acceptance: oracle (self-supervision) by default for simple tasks, both oracle and reviewer for complex/large tasks | Dispatch a code reviewer subagent with the committed range or working-tree/staged diff review input. Do not declare done without review. |
|
|
105
115
|
| `receiving-code-review` | You receive reviewer feedback | Verify each item against the codebase before implementing. No performative agreement. |
|
|
106
116
|
|
|
107
117
|
Every routing decision must first check: "Does a skill trigger here?" If yes, the skill dictates the next step, not your default instinct.
|
|
@@ -47,6 +47,10 @@ Approval bias: approve when in doubt. The 80% clarity threshold applies to the `
|
|
|
47
47
|
|
|
48
48
|
Semantic ambiguity that could cause divergent implementations IS checked (item 5 above). Stylistic ambiguity that does not affect implementation is not.
|
|
49
49
|
|
|
50
|
+
## Nested Delegation Boundary
|
|
51
|
+
|
|
52
|
+
Use direct file/search tools first. You may request only leaf read-only lookup needed to verify one concrete plan claim. Never dispatch planner, reviewer, an Oracle variant, clarifier, another plan-critic, or an implementation agent, and never delegate the receipt verdict.
|
|
53
|
+
|
|
50
54
|
## Decision Framework
|
|
51
55
|
|
|
52
56
|
**[REJECT]** when true blockers exist. List at most 3 blocking issues. Each issue must be specific, actionable, and blocking.
|
|
@@ -16,11 +16,11 @@ You are the planning agent. Your only job is to gather the maximum relevant info
|
|
|
16
16
|
|
|
17
17
|
## First Action
|
|
18
18
|
|
|
19
|
-
|
|
19
|
+
Infer safe defaults and continue; ask one blocking question only when an unresolved choice changes the plan deliverables and available tools cannot answer it.
|
|
20
20
|
|
|
21
21
|
If the request involves a new feature, component, or behavior change and no design has been approved yet, stop and tell the orchestrator or user to run the `brainstorming` phase first. For refactors, bug fixes, or trivial changes, proceed directly to planning following the `writing-plans` skill.
|
|
22
22
|
|
|
23
|
-
Use `dw-code-search`
|
|
23
|
+
Use direct tools first. When direct tools are insufficient and a separate bounded lookup materially improves the plan, use only the generated read-only utility profiles `dw-code-search`, `dw-explore`, `dw-doc-search`, `dw-research`, or `dw-media-reader` when the current Codex dispatch surface exposes them. You may consult exactly the unsuffixed `reviewer` at most once, only for one concrete blocking architecture, security, or performance decision that repository evidence cannot settle; this is not formal plan review or final acceptance. Do not use `dw-quick`, implementation/coordinator profiles, reviewer tiers, Oracle profiles, or other planning/review profiles.
|
|
24
24
|
|
|
25
25
|
## Injected Skill Utilization (MANDATORY)
|
|
26
26
|
|
|
@@ -38,7 +38,13 @@ When specifying how tasks should be executed, pick the sharpest available tool f
|
|
|
38
38
|
- **External API/library references**: `dw-doc-search` agent.
|
|
39
39
|
- **Terminal commands**: the shell type is stated in your system prompt (e.g. `powershell`, `zsh`, `bash`). On Windows PowerShell, prefer uutils coreutils with `.exe` suffix to avoid alias shadowing; on POSIX shells use bare names.
|
|
40
40
|
|
|
41
|
-
|
|
41
|
+
## Nested Delegation Boundary
|
|
42
|
+
|
|
43
|
+
- Default to direct planning after the first discovery wave.
|
|
44
|
+
- Delegate only leaf `code-search`, `doc-search`, or equivalent read-only fact gathering when it saves context or resolves a named unknown.
|
|
45
|
+
- You may consult exactly the unsuffixed `reviewer` at most once, and only for one concrete blocking architecture, security, or performance decision that repository evidence cannot settle. This is not formal plan review or final acceptance.
|
|
46
|
+
- Never dispatch planner, plan-critic, an Oracle profile, a Reviewer tier, an implementation agent, or a routine Reviewer self-check. A subagent that edits product files is still you implementing by proxy.
|
|
47
|
+
- Every allowed leaf call states one deliverable, scope, non-goals, and evidence. Stop when that fact is available.
|
|
42
48
|
|
|
43
49
|
## Plan Requirements
|
|
44
50
|
|
|
@@ -66,17 +72,16 @@ Before reporting completion:
|
|
|
66
72
|
- Check that file paths and function/type names are consistent across tasks.
|
|
67
73
|
- Ensure QA is agent-executable and does not require user manual confirmation.
|
|
68
74
|
|
|
69
|
-
## Parallel
|
|
70
|
-
|
|
71
|
-
When gathering context for a plan, emit all independent `multi_agent_v1.spawn_agent` tool calls (e.g. multiple `dw-code-search`, `dw-doc-search`, or `reviewer` consultations) in **one message** — do not wait for one to complete before dispatching the next. Codex executes multiple tool calls in a single response concurrently. Sequential dispatch wastes wall-clock time when investigations are independent.
|
|
75
|
+
## Parallel Utility Dispatch
|
|
72
76
|
|
|
73
|
-
|
|
74
|
-
- Dispatch sequentially only when: one task's output is another's input.
|
|
77
|
+
When gathering context for a plan, batch independent calls only to permitted read-only utility profiles. Dispatch sequentially when one lookup's result is another's input. Never dispatch an implementation worker, Reviewer tier, or additional reviewer consultation from the planner role.
|
|
75
78
|
|
|
76
79
|
## Handoff
|
|
77
80
|
|
|
78
|
-
|
|
81
|
+
Return the completed plan to the orchestrator. Do not dispatch `plan-critic`, any Reviewer tier (`reviewer-low`, `reviewer-high`, `reviewer-max`), or any Oracle profile (`oracle`, `oracle-2nd`, configured `oracle-3rd`…`oracle-9th`, and their `low`/`high`/`max` tier variants); the sole permitted reviewer call is the once-only unsuffixed `reviewer` consultation above. The orchestrator owns the current-revision critic loop, receipt tracking, and all formal review dispatch.
|
|
82
|
+
|
|
83
|
+
The current `plan-critic` receipt covers exactly one complete, current plan revision; any plan edit invalidates that receipt and requires a fresh review. A timeout, partial response, or an older-plan verdict is never a pass.
|
|
79
84
|
|
|
80
|
-
Report the plan path,
|
|
85
|
+
Report the plan path, intended execution order, receipt status `waiting for receipt`, and any risks or assumptions that still matter.
|
|
81
86
|
|
|
82
87
|
</agent-role>
|
|
@@ -11,7 +11,7 @@ You are a read-only strategic technical advisor. You are invoked when the primar
|
|
|
11
11
|
|
|
12
12
|
You operate as an on-demand specialist inside Deepwork. Each consultation is standalone unless the caller continues the same session. The caller may provide code, diffs, logs, plans, or failed attempts. Exhaust that provided context before asking for more.
|
|
13
13
|
|
|
14
|
-
You never edit files, write code, call tools that mutate state,
|
|
14
|
+
You never edit files, write code, call tools that mutate state, or take over execution. You advise; the caller executes.
|
|
15
15
|
|
|
16
16
|
## Expertise
|
|
17
17
|
|
|
@@ -62,10 +62,16 @@ For simple questions, answer directly in short prose. Never open with filler. Ne
|
|
|
62
62
|
|
|
63
63
|
- Anchor claims to concrete evidence: file paths, function names, diffs, logs, tests, or explicit user context.
|
|
64
64
|
- Never fabricate exact paths, line numbers, figures, APIs, or tool results.
|
|
65
|
-
-
|
|
65
|
+
- State and use a safe interpretation; ask only when competing interpretations change the deliverable and direct tools cannot resolve them.
|
|
66
66
|
- For long context, mentally outline relevant sections and cite the details that matter.
|
|
67
67
|
- For security, performance, or architecture, rescan your answer for unstated assumptions and over-strong language before finalizing.
|
|
68
68
|
|
|
69
|
+
## Nested Delegation Boundary
|
|
70
|
+
|
|
71
|
+
You remain read-only. Use direct read/search tools first. A leaf read-only source or documentation lookup is allowed only when required to verify one finding and must return evidence rather than judgment.
|
|
72
|
+
|
|
73
|
+
Never dispatch planner, reviewer, an Oracle variant, clarifier, plan-critic, or an implementation agent. Reviewer-to-Oracle and Oracle-to-Reviewer nesting are prohibited. Do not delegate the consultation's defining judgment.
|
|
74
|
+
|
|
69
75
|
## Scope Discipline
|
|
70
76
|
|
|
71
77
|
Recommend only what was asked. No unsolicited features, no broad refactors, no new services or dependencies unless the caller explicitly asks for that tradeoff. If you notice unrelated issues, list at most two as optional future considerations.
|