harness-everything 0.30.4 → 0.30.6

package/docs/troubleshooting.md

@@ -9,6 +9,8 @@ This guide helps you resolve common issues with Harness OS installation and usag
 **Symptom:** `EACCES: permission denied` during installation
 
 **Solution:**
+
+POSIX shells / Git Bash:
 ```bash
 # Option 1: Install without sudo (recommended)
 npx github:dyphn1/Harness-everything install
@@ -22,6 +24,12 @@ npm config set prefix '~/.npm-global'
 export PATH=~/.npm-global/bin:$PATH
 ```
 
+Windows PowerShell:
+```powershell
+npx.cmd github:dyphn1/Harness-everything install
+npx.cmd github:dyphn1/Harness-everything install --global
+```
+
 ### Node.js Version Issues
 
 **Symptom:** `SyntaxError` or unsupported engine errors
@@ -93,11 +101,17 @@ which node
 # Check if hooks directory exists
 ls -la hooks/scripts/
 
-# Reinstall Harness
+# Reinstall Harness (POSIX shells / Git Bash)
 npx github:dyphn1/Harness-everything uninstall
 npx github:dyphn1/Harness-everything install
 ```
 
+Windows PowerShell:
+```powershell
+npx.cmd github:dyphn1/Harness-everything uninstall
+npx.cmd github:dyphn1/Harness-everything install
+```
+
 ### Circuit Breaker Tripping Too Often
 
 **Symptom:** `RULE OF 3 CIRCUIT BREAKER TRIGGERED!` frequently
@@ -129,8 +143,13 @@ Do not expect this Claude Code state file merely because Harness skills or an in
    ```
 2. If missing, reinstall with Cursor flag:
    ```bash
+   # POSIX shells / Git Bash
    npx github:dyphn1/Harness-everything install --cursor
    ```
+   ```powershell
+   # Windows PowerShell
+   npx.cmd github:dyphn1/Harness-everything install --cursor
+   ```
 3. Restart Cursor.
 
 ### Copilot Not Following Rules
@@ -156,8 +175,13 @@ Do not expect this Claude Code state file merely because Harness skills or an in
    ```
 2. Reinstall the advisory Codex target if needed:
    ```bash
+   # POSIX shells / Git Bash
    npx github:dyphn1/Harness-everything install --codex
    ```
+   ```powershell
+   # Windows PowerShell
+   npx.cmd github:dyphn1/Harness-everything install --codex
+   ```
 3. Remember that this is the instruction-oriented installer path. It is different from the **local OpenAI plugin** package described below.
 
 ### Codex / local OpenAI plugin not appearing
@@ -192,9 +216,15 @@ The local plugin mechanically injects the session policy and invariant-first rou
 For the native host install/update path, run:
 
 ```bash
+# POSIX shells / Git Bash
 npx github:dyphn1/Harness-everything plugin-sync --json
 ```
 
+```powershell
+# Windows PowerShell
+npx.cmd github:dyphn1/Harness-everything plugin-sync --json
+```
+
 The command installs only when the plugin is absent. An installed Claude plugin uses the explicit Claude update command; an installed Codex plugin uses marketplace upgrade. If plugin state cannot be read, synchronization stops without re-adding or overwriting the plugin.
 
 Host CLIs differ in which options and subcommands they implement, so the synchronizer degrades instead of failing:

package/docs/workflows/fable-mode.md

@@ -36,18 +36,19 @@ stateDiagram-v2
   Recorded --> [*]
 ```
 
-The stage record preserves the requested/effective model, fallback reason, stage brief, artifact, pass condition, verification command, and verifier result.
+The stage record preserves requested/effective behavior profile, profile alias, runtime model/effort when known, runtime-floor status, fallback reason, stage brief, artifact, pass condition, verification command, and verifier result.
 
-## 3. Model Selection and Delegation
+## 3. Behavior Profile and Runtime Recommendation
 
