@dombaras/agent-harness 0.1.7 → 0.1.9

package/README.md

@@ -34,10 +34,11 @@ npx @dombaras/agent-harness init --target . --dry-run
 | Path | Content | Ownership |
 |---|---|---|
 | `AGENTS.md` | root dispatcher (points to the rulebook) | harness (overwrite) |
-| `.opencode/agents/*.md` | 13 persona subagent defs (with `model:` pins + `permission`/`steps`/`temperature`/`hidden`) | harness (overwrite) |
+| `.opencode/agents/*.md` | 14 persona subagent defs (with `model:` pins + `permission`/`steps`/`temperature`/`hidden`) | harness (overwrite) |
 | `.agents/AGENTS.md` | full canonical operating rulebook | harness (overwrite) |
 | `.agents/rules/00-operating.md` | always-loaded rules summary (wired into `opencode.json` `instructions`) | harness (overwrite) |
 | `.agents/skills/*/SKILL.md` | persona instruction skills | harness (overwrite) |
+| `.agents/features/INDEX.md` | feature backlog + status board (durable feature doc tree root) | **project** (create-if-missing) |
 | `opencode.json` | main/small model routing + `instructions` | harness (**merged**, see below) |
 | `scripts/qa/*` | `test:dispatch` / `test:governance` / `test:qa-plan` gates + QA-script wiring check | harness (overwrite) |
 | `.agents/memory/*` | project data (domain-map, stack-versions, handoff, locations, model-routing, history, flow-map, qa-plan) | **project** (create-if-missing) |
@@ -59,6 +60,17 @@ tiers, trust tiers) live in `.agents/memory/domain-map.md`, which `init`
 scaffolds for you to fill in — the skills and rules reference memory instead of
 hardcoding domain assumptions.
 
+**Features (`.agents/features/`)** — the durable, feature-centric plan of record. A
+found item is captured as one light row in `.agents/features/INDEX.md` (backlog: what's
+known, priority, context, status). When a feature is picked up, the `features` persona
+authors the per-feature doc chain (`.agents/features/<slug>/`), each layer routed to its
+author persona — `intent.md` (product-manager) → `scope.md` (system-architect, HIGH-risk
+only) → `plan.md` (planner) → `tests.md` (qa-architect, points to `qa-plan.md`). Ceremony
+is right-sized to blast radius: trivial → none, low → single `intent.md`, high (auth/DB/
+public API/flow-siblings) → full chain. Docs live beside the code, are written-back before
+continuing when implementation invalidates them, and are archived on ship. See
+`.agents/skills/features/SKILL.md`.
+
 **Flow map (`.agents/memory/flow-map.md`)** — the project-owned registry powering the
 flow-closure half of `test:qa-plan`. Each user-facing flow lists the code surfaces that
 implement the same behavior across codebases/layers (e.g. web component, `mobile/` sheet,
@@ -86,6 +98,14 @@ warns but does not block; the guarantee only applies to registered flows.
 - `npm run test:dispatch` mechanically verifies model pins against
   `scripts/qa/models.allowlist.txt` and that `model-routing.md` does not name a
   stale model no longer pinned anywhere (doc↔config drift).
+- **`/switch-model` command** — every deploy ships an opencode command
+  (`.opencode/command/switch-model.md`) plus `scripts/switch-reasoning-model.ps1`
+  that rewrites the main `opencode.json` `model` and the six reasoning-tier
+  agents (planner, system-architect, security-engineer, diagnostics-expert,
+  product-manager, qa-architect) in one step. Aliases: `deepseek`/`direct` →
+  `deepseek/deepseek-v4-pro` (default, direct API key), `zen`/`opencode` →
+  `opencode/deepseek-v4-pro` (gateway), `pickle` → `opencode/big-pickle`, or any
+  explicit `provider/model`. Restart opencode after switching (config reads once).
 
 ## QA gates
 

package/bin/agent-harness.js

@@ -15,7 +15,7 @@
  * PROJECT_NAME }} / {{ PROJECT_DOMAIN }}.
  *
  * Ownership model:
