@dreki-gg/pi-subagent 0.10.0 → 0.11.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @dreki-gg/pi-subagent
 
+## 0.11.0
+
+### Minor Changes
+
+- Model routing guidance and visible model attribution.
+
+  - `spawn-subagents` skill: new "Model routing" section — route each subagent task to the model whose strengths match the work (bulk token burn → cheap, user-facing → tasteful, reviews → strongest), honor a user model routing policy from AGENTS.md when one exists, and escalate without asking when a cheaper model's output misses the bar.
+  - Reasoning defaults: Opus-backed judgment/coding agents (advisor, planner, reviewer, validator, bug-prover, ux-designer) now run `thinking: high` instead of low/medium — reasoning effort applies per step, and high is the quality/cost sweet spot. Scouts stay low for cheap bulk recon.
+  - Result rendering: the model that ran each task is now shown next to the agent name in single, parallel, and chain headers (dim ` · model`), and in the working message while a run is active — so per-model quality is auditable at a glance. Parallel running placeholders resolve the model up front (task override → call default → agent default), so attribution shows while tasks are still running, not just after completion.
+  - `scout` and `docs-scout` default models move from `gpt-5.4-mini` to `gpt-5.6-luna` — near-Terra coding quality at the lowest benchmarked cost per task.
+
 ## 0.10.0
 
 ### Minor Changes

package/README.md

@@ -56,6 +56,17 @@ identical to pi-backed subagents.
 - The model is passed as `cursor-agent --model <model> acp`; see `cursor-agent --list-models`
   for available ids (e.g. `cursor:gpt-5.2`).
 
+## Model Routing
+
+The `spawn-subagents` skill teaches the orchestrating agent to route each task to the model whose strengths match the work instead of one default model for everything:
+
+- **Bulk token burn goes cheap** — log digging, large specs, migrations, clear-spec implementation.
+- **User-facing output goes tasteful** — public APIs, SDKs, UI copy go to (or are reviewed by) the highest-taste model.
+- **Reviews get the strong model** — cheap models only as an extra perspective, never the sole reviewer.
+- **Defaults, not limits** — redo cheap-model output on a stronger model without asking; judge the output, not the price tag.
+
+If your context files (e.g. a global `AGENTS.md`) define a model routing policy — a table scoring your models on intelligence / taste / cost — the skill treats it as authoritative when picking per-task `model` overrides. Result headers and working messages show which model ran each task (` · model`), so quality is auditable per model.
+
 ## Opinionated Defaults
 
 This package is intentionally opinionated about orchestration:

package/extensions/subagent/index.ts