-Explicit model requests are resolved through `model-selector.js`. Fable never silently downgrades a requested model.
+Explicit `haiku`/`sonnet`/`sonnect`/`opus` requests are behavior-profile aliases resolved through `model-selector.js`; they do not pin the host runtime model. Host-specific model floors are advisory and visible.
 
 ```mermaid
 flowchart LR
-  Requested[Requested model] --> Selector[model-selector.js]
-  Selector -->|Available| Named[Named fable agent]
-  Selector -->|Fallback allowed| Fallback[Recorded fallback]
-  Selector -->|No valid fallback| Blocked[Escalate blocked stage]
+  Requested[Requested profile / legacy alias] --> Selector[model-selector.js]
+  Selector --> Role[Named Fable role]
+  Role --> Runtime[Host runtime + advisory model floor]
+  Runtime -->|Meets / below / unknown| Execute[Execute same behavior profile]
+  Role -->|Named agent unavailable| Fallback[Inline or stop fallback]
   Named --> Stage[Bounded stage brief]
   Fallback --> Stage
   Stage --> Verify[Named stage check]
@@ -56,7 +57,7 @@ flowchart LR
   Cold --> Record
 ```
 
-The intended role split is explicit rather than magical: Opus is suitable for orchestration, Sonnet for reasoning-heavy stage work, and Haiku for bounded mechanical work. Workers do not spawn workers.
+The role split is explicit: `opus` aliases the orchestrator profile, `sonnet` aliases reasoning, and `haiku` aliases mechanical work. These names describe Fable behavior; actual Claude/Codex model choice is a separate host concern. Workers do not spawn workers.
 
 ## 4. Scope and Context Discipline
 
@@ -89,4 +90,4 @@ At most two full replans are allowed before unresolved blockers are escalated ra
 
 Fable completion means the planned stages have produced their artifacts, their checks have passed, and high-risk outputs have received skeptical review where required. It does not mean every possible companion skill was invoked.
 
-The canonical executable and policy details live in `fable-mode/SKILL.md`, `fable-mode/model-matrix.json`, `fable-mode/scripts/model-selector.js`, and `fable-mode/references/model-matrix.md`.
+The canonical executable and policy details live in `fable-mode/SKILL.md`, `fable-mode/behavior-profile-matrix.json`, `fable-mode/runtime-model-floor-matrix.json`, `fable-mode/scripts/model-selector.js`, and `fable-mode/references/model-matrix.md`.

package/evals/fable-mode/tasks/negative-tier2-no-model.yaml

@@ -1,6 +1,6 @@
 id: negative-fable-model-005
-name: Ordinary Tier 2 work does not select a fable model
-description: A normal Tier 2 bugfix must not route to a model-pinned fable entrypoint.
+name: Ordinary Tier 2 work does not select a fable profile
+description: A normal Tier 2 bugfix must not route to an explicit Fable behavior profile.
 tags:
   - negative-trigger
   - tier-2
@@ -10,7 +10,7 @@ expected:
   should_trigger: false
 graders:
   - type: text
-    name: no-model-pinned-route
+    name: no-explicit-profile-route
     config:
       contains:
         - "fable-opus"

package/evals/fable-mode/tasks/positive-haiku-mode.yaml

@@ -1,6 +1,6 @@
 id: positive-fable-haiku-002
 name: Explicit Haiku mode routes mechanical work
-description: "Stage large, multi-source or multi-session tasks through a written plan, named fable agents, failable per-stage checks, and skeptical delivery review; use fable-opus, fable-sonnet, or fable-haiku for explicit model selection."
+description: "Stage large tasks through plans, named fable agents, failable checks, and skeptical review; fable on opus|sonnet|haiku selects a behavior profile, not a runtime model."
 tags:
   - positive-trigger
   - fable-haiku

package/evals/fable-mode/tasks/positive-opus-mode.yaml

@@ -1,6 +1,6 @@
 id: positive-fable-opus-004
 name: Explicit Opus mode routes macro orchestration
-description: "Stage large, multi-source or multi-session tasks through a written plan, named fable agents, failable per-stage checks, and skeptical delivery review; use fable-opus, fable-sonnet, or fable-haiku for explicit model selection."
+description: "Stage large tasks through plans, named fable agents, failable checks, and skeptical review; fable on opus|sonnet|haiku selects a behavior profile, not a runtime model."
 tags:
   - positive-trigger
   - fable-opus

package/evals/fable-mode/tasks/positive-sonnet-mode.yaml

@@ -1,6 +1,6 @@
 id: positive-fable-sonnet-003
 name: Explicit Sonnet mode routes reasoning work
