@dzhechkov/skills-feature-adr 1.3.4 → 1.3.5

package/README.md

@@ -214,22 +214,42 @@ gate — not discovered in production.
 
 ## Pipeline Steps
 
-| Step | Name | Tiers | Model | Agentic QE Skill | Output |
-|------|------|-------|-------|------------------|--------|
-| 0 | Complexity Router | All | haiku | — | `00_complexity_assessment.md` |
-| 1 | Requirements | All | sonnet | — | `01_requirements.md` |
-| 2 | Research | L/XL | sonnet | — | `02_research.md` |
-| 3 | ADR + Shift-Left | M+ | opus | shift-left-testing | `03_adr/001-*.md` |
-| 3.5 | QCSD Ideation Swarm | M+ | sonnet | qcsd-ideation-swarm | `03.5_ideation_report.md` |
-| 4 | DDD | L/XL | opus | — | `04_domain_model.md` |
-| 5 | Architecture | M+ | opus | — | `05_architecture.md` + diagrams |
-| 6 | SPARC-GOAP Plan | All | sonnet | code-goal-planner | `06_implementation_plan.md` |
-| 7 | Code | All | opus | tdd-london-chicago* | `07_code_changes/` |
-| 8 | QE + Brutal Honesty | All | sonnet | brutal-honesty-review | `08_qe_report.md` |
-| 9 | Fleet QE | L/XL | sonnet | 5 skills (4 agents) | `09_fleet_qe_assessment.md` |
+| Step | Name | Tiers | Model | Fable? | Agentic QE Skill | Output |
+|------|------|-------|-------|:------:|------------------|--------|
+| 0 | Complexity Router | All | haiku | ✅ | — | `00_complexity_assessment.md` |
+| 1 | Requirements | All | sonnet | ✅ | — | `01_requirements.md` |
+| 2 | Research | L/XL | sonnet | ✅ | — | `02_research.md` |
+| 3 | ADR + Shift-Left | M+ | opus | ⚠️ | shift-left-testing | `03_adr/001-*.md` |
+| 3.5 | QCSD Ideation Swarm | M+ | sonnet | ✅ | qcsd-ideation-swarm | `03.5_ideation_report.md` |
+| 4 | DDD | L/XL | opus | ⚠️ | — | `04_domain_model.md` |
+| 5 | Architecture | M+ | opus | ⚠️ | — | `05_architecture.md` + diagrams |
+| 6 | SPARC-GOAP Plan | All | sonnet | ✅ | code-goal-planner | `06_implementation_plan.md` |
+| 7 | Code | All | opus | ⚠️ | tdd-london-chicago* | `07_code_changes/` |
+| 8 | QE + Brutal Honesty | All | sonnet | ✅ | brutal-honesty-review | `08_qe_report.md` |
+| 9 | Fleet QE | L/XL | sonnet | ⚠️ | 5 skills (4 agents) | `09_fleet_qe_assessment.md` |
 
 *\* Extended skills (marked with \*) are only available with `--full-qe-extended`*
 
+### The `Model` / `Fable?` columns — read this before swapping models
+
+The `Model` column is the **default recommendation, fully overridable** — the routing rule is
+"phase difficulty → model tier": a fast tier for classification, a mid tier (`sonnet`) for
+structured drafting / QE synthesis, a top tier (`opus`) for load-bearing judgment.
+
+The **`Fable?`** column flags where switching to **Fable** is low-risk to try:
+
+- **✅ Fable-friendly** — drafting / classification / synthesis phases that are **gated by a
+  checkpoint and cheap to redo** (0 Router, 1 Requirements, 2 Research, 3.5 Ideation, 6 Plan,
+  8 QE draft). If Fable holds quality here, you gain speed/cost with a human gate right after.
+- **⚠️ Validate first** — **load-bearing reasoning** phases where a wrong call cascades downstream
+  (3 ADR decisions, 4 DDD, 5 Architecture, 7 Code, 9 Fleet QE). Keep the `opus`/`sonnet` default
+  unless you've A/B-validated Fable on your codebase.
+
+> **How to decide with data, not vibes:** install with `--with-learning` and run 2–3 features with
+> Fable on the ✅ steps; compare the reward patterns / rework counts against your `sonnet` baseline.
+> The pipeline's own reward tracker tells you where Fable is safe. This table is a **starting
+> heuristic**, not a benchmark — tune per project.
+
 ---
 
 ## Output Structure

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dzhechkov/skills-feature-adr",
-  "version": "1.3.4",
+  "version": "1.3.5",
   "description": "Adaptive Feature Development skill pack for Claude Code — 11-step pipeline with Complexity Router (S/M/L/XL), ADR-driven architecture, 15 agentic-qe skills, multi-agent fleet QE. Supports --full-qe, --full-qe-extended, --with-learning, and --knowledge-extractor modes.",
   "main": "src/cli.js",
   "bin": {