- *   - `.agents/memory/*` is project data -> create-if-missing (never overwrite).
+ *   - `.agents/memory/*` + `.agents/features/*` is project data -> create-if-missing (never overwrite).
  *   - `opencode.json` is MERGED: harness manages $schema/model/small_model/
  *     instructions; every other key the project adds is preserved.
  *   - all other harness-owned files are overwritten. If a harness-owned file was
@@ -89,9 +89,19 @@ function relKey(rel) {
   return rel.split(path.sep).join("/");
 }
 
-function isMemoryFile(rel) {
+/* `.agents/memory/*` (session memory) and `.agents/features/*` (feature doc
+ * tree) are project data — scaffolded create-if-missing, never overwritten,
+ * and never tracked in the manifest, exactly like the memory files. */
+function isProjectScaffold(rel) {
   const parts = rel.split(path.sep);
-  return parts.includes(".agents") && parts.includes("memory");
+  return (
+    parts.includes(".agents") &&
+    (parts.includes("memory") || parts.includes("features"))
+  );
+}
+/* Back-compat alias (kept for any external caller referencing the old name). */
+function isMemoryFile(rel) {
+  return isProjectScaffold(rel);
 }
 
 function isOpencodeJson(rel) {
@@ -340,7 +350,7 @@ async function deploy(target, opts) {
       continue;
     }
 
-    if (isMemoryFile(rel)) {
+    if (isProjectScaffold(rel)) {
       if (fs.existsSync(targetAbs)) {
         actions.push({ rel: key, kind: "preserve" });
       } else {
@@ -403,7 +413,10 @@ async function deploy(target, opts) {
   let commitResult = null;
   if (isUpdate && !dryRun && !nothingToUpdate) {
     const changedRels = changedRelsAll.filter(
-      (r) => !r.startsWith(".agents/memory/") && !r.startsWith(".harness-backup/")
+      (r) =>
+        !r.startsWith(".agents/memory/") &&
+        !r.startsWith(".agents/features/") &&
+        !r.startsWith(".harness-backup/")
     );
     changedRels.push(CONFIG_FILE); // .harness.json reflects the new deployed version
     commitResult = commitHarnessChanges(target, changedRels, {
@@ -460,7 +473,9 @@ function printSummary(result, isUpdate) {
 
 /* Best-effort warning: when this CLI's version is not the latest published on
  * the registry, flag it. This catches the "bumped + ran update from a local
- * checkout, but never published" silent gap. */
+ * checkout, but never published" silent gap. Publish guidance stays inline so a
+ * failed `npm publish` (401/404 auth/permission) never leaves the developer
+ * staring at a raw npm error — it points them at `npm login`. */
 function printUnpublishedWarning() {
   const published = publishedLatestVersion();
   if (published == null || published === "" || published === PKG.version) return;
@@ -472,6 +487,12 @@ function printUnpublishedWarning() {
       `NOT published — Publish first, then \`update\` other projects, or they will ` +
       `branch off an older harness.`
   );
+  console.log(
+    `    To publish: run \`npm publish\` from the harness repo. If it fails with ` +
+      `E401/E404 (auth or permission), you are not logged in as the package owner ` +
+      `(\`npm owner ls ${PKG.name}\` shows who owns it) — run \`npm login\` first, ` +
+      `then publish again. Login: https://www.npmjs.com/login`
+  );
 }
 
 function printNextSteps() {
@@ -481,7 +502,9 @@ function printNextSteps() {
   console.log("      test:qa-plan enforces their sibling-surface/variant closure).");
   console.log("   2. Harness gate scripts (`test:dispatch`, `test:governance`, `test:qa-plan`) were");
   console.log('      auto-wired into package.json "scripts".');
-  console.log("   3. Restart your agent CLI (config is read once at startup).\n");
+  console.log("   3. Capture found items as rows in `.agents/features/INDEX.md`; dispatch the `features`");
+  console.log("      persona to author the per-feature doc chain when one is picked up.");
+  console.log("   4. Restart your agent CLI (config is read once at startup).\n");
 }
 
 function printUsage() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dombaras/agent-harness",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Reusable multi-agent harness for AI-assisted development: personas, skills, operating rules, model routing, and QA gates. Deploy into any project with `npx @dombaras/agent-harness init`.",
   "bin": {
     "agent-harness": "bin/agent-harness.js"

package/templates/.agents/AGENTS.md

@@ -55,6 +55,16 @@ The canonical rulebook. The always-loaded summary is `.agents/rules/00-operating
     | Data ingestion / entity resolution | `data-engineer` |
     | Deployment / cron / secrets / build+release | `devops-engineer` |
     | Session wrap-up / handoff | `handoff` |
+    | Feature backlog + per-feature doc tree (intent/scope/plan/tests) | `features` |
+  - **Feature docs, not ceremony**: capture a found item as one light row in
+    `.agents/features/INDEX.md` (backlog). When a feature is picked up, dispatch
+    `features` to author the doc chain — `intent` (product-manager) → `scope`
+    (system-architect, HIGH-risk only) → `plan` (planner) → `tests` (qa-architect) —
+    each by its author persona. Match ceremony to blast radius: trivial → none,
+    low → single `intent.md`, high (auth/DB/API/flow-siblings) → full chain. Write
+    back first (update the doc before continuing when implementation invalidates it),
+    archive on ship. Feature docs are durable and complementary to the per-session
+    `qa-plan.md`/`handoff.md`; the `tests` doc points to `qa-plan.md`, never duplicates it.
   - **QA planning is never optional (no silent skip)**: every change that touches
     code paths MUST get a QA plan before it is verified. The plan is authored by
     `qa-architect` (thinker). If `qa-architect` is not dispatched — for ANY reason,

package/templates/.agents/features/INDEX.md

@@ -0,0 +1,22 @@
+# Features — backlog & status board
+
+Project-owned (like all `.agents/features/*`). This is the **collection box**, not a
+spec and not a status board. Every found item gets one terse row here; the per-feature
+doc chain (`.agents/features/<slug>/` intent · scope · plan · tests) is written only
+when the main agent focuses on the feature. Keep rows ultra-light — a note, not a promise.
+
+Maintained by the `features` persona (`.agents/skills/features/SKILL.md`).
+
+## Backlog
+
+One row per found item. `Status`: `backlog → ready → in-progress → testing → shipped → archived`.
+
+| ID | Item (what's known so far) | Priority | Context | Status |
+|----|----------------------------|----------|---------|--------|
+| F-001 | _replace: short, only-what-is-known description; open questions with `?`_ | P3 | _pointer to evidence (file/log/ticket/words), not a re-derivation_ | backlog |
+
+<!-- Add rows as items surface. Never invent status or priority — leave blank/`?` if unknown. -->
+
+## Active / next
+
+- _when a feature is about to be worked, cite it here and route the docs to the author personas (see skill)._

package/templates/.agents/memory/model-routing.md

@@ -27,6 +27,7 @@ frontmatter:
 - **Thinkers** (`planner`, `product-manager`) have `permission: { edit: deny, bash: deny }`.
 - **`qa-architect`** has `permission: { bash: deny }` (authors tests, never runs).
 - **`handoff`** has `permission: { bash: deny }`.
+- **`features`** (Feature Registrar) has `permission: { bash: deny }` — owns `.agents/features/*` (backlog + per-feature docs), routes each doc layer to its author persona.
 - **Code personas** (`frontend-engineer`, `mobile-engineer`, `ui-designer`,
   `data-engineer`, `devops-engineer`, `security-engineer`, `system-architect`,
   `diagnostics-expert`) allow `edit` everywhere except governance/harness paths

package/templates/.agents/rules/00-operating.md

@@ -11,6 +11,7 @@ Before reading or editing any file for a task, dispatch the relevant personas vi
 - **Accept, don't trust.** After a code persona reports done, the orchestrator re-runs the gate itself (`tsc --noEmit`, `lint:hooks`, `test:quick`) and greps the metric before integrating — a subagent's `Evidence` is a claim, not proof.
 - **QA planning is never optional.** Every change touching code paths gets a QA plan (coverage map in `.agents/memory/qa-plan.md`) from `qa-architect`; if it isn't dispatched, the main orchestrator plans in its place. `npm run test:qa-plan` fails on any changed code path with no covering assertion or waiver, and on any touched flow (`.agents/memory/flow-map.md`) whose sibling surfaces / declared variants the plan doesn't address.
 - Persona map, waivers, and the dispatch-failure ladder: `.agents/AGENTS.md` §5 and `.agents/memory/model-routing.md`.
+- **Features**: capture a found item as one light row in `.agents/features/INDEX.md`; on pickup dispatch `features` to author the per-feature doc chain (`.agents/skills/features/SKILL.md`). Right-size ceremony to risk.
 - Every subagent returns the output contract (`Result` → `Evidence` → `Deferred & risks`).
 - Wrap up with a **dispatch log** (`subagent → model → shipped/deferred`) in `.agents/memory/handoff.md`.
 

package/templates/.agents/skills/features/SKILL.md

@@ -0,0 +1,103 @@
+---
+name: features
+description: Use when the user asks to capture a found item, register a feature, manage the feature backlog, or prepare a feature for implementation — owns the .agents/features/ doc tree (INDEX + per-feature intent/scope/plan/tests).
+model: mechanical
+---
+
+# Features — backlog & per-feature doc tree
+
+You are the Feature Registrar for {{PROJECT_NAME}}. You keep the
+`.agents/features/` tree as the durable, feature-centric plan of record — the
+backlog of found items plus, once a feature is picked up, the intent → scope →
+plan → tests docs that frame it. You coordinate the authors; you do NOT pull the
+implementation work onto yourself (that is dispatched to the code personas).
+
+The doc tree is **complementary** to the session memory (`.agents/memory/*`):
+features are durable and survive across sessions; `handoff.md`/`qa-plan.md` track
+per-session execution. Link between them, never duplicate.
+
+## Two layers — do not cross them
+
+| Layer | What it is | Weight |
+|---|---|---|
+| **Backlog** (`.agents/features/INDEX.md`) | collection box of found items — one short row per item (what's known, priority, context, status). NOT a spec, NOT a status board. | ultra-light — every item gets one |
+| **Feature docs** (`.agents/features/<slug>/` intent · scope · plan · tests) | the contract, written ONLY when the main agent focuses on the feature. | right-sized to risk |
+
+A found item is **only** ever a backlog row until it is picked up. Do not
+pre-write the full chain for every item — that is exactly what turns this into
+the heavy SDLC the harness is designed to avoid.
+
+## Tree layout
+
+```
+.agents/features/
+  INDEX.md                 # backlog + status board (one row per item)
+  <slug>/
+    intent.md              # what & why, boundaries, acceptance criteria (1 pager)
+    scope.md               # optional — only on HIGH-risk features
+    plan.md                # implementation decomposition (HOW)
+    tests.md               # intent-level acceptance + pointer to qa-plan.md
+  archive/                 # completed feature dirs moved here
+```
+
+Save docs beside the code they describe; keep them in the same commit as the
+code that implements them so a feature's intent and its delivery cannot drift.
+
+## Backlog — `.agents/features/INDEX.md`
+
+One row per found item. Add a row when the user brings up a new idea/need/bug
+that is not yet being worked. Fields (keep each terse):
+
+- **What's known so far** — only what is actually known; mark open questions with `?`.
+- **Priority** — `P0` (blocking) / `P1` (important) / `P2` (nice-to-have) / `P3` (backlog).
+- **Context** — a pointer to evidence (file, log, ticket, the user's words), never a re-derivation.
+- **Status** — `backlog → ready → in-progress → testing → shipped → archived`.
+
+Never invent status or priority. If a field is unknown, leave it blank or `?` and
+say so; the row is a note, not a promise.
+
+## Feature lifecycle (when the main agent focuses on a feature)
+
+Pick the ready item from `INDEX.md`, then author the docs **by routing each layer
+to the correct persona** via the `task` tool (Step Zero dispatch — see
+`.agents/rules/00-operating.md` §Step Zero):
+
+| Doc | Frames | Author persona (dispatch) |
+|---|---|---|
+| `intent.md` | WHAT & WHY: outcomes, boundaries/out-of-scope, acceptance criteria, open questions | `product-manager` |
+| `scope.md` | technical constraints, blast radius, data-model/API impact | `system-architect` (only on HIGH-risk features) |
+| `plan.md` | HOW: ordered steps, owned files, per-step verification, commit boundaries | `planner` |
+| `tests.md` | intent-level acceptance — the minimal tier + progression tests; **points to** `.agents/memory/qa-plan.md`, never duplicates it | `qa-architect` |
+
+### Right-size the ceremony to blast radius
+
+- **Trivial** (copy/docs, CSS tweak, single-file bug, anything a human would fix
+  in <30 minutes): no feature docs. Optionally note it in `INDEX.md` and close it.
+- **Low risk** (touches few files, no auth/DB/API contract): ONE `intent.md`
+  (what & why, boundaries, acceptance) is enough. Fold scope into it.
+- **High risk** (auth/security, DB schema/migration, public API, payments, a flow
+  with cross-surface siblings from `.agents/memory/flow-map.md`): full chain —
+  `intent.md` + `scope.md` + `plan.md` + `tests.md`.
+
+Split `scope.md` out of `intent.md` only when the feature earns it (above). Two
+docs restating the same boundary is drift surface, not rigor.
+
+## Keeping docs current (non-negotiable)
+
+- **Write back first, then continue.** If implementation invalidates any doc,
+  update the doc BEFORE coding continues. A stale spec is worse than none.
+- **Archive when it ships.** Move `.agents/features/<slug>/` to `archive/` and
+  mark the `INDEX.md` row `shipped`/`archived`. Do not leave a pile of completed
+  designs cluttering the live tree.
+- Each doc starts with a `status:` line (`proposed → scoped → planned → testing →
+  shipped → archived`) so an agent knows validity without reading the whole file.
+- When implementation drifts from a doc, fix the implementation to match the
+  doc; when the doc is genuinely wrong, update the doc explicitly (with a one-line
+  note in `INDEX.md`), then regenerate the derived layers — never let the code
+  and the doc mutely diverge.
+
+## Output contract (always return)
+
+1. **Backlog delta** — items added / status changes, in `.agents/features/INDEX.md`.
+2. **Docs authored** — which feature docs were created/updated, by which dispatched persona.
+3. **Deferred & risks** — features parked, open questions, and what the orchestrator must route next.

package/templates/.opencode/agents/diagnostics-expert.md

@@ -1,7 +1,7 @@
 ---
 description: Use when debugging errors, performance regressions, or API anomalies — log-first investigation, ExternalServiceLog, cold-start profiling, authentic reproduction.
 mode: subagent
-model: opencode/deepseek-v4-pro
+model: deepseek/deepseek-v4-pro
 temperature: 0.1
 steps: 30
 permission:

package/templates/.opencode/agents/features.md

@@ -0,0 +1,20 @@
+---
+description: Use when the user asks to capture a found item, register/manage a feature, or prepare a feature for implementation — owns the .agents/features/ doc tree (INDEX backlog + per-feature intent/scope/plan/tests) and routes each layer to its author persona.
+mode: subagent
+model: opencode/gpt-5-nano
+temperature: 0.1
+steps: 15
+hidden: true
+permission:
+  bash: deny
+---
+
+You are the {{PROJECT_NAME}} Feature Registrar. Read and follow the complete persona instructions in `.agents/skills/features/SKILL.md`, then carry out the task.
+
+## Scope & integrity (non-negotiable)
+
+- Edit ONLY `.agents/features/*` (the INDEX backlog and per-feature doc dirs, including `archive/`). `opencode.json`, `.agents/memory/*`, `.agents/rules/*`, `.agents/skills/*`, other personas' files, and all code are READ-ONLY absent an explicit orchestrator grant.
+- You coordinate authors; you do NOT implement. When a feature doc layer needs writing, dispatch the owning persona (`product-manager`, `system-architect`, `planner`, `qa-architect`) via the `task` tool and route its output into the doc tree. Never fabricate a doc, a status, or a backlog row that has no basis in what was actually said or done.
+- Keep the two layers separate: every found item is a light `INDEX.md` row until it is picked up; the full doc chain is written only when the main agent focuses on the feature. Right-size ceremony to risk (trivial → none, low → `intent.md` only, high → full chain).
+
+Return your final message in this exact order: **Result** (backlog delta + docs authored) -> **Evidence** (files changed, personas dispatched, observed output) -> **Deferred & risks** (features parked, open questions, next routing). Keep it under ~15 lines.

package/templates/.opencode/agents/planner.md

@@ -1,7 +1,7 @@
 ---
 description: Use to plan/decompose a task and emit the Step Zero subagent dispatch plan (personas, models, order, parallel batches) before any file is touched.
 mode: subagent
-model: opencode/deepseek-v4-pro
+model: deepseek/deepseek-v4-pro
 temperature: 0.1
 steps: 15
 hidden: true

package/templates/.opencode/agents/product-manager.md

@@ -1,7 +1,7 @@
 ---
 description: Use when designing features, gamification, or user journeys — maps DB logic to UX with the 5 UI states.
 mode: subagent
-model: opencode/deepseek-v4-pro
+model: deepseek/deepseek-v4-pro
 steps: 20
 permission:
   edit: deny

package/templates/.opencode/agents/qa-architect.md

@@ -1,7 +1,7 @@
 ---
 description: Use to design the QA plan for a change — inspects the diff, assesses risk, selects the minimal tier, and authors progression tests (thinker only; does not run suites).
 mode: subagent
-model: opencode/deepseek-v4-pro
+model: deepseek/deepseek-v4-pro
 temperature: 0.1
 steps: 20
 permission:

package/templates/.opencode/agents/security-engineer.md

@@ -1,7 +1,7 @@
 ---
 description: Use when a change touches auth, secrets, input validation, external services, or dependencies — security review + audit.
 mode: subagent
-model: opencode/deepseek-v4-pro
+model: deepseek/deepseek-v4-pro
 steps: 30
 permission:
   edit:

package/templates/.opencode/agents/system-architect.md

@@ -1,7 +1,7 @@
 ---
 description: Use when changing the Prisma schema, data model, multi-tenant boundaries, privacy tiers, or sync protocol.
 mode: subagent
-model: opencode/deepseek-v4-pro
+model: deepseek/deepseek-v4-pro
 steps: 40
 permission:
   edit:

package/templates/.opencode/command/switch-model.md

@@ -0,0 +1,25 @@
+---
+description: Switch the reasoning-tier model (default deepseek/deepseek-v4-pro direct).
+---
+
+Change the reasoning-tier model to `$ARGUMENTS`.
+
+Valid values:
+- `deepseek` / `direct` (default) -> `deepseek/deepseek-v4-pro` (direct API key)
+- `zen` / `opencode` -> `opencode/deepseek-v4-pro` (Zen gateway)
+- `pickle` / `big-pickle` -> `opencode/big-pickle`
+- any other explicit model id (e.g. `opencode/gpt-5.6-luna`)
+
+Run:
+
+```
+powershell -ExecutionPolicy Bypass -File scripts/switch-reasoning-model.ps1 -Target $ARGUMENTS
+```
+
+This rewrites the `model` field in `opencode.json` and the `model:` frontmatter
+of the six reasoning-tier agents (planner, system-architect, security-engineer,
+diagnostics-expert, product-manager, qa-architect).
+
+Report the old model -> new model delta, and remind the user that opencode
+does not hot-reload config, so they must quit and restart for it to take
+effect.

package/templates/AGENTS.md

@@ -5,6 +5,7 @@ The always-loaded rules summary lives in [`.agents/rules/00-operating.md`](.agen
 It governs: Step Zero subagent dispatch, zero-speculation debugging, data integrity, UI/RTL ergonomics, stack-version discipline, token efficiency, right-sized QA tiers, and the commit-and-push gate.
 
 - **Dispatch personas** via the `task` tool (see `.agents/rules/00-operating.md` §Step Zero); consult the relevant `.agents/skills/<persona>/SKILL.md`.
+- **Features**: capture a found item as one light row in `.agents/features/INDEX.md` (backlog). When a feature is picked up, dispatch the `features` persona to author the per-feature doc chain (intent/scope/plan/tests), each layer routed to its author persona — see `.agents/skills/features/SKILL.md`.
 - **Every change touching code paths gets a QA plan** (`.agents/memory/qa-plan.md`) from `qa-architect` — if it isn't dispatched, the main orchestrator plans in its place. `npm run test:qa-plan` fails on any changed code path with no covering assertion or waiver, and on any touched flow (`.agents/memory/flow-map.md`) whose sibling surfaces / declared variants the plan doesn't address.
 - **At session start**, read `.agents/memory/locations.md` and `.agents/memory/model-routing.md`.
 

package/templates/opencode.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://opencode.ai/config.json",
-  "model": "opencode/deepseek-v4-pro",
+  "model": "deepseek/deepseek-v4-pro",
   "small_model": "opencode/gpt-5-nano",
   "instructions": [".agents/rules/00-operating.md"]
 }

package/templates/scripts/switch-reasoning-model.ps1

@@ -0,0 +1,70 @@
+param(
+  [Parameter(Mandatory = $true)][string]$Target
+)
+
+$ErrorActionPreference = "Stop"
+
+$root = Split-Path -Parent $PSScriptRoot
+
+$aliases = @{
+  "deepseek"       = "deepseek/deepseek-v4-pro"
+  "deepseek-v4-pro" = "deepseek/deepseek-v4-pro"
+  "direct"         = "deepseek/deepseek-v4-pro"
+  "zen"            = "opencode/deepseek-v4-pro"
+  "opencode"       = "opencode/deepseek-v4-pro"
+  "big-pickle"     = "opencode/big-pickle"
+  "pickle"         = "opencode/big-pickle"
+  "bigpickle"      = "opencode/big-pickle"
+}
+
+$targetModel = $Target
+if ($aliases.ContainsKey($Target.ToLowerInvariant())) {
+  $targetModel = $aliases[$Target.ToLowerInvariant()]
+}
+elseif (-not ($targetModel -match "^[a-zA-Z0-9._-]+/")) {
+  $targetModel = "deepseek/$targetModel"
+}
+
+$reasoningModels = @(
+  "deepseek/deepseek-v4-pro",
+  "opencode/deepseek-v4-pro",
+  "opencode/big-pickle"
+)
+
+$files = @(
+  "opencode.json",
+  ".opencode/agents/planner.md",
+  ".opencode/agents/system-architect.md",
+  ".opencode/agents/security-engineer.md",
+  ".opencode/agents/diagnostics-expert.md",
+  ".opencode/agents/product-manager.md",
+  ".opencode/agents/qa-architect.md"
+)
+
+$changed = @()
+foreach ($rel in $files) {
+  $path = Join-Path $root $rel
+  if (-not (Test-Path -LiteralPath $path)) {
+    Write-Warning "missing: $rel"
+    continue
+  }
+  $content = Get-Content -LiteralPath $path -Raw
+  $new = $content
+  foreach ($m in $reasoningModels) {
+    $new = $new -replace [regex]::Escape($m), $targetModel
+  }
+  if ($new -ne $content) {
+    Set-Content -LiteralPath $path -Value $new -NoNewline
+    $changed += $rel
+  }
+}
+
+Write-Output ("Switched reasoning-tier model -> {0}" -f $targetModel)
+if ($changed.Count -gt 0) {
+  Write-Output "Updated:"
+  $changed | ForEach-Object { Write-Output "  - $_" }
+}
+else {
+  Write-Output "No files changed (already set)."
+}
+Write-Output "Restart opencode for the change to take effect."