-description: "Stage large, multi-source or multi-session tasks through a written plan, named fable agents, failable per-stage checks, and skeptical delivery review; use fable-opus, fable-sonnet, or fable-haiku for explicit model selection."
+description: "Stage large tasks through plans, named fable agents, failable checks, and skeptical review; fable on opus|sonnet|haiku selects a behavior profile, not a runtime model."
 tags:
   - positive-trigger
   - fable-sonnet

package/evals/fable-mode/tasks/positive-trigger.yaml

@@ -1,6 +1,6 @@
 id: positive-fable-mode-001
 name: On-scope prompt triggers fable-mode
-description: "Stage large, multi-source or multi-session tasks through a written plan, named fable agents, failable per-stage checks, and skeptical delivery review; use fable-opus, fable-sonnet, or fable-haiku for explicit model selection."
+description: "Stage large tasks through plans, named fable agents, failable checks, and skeptical review; fable on opus|sonnet|haiku selects a behavior profile, not a runtime model."
 tags:
   - positive-trigger
 inputs:

package/fable-mode/SKILL.md

@@ -1,39 +1,45 @@
 ---
 name: fable-mode
-description: "Stage large, multi-source or multi-session tasks through a written plan, named fable agents, failable per-stage checks, and skeptical delivery review; use fable-opus, fable-sonnet, or fable-haiku for explicit model selection."
+description: "Stage large tasks through plans, named fable agents, failable checks, and skeptical review; fable on opus|sonnet|haiku selects a behavior profile, not a runtime model."
 license: Apache-2.0
 metadata:
   author: Miya Daniel
-  version: 0.30.2
+  version: 0.30.6
 ---
 
-# Fable Mode (v3)
+# Fable Mode
 
 ## Skill Contract
 
 | Component | Specification |
 | :--- | :--- |
-| **Trigger / Input** | Tier 3 work spanning multiple files, sources, or sessions. |
-| **Expected Output** | Stage map, named-agent briefs, failable checks, and skeptical review. |
-| **State Mutations** | Native host TODO tracker or a Markdown checklist; one JSON audit record per stage. |
-| **Enforcement Gate** | `<this-skill-dir>/scripts/model-selector.js`, stage contracts, and `<skills-repo-root>/harness-everything/scripts/verify-gate.js`. |
+| **Trigger / Input** | Profile lookup or Tier 3 execution. |
+| **Expected Output** | Profile record or verified stages. |
+| **State Mutations** | Execution only: stage checklist and audit records. |
+| **Enforcement Gate** | Execution: `<this-skill-dir>/scripts/model-selector.js`, stage contracts, and `<skills-repo-root>/harness-everything/scripts/verify-gate.js`. |
 
 ## USE FOR:
 - Large multi-file, multi-source, or multi-session work
-- Explicit `fable on haiku`, `fable on sonnet`, or `fable on opus` requests
+- Fable profile explanations or explicit Fable execution requests
 - Work needing named delegation and cold verification
 
 ## DO NOT USE FOR:
 - One obvious single-pass edit
 - Ordinary Tier 2 implementation or bugfix work
 
+## Select Operation First
+
+For explanation/profile-only lookup, read only `<this-skill-dir>/references/profile-lookup.md` and answer. No stage state, delegation, or selector source reads. Quoted aliases do not start Fable. Mixed execution retains its topology.
+
+Execution follows the workflow below.
+
 ## Workflow
 
 1. Discover the runtime and lock the authorized file scope before edits.
 2. Write a numbered stage map with one artifact and pass condition per stage; allow at most two full replans.
-3. Resolve the requested model with `model-selector.js`; never silently downgrade.
-4. Delegate by named agent where available: Opus orchestrates, Sonnet reasons, Haiku handles mechanical work, and workers never spawn workers.
-5. Write a stage contract, run its named check, then cold-review high-stakes artifacts with `fable-verifier`.
-6. Record requested/effective model, fallback reason, stage brief, pass condition, verification command, and verifier result for every stage. Escalate unresolved blockers.
+3. Resolve the requested behavior profile with `model-selector.js`; `opus`, `sonnet`/`sonnect`, and `haiku` are compatibility aliases, not model bindings.
+4. Delegate by profile: orchestrator coordinates, reasoning handles bounded judgment, mechanical handles low-ambiguity work, and workers never spawn workers.
+5. Treat the host runtime-model floor as advisory; record its status without blocking Fable solely for model choice.
+6. Run each stage check, cold-review high-stakes artifacts, and audit profile/runtime/fallback fields.
 
 Deep dive: <this-skill-dir>/references/model-matrix.md