@@ -670,7 +670,11 @@ export default function (pi: ExtensionAPI) {
             : undefined;
 
           if (ctx.hasUI) {
-            ctx.ui.setWorkingMessage(`Chain step ${i + 1}/${params.chain.length}: ${step.agent}`);
+            const stepModel =
+              step.model ?? params.model ?? agents.find((a) => a.name === step.agent)?.model;
+            ctx.ui.setWorkingMessage(
+              `Chain step ${i + 1}/${params.chain.length}: ${step.agent}${stepModel ? ` · ${stepModel}` : ''}`,
+            );
           }
 
           const result = await runSingleAgent(
@@ -750,10 +754,12 @@ export default function (pi: ExtensionAPI) {
 
         // Initialize placeholder results
         for (let i = 0; i < params.tasks.length; i++) {
+          const t = params.tasks[i];
           allResults[i] = {
-            agent: params.tasks[i].agent,
+            agent: t.agent,
             agentSource: 'unknown',
-            task: params.tasks[i].task,
+            task: t.task,
+            model: t.model ?? params.model ?? agents.find((a) => a.name === t.agent)?.model,
             exitCode: -1, // -1 = still running
             messages: [],
             stderr: '',
@@ -840,7 +846,10 @@ export default function (pi: ExtensionAPI) {
 
       if (params.agent && params.task) {
         if (ctx.hasUI) {
-          ctx.ui.setWorkingMessage(`Running agent: ${params.agent}`);
+          const singleModel = params.model ?? agents.find((a) => a.name === params.agent)?.model;
+          ctx.ui.setWorkingMessage(
+            `Running agent: ${params.agent}${singleModel ? ` · ${singleModel}` : ''}`,
+          );
         }
 
         const result = await runSingleAgent(
@@ -973,7 +982,7 @@ export default function (pi: ExtensionAPI) {
 
         if (expanded) {
           const container = new Container();
-          let header = `${icon} ${theme.fg('toolTitle', theme.bold(r.agent))}${theme.fg('muted', ` (${r.agentSource})`)}`;
+          let header = `${icon} ${theme.fg('toolTitle', theme.bold(r.agent))}${r.model ? theme.fg('dim', ` · ${r.model}`) : ''}${theme.fg('muted', ` (${r.agentSource})`)}`;
           if (isError && r.stopReason) header += ` ${theme.fg('error', `[${r.stopReason}]`)}`;
           container.addChild(new Text(header, 0, 0));
           if (isError && r.errorMessage)
@@ -1010,7 +1019,7 @@ export default function (pi: ExtensionAPI) {
           return container;
         }
 
-        let text = `${icon} ${theme.fg('toolTitle', theme.bold(r.agent))}${theme.fg('muted', ` (${r.agentSource})`)}`;
+        let text = `${icon} ${theme.fg('toolTitle', theme.bold(r.agent))}${r.model ? theme.fg('dim', ` · ${r.model}`) : ''}${theme.fg('muted', ` (${r.agentSource})`)}`;
         if (isError && r.stopReason) text += ` ${theme.fg('error', `[${r.stopReason}]`)}`;
         if (isError && r.errorMessage) text += `\n${theme.fg('error', `Error: ${r.errorMessage}`)}`;
         else if (displayItems.length === 0) text += `\n${theme.fg('muted', '(no output)')}`;
@@ -1065,7 +1074,7 @@ export default function (pi: ExtensionAPI) {
             container.addChild(new Spacer(1));
             container.addChild(
               new Text(
-                `${theme.fg('muted', `─── Step ${r.step}: `) + theme.fg('accent', r.agent)} ${rIcon}`,
+                `${theme.fg('muted', `─── Step ${r.step}: `) + theme.fg('accent', r.agent)}${r.model ? theme.fg('dim', ` · ${r.model}`) : ''} ${rIcon}`,
                 0,
                 0,
               ),
@@ -1115,7 +1124,7 @@ export default function (pi: ExtensionAPI) {
         for (const r of details.results) {
           const rIcon = r.exitCode === 0 ? theme.fg('success', '✓') : theme.fg('error', '✗');
           const displayItems = getDisplayItems(r.messages);
-          text += `\n\n${theme.fg('muted', `─── Step ${r.step}: `)}${theme.fg('accent', r.agent)} ${rIcon}`;
+          text += `\n\n${theme.fg('muted', `─── Step ${r.step}: `)}${theme.fg('accent', r.agent)}${r.model ? theme.fg('dim', ` · ${r.model}`) : ''} ${rIcon}`;
           if (displayItems.length === 0) text += `\n${theme.fg('muted', '(no output)')}`;
           else text += `\n${renderDisplayItems(displayItems, 5)}`;
         }
@@ -1156,7 +1165,11 @@ export default function (pi: ExtensionAPI) {
 
             container.addChild(new Spacer(1));
             container.addChild(
-              new Text(`${theme.fg('muted', '─── ') + theme.fg('accent', r.agent)} ${rIcon}`, 0, 0),
+              new Text(
+                `${theme.fg('muted', '─── ') + theme.fg('accent', r.agent)}${r.model ? theme.fg('dim', ` · ${r.model}`) : ''} ${rIcon}`,
+                0,
+                0,
+              ),
             );
             container.addChild(
               new Text(theme.fg('muted', 'Task: ') + theme.fg('dim', r.task), 0, 0),
@@ -1204,7 +1217,7 @@ export default function (pi: ExtensionAPI) {
                 ? theme.fg('success', '✓')
                 : theme.fg('error', '✗');
           const displayItems = getDisplayItems(r.messages);
-          text += `\n\n${theme.fg('muted', '─── ')}${theme.fg('accent', r.agent)} ${rIcon}`;
+          text += `\n\n${theme.fg('muted', '─── ')}${theme.fg('accent', r.agent)}${r.model ? theme.fg('dim', ` · ${r.model}`) : ''} ${rIcon}`;
           if (displayItems.length === 0)
             text += `\n${theme.fg('muted', r.exitCode === -1 ? '(running...)' : '(no output)')}`;
           else text += `\n${renderDisplayItems(displayItems, 5)}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dreki-gg/pi-subagent",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Subagent tool and direct agent runs for pi — isolated agents, parallel scouts, manager workflows, and bundled prompts",
   "keywords": [
     "pi-package"

package/prompts/advisor.md

@@ -3,7 +3,7 @@ name: advisor
 description: Focused second-opinion consult for tricky planning, implementation, or review decisions
 tools: read, grep, find, ls
 model: anthropic/claude-opus-4-6
-thinking: low
+thinking: high
 ---
 
 You are an advisor.

package/prompts/bug-prover.md

@@ -3,7 +3,7 @@ name: bug-prover
 description: Create the smallest failing repro for a suspected bug. Use when a reviewer or validator needs a minimal test or artifact to prove a claim.
 tools: read, grep, find, ls, bash, edit, write
 model: anthropic/claude-opus-4-6
-thinking: low
+thinking: high
 sessionStrategy: fork-at
 ---
 

package/prompts/docs-scout.md

@@ -2,7 +2,7 @@
 name: docs-scout
 description: Documentation scout that uses Context7 first, then summarizes the relevant implementation details
 tools: context7_resolve_library_id, context7_get_library_docs, context7_get_cached_doc_raw, read, grep, find, ls
-model: openai/gpt-5.4-mini
+model: openai/gpt-5.6-luna
 thinking: low
 ---
 

package/prompts/planner.md

@@ -3,7 +3,7 @@ name: planner
 description: Creates implementation plans from context and requirements
 tools: read, grep, find, ls, subagent
 model: anthropic/claude-opus-4-6
-thinking: medium
+thinking: high
 ---
 
 You are a planning specialist. You receive context (from a scout) and requirements, then produce a clear implementation plan.

package/prompts/reviewer.md

@@ -3,7 +3,7 @@ name: reviewer
 description: Code review specialist for quality and security analysis
 tools: read, grep, find, ls, bash, subagent
 model: anthropic/claude-opus-4-6
-thinking: low
+thinking: high
 sessionStrategy: fork-at
 ---
 

package/prompts/scout.md

@@ -2,7 +2,7 @@
 name: scout
 description: Fast codebase recon that returns compressed context for handoff to other agents
 tools: read, grep, find, ls, bash
-model: openai/gpt-5.4-mini
+model: openai/gpt-5.6-luna
 thinking: low
 ---
 

package/prompts/ux-designer.md

@@ -3,7 +3,7 @@ name: ux-designer
 description: Frontend UI designer that produces clean, human-designed interfaces — anti-Codex aesthetic
 tools: read, grep, find, ls
 model: anthropic/claude-opus-4-6
-thinking: low
+thinking: high
 ---
 
 You are a frontend UX designer agent. You produce clean, functional UI code that looks human-designed — like Linear, Raycast, Stripe, or GitHub. You exist to counter the default AI aesthetic.

package/prompts/validator.md

@@ -3,7 +3,7 @@ name: validator
 description: Validate or falsify a specific bug, regression, or behavior claim from code, tests, and commands. Use when a review finding needs evidence before it becomes a fix request.
 tools: read, grep, find, ls, bash
 model: anthropic/claude-opus-4-6
-thinking: low
+thinking: high
 ---
 
 You are a validator.

package/skills/spawn-subagents/SKILL.md

@@ -26,6 +26,8 @@ Strong triggers:
 - "ask advisor for a second opinion on this"
 - "validate whether this review finding is real"
 - "prove this bug with a minimal failing test"
+- "route this to the cheap model"
+- "use the right model for each piece"
 
 Patterns:
 
@@ -114,13 +116,33 @@ Avoid:
 - calling `advisor` when `planner` or `reviewer` already has enough signal to proceed alone
 - sending speculative review findings back for fixes before they are validated when evidence is needed
 
-## 8. Agent discovery and creation
+## 8. Model routing
+Route each subagent task to the model whose strengths match the work, not to one default model for everything.
+
+Policy source:
+- If the user's context files (AGENTS.md or equivalent) define a model routing policy — a table scoring models on axes like intelligence, taste, and cost — that policy is authoritative. Apply it when picking `model` overrides for `single` / `parallel` / `chain` tasks.
+- Without a user policy, use the agent prompt's default model and these structural rules.
+
+Structural rules (harness-independent):
+- **Bulk token burn goes cheap.** Log digging, reading large files/specs/PDFs, data analysis, mechanical migrations, and clear-spec implementation belong on the cheapest capable model.
+- **User-facing output goes tasteful.** Public APIs, SDKs, UI copy, and design decisions go to the highest-taste model, or are reviewed by it before shipping.
+- **Reviews get the strong model.** Plan and implementation reviews run on the strongest model; a cheap model may be added as an extra independent perspective, never as the only reviewer.
+- **Defaults, not limits.** If a cheaper model's output does not meet the bar, rerun the task on a stronger model without asking. Judge the output, not the price tag — escalating costs less than shipping mediocre work.
+- **Cost is a tiebreaker only.** Use cheap models to gather information before engaging an expensive one, never to avoid it.
+- **Name the model.** When reporting delegated work back, say which model ran each task so quality can be judged per model.
+
+Mechanics:
+- Pass `model` per task/step (e.g. `{ agent: "worker", task: "…", model: "cursor:composer-2.5" }`) or once per call as a default for all tasks.
+- `cursor:<model>` routes through Cursor's agent via ACP — useful as a distinct cheap/fast implementation backend.
+
+## 9. Agent discovery and creation
 Use `list_agents` before spawning when you're unsure which agents exist.
 Use `/create-agent <name> [description]` to scaffold a new project-local agent in `.pi/prompts/` when the user needs a custom agent that doesn't exist yet.
 - After creating, read and refine the prompt file to fit the use case.
 - Remember to use `agentScope: "both"` or `"project"` to include project-local agents.
 
 Execution rules:
+- Route each task to the model whose strengths match the work; honor the user's model routing policy when one exists (section 8).
 - Use `manager` when the task is too large for one prompt but still needs coherent decisions.
 - Use `advisor` for targeted second opinions on tricky or high-risk cases.
 - Use `validator` to confirm a claim before escalating it as a fix.