package/fable-mode/agents/fable-orchestrator.md

@@ -2,7 +2,7 @@
 name: fable-orchestrator
 description: Staged-execution orchestrator for large, multi-part, or multi-session tasks. Use when fable-mode discipline must run with enforced delegation — it consumes the router topology, writes a dependency/write-set stage map, delegates ALL artifact production to fable-worker-sonnet / fable-worker-haiku, verifies every stage with a failable check, and sends high-stakes deliverables to fable-verifier for a cold re-check. It has no Write or Edit tool, so it cannot do the work itself.
 tools: Read, Grep, Glob, Bash, Task, TodoWrite
-model: opus
+model: inherit
 ---
 
 You are the fable orchestrator. You coordinate; you do not produce. You have no
@@ -18,7 +18,7 @@ and delegate.
 When a structured Harness workflow plan is supplied, consume it; do not rebuild
 its topology from tier labels or keywords. Fable may consume only the selected
 strategy, parallelism constraints, verifier requirement, workspace/memory hints,
-limits, and requested-model metadata. The router does not spawn workers and
+limits, and requested-profile metadata. The router does not spawn workers and
 Fable does not reclassify the task.
 
 - `fable-staged` — execute validated stages sequentially.
@@ -31,11 +31,12 @@ Fable does not reclassify the task.
 If the plan is blocked, deferred, direct-single, or iterative-single, do not
 silently coerce it into Fable. Return control to the caller with the plan reason.
 
-Before the first stage, resolve the requested model with
+Before the first stage, resolve the requested behavior profile with
 `fable-mode/scripts/model-selector.js`. Carry its JSON record into every stage
-brief. The workflow-plan consumer must never substitute a branded model. A
-missing model must produce the model selector's explicit `fallback` or `blocked`
-status. Every brief and handoff names requested versus effective model.
+brief. Profile aliases never pin a branded model. Host runtime-model floors are
+advisory metadata: below-floor or unknown remains visible but does not change or
+block the profile. Agent availability still uses explicit `inline`/`stop`
+fallback. Every brief names requested/effective profile and runtime model when known.
 
 ## Core loop
 

package/fable-mode/agents/fable-verifier.md

@@ -2,7 +2,7 @@
 name: fable-verifier
 description: Cold verifier for finished fable deliverables. Brief it with ONLY the spec and the artifact path — never the producer's reasoning — and it re-runs the named checks from scratch and returns pass/fail per check. Read-only by design; it cannot fix anything, only judge it. Use for high-stakes deliverables after the producing agent claims its checks passed.
 tools: Read, Grep, Glob, Bash
-model: haiku
+model: inherit
 ---
 
 You are a cold verifier. You receive a spec and an artifact. You were

package/fable-mode/agents/fable-worker-haiku.md

@@ -2,7 +2,7 @@
 name: fable-worker-haiku
 description: Fable stage worker for bulk mechanical work — file processing, format conversion, boilerplate, structured extraction, batch edits. Cheap and parallelizable. Produces one verifiable artifact per assignment with tightened verification (no bare "unverified" allowed). Spawned by fable-orchestrator or directly by a fable skill; does not spawn further agents.
 tools: Read, Write, Edit, Grep, Glob, Bash, WebSearch, WebFetch
-model: haiku
+model: inherit
 ---
 
 You are a fable stage worker for mechanical tasks. You receive one bounded
@@ -27,9 +27,10 @@ Rules, in order:
 5. **Report format:** artifact path, check command, check output, blockers.
    Short.
 
-Include the mode audit fields in the report: requested model, effective model,
-fallback reason, stage brief, pass condition, verification command, and verifier
-result. A fallback or blocker must remain visible in the report.
+Include the audit fields in the report: requested/effective profile, profile alias,
+runtime model/effort, runtime-floor status, fallback reason, stage brief, pass
+condition, verification command, and verifier result. A fallback or blocker must
+remain visible in the report.
 
 Do not spawn subagents.
 

package/fable-mode/agents/fable-worker-sonnet.md

@@ -2,7 +2,7 @@
 name: fable-worker-sonnet
 description: Fable stage worker for tasks needing real reasoning — research synthesis, nontrivial code, analysis, document drafting. Produces one verifiable artifact per assignment and reports the named check that proves it. Spawned by fable-orchestrator or directly by a fable skill; does not spawn further agents.
 tools: Read, Write, Edit, Grep, Glob, Bash, WebSearch, WebFetch
-model: sonnet
+model: inherit
 ---
 
 You are a fable stage worker. You receive one bounded assignment: a specific
@@ -26,9 +26,10 @@ Rules of the loop, in order:
 4. **Report format:** artifact path, check command, check output, confirmed
    facts vs. inferences (labeled), leftovers/recommendations. Keep it short.
 
-Include the mode audit fields in the report: requested model, effective model,
-fallback reason, stage brief, pass condition, verification command, and verifier
-result. Preserve any `fallback` or `blocked` status from the selector.
+Include the audit fields in the report: requested/effective profile, profile alias,
+runtime model/effort, runtime-floor status, fallback reason, stage brief, pass
+condition, verification command, and verifier result. Preserve any agent
+`fallback` or `blocked` status from the selector.
 
 Do not spawn subagents. Escalate rather than guess: if the assignment needs
 synthesis beyond you or its requirements are contradictory, stop and return the

package/fable-mode/behavior-profile-matrix.json

@@ -0,0 +1,36 @@
+{
+  "schemaVersion": 2,
+  "profiles": {
+    "mechanical": {
+      "legacyAlias": "haiku",
+      "aliases": [
+        "mechanical",
+        "haiku"
+      ],
+      "role": "mechanical-worker",
+      "useFor": "bulk mechanical work, format conversion, boilerplate, structured extraction, and other low-ambiguity tasks",
+      "agent": "fable-worker-haiku"
+    },
+    "reasoning": {
+      "legacyAlias": "sonnet",
+      "aliases": [
+        "reasoning",
+        "sonnet",
+        "sonnect"
+      ],
+      "role": "reasoning-worker",
+      "useFor": "non-trivial implementation, research synthesis, analysis, document drafting, and bounded design reasoning",
+      "agent": "fable-worker-sonnet"
+    },
+    "orchestrator": {
+      "legacyAlias": "opus",
+      "aliases": [
+        "orchestrator",
+        "opus"
+      ],
+      "role": "orchestrator",
+      "useFor": "stage decomposition, dependency management, cross-stage synthesis, architecture, and high-stakes final decisions",
+      "agent": "fable-orchestrator"
+    }
+  }
+}

package/fable-mode/execution-guardrails/SKILL.md

@@ -1,13 +1,10 @@
 ---
 name: execution-guardrails
-description: >-
-  Always-on guardrails: verify findings before flagging warnings, batch
-  minor caveats, and anchor search-and-replace edits with post-write checks.
-  Use when raising warnings or performing search-and-replace file edits.
+description: "Reference guardrails for verified warnings and safe replacements; active carriers must inject them explicitly."
 license: Apache-2.0
 metadata:
   author: Miya Daniel
-  version: 0.30.2
+  version: 0.30.6
 ---
 
 # Execution Guardrails
@@ -40,6 +37,6 @@ metadata:
 
 Repeated matching execution failures remain governed by Rule-of-3 / `zoom-out`; warning batching never substitutes for that recovery path.
 
-These rules are always-on, even when `fable-mode`'s staged loop is not running.
+This nested file is reference-only, not an always-on carrier; rules apply only when an active carrier injects them.
 
 Deep dive: <this-skill-dir>/references/guardrail-rules.md

package/fable-mode/execution-guardrails/references/guardrail-rules.md

@@ -1,9 +1,8 @@
 # Guardrail Rules — Full Detail
 
-Three rules extracted from fable-mode's operational section so they apply everywhere,
-not only inside the staged loop. A frontier model doesn't need a stage map for a simple
-task, but it still needs these — they encode the user's preferences, and no model ships
-knowing them.
+Three rules extracted from fable-mode's operational section so active carriers can reuse
+them outside the staged loop. A frontier model doesn't need a stage map for a simple task,
+but any carrier that relies on these rules must load, copy, or inject them explicitly.
 
 ## 1. Verify before flag
 
@@ -53,8 +52,8 @@ Preferred order of tools: IDE native structured replace tool (`replace_string_in
 
 ## Relationship to fable-mode
 
-fable-mode's staged loop is optional and gated on task size. These guardrails are not
-optional and not gated. When fable-mode runs, its step 4 (self-critique) and all file
-edits inherit these rules. When fable-mode doesn't run, these rules apply anyway. In v3
-the per-model runners route to frontmatter-defined agents (`agents/*.md`) whose system
-prompts carry these rules inline, because spawned agents cannot see this skill.
+fable-mode's staged loop is optional and gated on task size. These rules are intended as
+baseline execution guidance wherever an active carrier loads them, but this nested
+reference is not itself automatically discovered or always-on. In v3 the per-model
+flow routes to frontmatter-defined agents (`agents/*.md`) whose system prompts carry
+the required rules inline, because spawned agents cannot see this reference file.

package/fable-mode/fable-haiku/SKILL.md

@@ -1,14 +1,16 @@
 ---
 name: fable-haiku
-description: "Run staged fable work on Haiku for bulk mechanical tasks with explicit pass conditions, visible fallback handling, and a cold verifier pass."
+description: "Reference mechanical behavior profile (legacy alias haiku) for bulk low-ambiguity work with explicit checks and cold verification; runtime model choice is separate."
 license: Apache-2.0
 metadata:
   author: Miya Daniel
-  version: 0.30.2
+  version: 0.30.6
 ---
 
 # Fable Mode — Haiku
 
+> **Reference profile, not a standalone plugin skill.** Invoke this profile through `fable-mode` with `fable on haiku`; plugin manifests do not register this nested directory independently.
+
 ## Skill Contract
 
 | Component | Specification |
@@ -28,9 +30,9 @@ metadata:
 
 ## Run it
 
-1. Resolve `haiku` through `<this-skill-dir>/../scripts/model-selector.js`.
-2. Spawn `fable-worker-haiku` when available; otherwise use an inline fallback only when the audit record says so.
+1. Resolve legacy alias `haiku` to the `mechanical` behavior profile through `<this-skill-dir>/../scripts/model-selector.js`.
+2. Spawn `fable-worker-haiku` when available; otherwise use the explicit inline/stop agent fallback. The runtime-model floor is advisory and never changes the profile.
 3. Brief one bounded output path and a named check; workers do not spawn workers.
 4. Route synthesis blockers to Sonnet/Opus and cold-review unsupervised delivery with `fable-verifier`.
 
-Use `<this-skill-dir>/../references/model-matrix.md` for the audit fields and fallback policy.
+Use `<this-skill-dir>/../references/model-matrix.md` for behavior-profile aliases, runtime floors, audit fields, and fallback policy.

package/fable-mode/fable-haiku/references/routing-notes.md

@@ -6,7 +6,8 @@ Details moved from SKILL.md.
 
 The worker is a real agent definition (`../agents/fable-worker-haiku.md`)
 invoked by name. Its system prompt carries the loop, the tightened verification
-rule, and the operational rules; this skill only routes.
+rule, and the operational rules; this reference profile documents the route used after
+`fable-mode` selects Haiku.
 
 ## Full run procedure
 

package/fable-mode/fable-opus/SKILL.md

@@ -1,14 +1,16 @@
 ---
 name: fable-opus
-description: "Run staged fable orchestration on Opus for cross-stage synthesis, high-stakes architecture, and final decisions with named workers, cold verification, and visible fallback handling."
+description: "Reference orchestrator behavior profile (legacy alias opus) for staged synthesis, architecture, named delegation, and cold verification; runtime model choice is separate."
 license: Apache-2.0
 metadata:
   author: Miya Daniel
-  version: 0.30.2
+  version: 0.30.6
 ---
 
 # Fable Mode — Opus
 
+> **Reference profile, not a standalone plugin skill.** Invoke this profile through `fable-mode` with `fable on opus`; plugin manifests do not register this nested directory independently.
+
 ## Skill Contract
 
 | Component | Specification |
@@ -24,13 +26,13 @@ metadata:
 
 ## DO NOT USE FOR:
 - One obvious single-pass task
-- Bulk mechanical work (use `fable-haiku`) or bounded reasoning (use `fable-sonnet`)
+- Bulk mechanical work (select `fable on haiku`) or bounded reasoning (select `fable on sonnet`)
 
 ## Run it
 
-1. Resolve `opus` through `<this-skill-dir>/../scripts/model-selector.js`.
-2. Spawn `fable-orchestrator` when the runtime exposes it; otherwise report the inline fallback explicitly.
+1. Resolve legacy alias `opus` to the `orchestrator` behavior profile through `<this-skill-dir>/../scripts/model-selector.js`.
+2. Spawn `fable-orchestrator` when available; otherwise use the explicit inline/stop agent fallback. The runtime-model floor is advisory and never changes the profile.
 3. The orchestrator owns scope lock, at most two replans, stage contracts, named worker delegation, and escalation; it never produces artifacts itself.
 4. Cold-review high-stakes deliverables with `fable-verifier`; report every unverified stage.
 
-Use `<this-skill-dir>/../references/model-matrix.md` for the audit fields and fallback policy.
+Use `<this-skill-dir>/../references/model-matrix.md` for behavior-profile aliases, runtime floors, audit fields, and fallback policy.

package/fable-mode/fable-sonnet/SKILL.md

@@ -1,14 +1,16 @@
 ---
 name: fable-sonnet
-description: "Run staged fable work on Sonnet for non-trivial implementation, research synthesis, or bounded reasoning with explicit pass conditions and visible fallback handling."
+description: "Reference reasoning behavior profile (legacy alias sonnet/sonnect) for non-trivial implementation, synthesis, and bounded judgment; runtime model choice is separate."
 license: Apache-2.0
 metadata:
   author: Miya Daniel
-  version: 0.30.2
+  version: 0.30.6
 ---
 
 # Fable Mode — Sonnet
 
+> **Reference profile, not a standalone plugin skill.** Invoke this profile through `fable-mode` with `fable on sonnet`; plugin manifests do not register this nested directory independently.
+
 ## Skill Contract
 
 | Component | Specification |
@@ -24,13 +26,13 @@ metadata:
 
 ## DO NOT USE FOR:
 - One obvious single-pass task
-- Macro orchestration or final high-stakes decisions (use `fable-opus`)
+- Macro orchestration or final high-stakes decisions (select `fable on opus`)
 
 ## Run it
 
-1. Resolve `sonnet` through `<this-skill-dir>/../scripts/model-selector.js`; normalize `sonnect` to Sonnet.
-2. Spawn `fable-worker-sonnet` when available, otherwise use a visible inline fallback.
+1. Resolve `sonnet` or `sonnect` to the `reasoning` behavior profile through `<this-skill-dir>/../scripts/model-selector.js`.
+2. Spawn `fable-worker-sonnet` when available; otherwise use the explicit inline/stop agent fallback. The runtime-model floor is advisory and never changes the profile.
 3. Brief the exact artifact path, context, and pass condition; workers do not spawn workers.
 4. Send high-stakes artifacts to `fable-verifier` and escalate contradictions instead of guessing.
 
-Use `<this-skill-dir>/../references/model-matrix.md` for the audit fields and fallback policy.
+Use `<this-skill-dir>/../references/model-matrix.md` for behavior-profile aliases, runtime floors, audit fields, and fallback policy.

package/fable-mode/model-matrix.json

@@ -1,32 +1,9 @@
 {
-  "schemaVersion": 1,
-  "modes": {
-    "haiku": {
-      "role": "bulk mechanical / format conversion",
-      "agent": "fable-worker-haiku",
-      "aliases": ["haiku"]
-    },
-    "sonnet": {
-      "role": "non-trivial implementation / research synthesis / bounded stage reasoning",
-      "agent": "fable-worker-sonnet",
-      "aliases": ["sonnet", "sonnect"]
-    },
-    "opus": {
-      "role": "macro orchestration / cross-stage synthesis / high-stakes architecture and final decision",
-      "agent": "fable-orchestrator",
-      "aliases": ["opus"]
-    }
-  },
-  "fallbacks": {
-    "inline": {
-      "status": "fallback",
-      "effectiveModel": "host-model",
-      "reason": "requested model is unavailable; run inline on the declared host model"
-    },
-    "stop": {
-      "status": "blocked",
-      "effectiveModel": null,
-      "reason": "requested model is unavailable and inline fallback was not authorized"
-    }
-  }
+  "schemaVersion": 2,
+  "deprecated": true,
+  "replacedBy": [
+    "behavior-profile-matrix.json",
+    "runtime-model-floor-matrix.json"
+  ],
+  "note": "Fable profiles define behavior and role assignment. Runtime model floors are host-specific recommendations and do not define the profile."
 }