loki-mode 11.19.0 → 11.21.0

package/mcp/__init__.py

@@ -75,4 +75,4 @@ try:
 except ImportError:
     __all__ = ['mcp']
 
-__version__ = '11.19.0'
+__version__ = '11.21.0'

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "loki-mode",
   "mcpName": "io.github.asklokesh/loki-mode",
-  "version": "11.19.0",
+  "version": "11.21.0",
   "description": "An autonomous software factory that knows what it is supposed to deliver, and proves it did.",
   "keywords": [
     "agent",
@@ -160,5 +160,5 @@
   "dependencies": {
     "@resvg/resvg-wasm": "^2.6.2"
   },
-  "gitHead": "3ce6902a1ec7ecec2cf0294e55ea96cb735f8bc0"
+  "gitHead": "a907f757fb62c646b291d550201ecd280bdb6b58"
 }

package/packages/control-plane/dist/server.js

@@ -7881,7 +7881,10 @@ function costBreakdown(recs, missing = []) {
   }
   return out2;
 }
-var UNATTRIBUTED = "unattributed", validUsd = (v) => typeof v === "number" && Number.isFinite(v) && v >= 0, tok = (v) => typeof v === "number" && Number.isFinite(v) ? v : 0, noUsage = (r) => r["source"] !== "cli-invoker-unmetered" && ["input_tokens", "output_tokens", "cache_read_tokens", "cache_creation_tokens"].every((k) => tok(r[k]) === 0), isRetry = (r) => r["retry"] === true || typeof r["attempt"] === "number" && r["attempt"] > 1, add2 = (a, c) => a === null || c === null ? null : a + c;
+var UNATTRIBUTED = "unattributed", validUsd = (v) => typeof v === "number" && Number.isFinite(v) && v >= 0, tok = (v) => typeof v === "number" && Number.isFinite(v) ? v : 0, noUsage = (r) => r["source"] !== "cli-invoker-unmetered" && ["input_tokens", "output_tokens", "cache_read_tokens", "cache_creation_tokens"].every((k) => tok(r[k]) === 0), isRetry = (r) => r["retry"] === true || typeof r["attempt"] === "number" && r["attempt"] > 1, add2 = (a, c) => a === null || c === null ? null : a + c, CACHE_TTL_5M_MS;
+var init_cost_breakdown = __esm(() => {
+  CACHE_TTL_5M_MS = 5 * 60000;
+});
 
 // ../../loki-ts/src/runner/router/flag.ts
 function routerMode(env = process.env) {
@@ -8041,6 +8044,7 @@ function sumResultCosts(lokiRoot, iterations, context = []) {
 var UNMETERED = "cli-invoker-unmetered";
 var init_cost = __esm(() => {
   init_hooks();
+  init_cost_breakdown();
   init_provider_cost();
   init_provider_cost();
 });

package/plugins/loki-mode/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "loki-mode",
   "displayName": "Loki Mode",
-  "version": "11.19.0",
+  "version": "11.21.0",
   "description": "Autonomous spec-to-product build system with a built-in trust layer (RARV-C closure loop, 8 quality gates, completion council). Ships Loki's spec-hardening, drift-detection, and deterministic PR verification commands plus the Loki MCP server.",
   "author": {
     "name": "Autonomi",

package/skills/00-index.md

@@ -1,5 +1,33 @@
 # Skill Modules Index
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [Module Selection Rules](#module-selection-rules)
+- [Module Descriptions](#module-descriptions)
+  - [model-selection.md](#model-selectionmd)
+  - [quality-gates.md](#quality-gatesmd)
+  - [patterns-advanced.md](#patterns-advancedmd)
+  - [testing.md](#testingmd)
+  - [production.md](#productionmd)
+  - [troubleshooting.md](#troubleshootingmd)
+  - [agents.md](#agentsmd)
+  - [artifacts.md](#artifactsmd)
+  - [parallel-workflows.md](#parallel-workflowsmd)
+  - [github-integration.md](#github-integrationmd)
+  - [openspec-integration.md](#openspec-integrationmd)
+  - [mirofish-integration.md](#mirofish-integrationmd)
+  - [documentation.md](#documentationmd)
+  - [compound-learning.md (v5.30.0)](#compound-learningmd-v5300)
+  - [healing.md (v6.67.0)](#healingmd-v6670)
+  - [sdlc-fleet.md](#sdlc-fleetmd)
+  - [factory-operations.md](#factory-operationsmd)
+  - [release-cadence.md](#release-cadencemd)
+  - [extending.md](#extendingmd)
+  - [providers.md (v5.0.0)](#providersmd-v500)
+- [How to Load](#how-to-load)
+<!-- TOC:END -->
+
 **Load 1-3 modules based on your current task. Do not load all modules.**
 
 > **Full documentation:** For comprehensive details, see `references/` directory:

package/skills/agents.md

@@ -1,5 +1,19 @@
 # Agent Dispatch & Structured Prompting
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [How Agents Actually Work](#how-agents-actually-work)
+- [Structured Prompting Template](#structured-prompting-template)
+- [Specialist Review Pattern (v5.30.0)](#specialist-review-pattern-v5300)
+- [Confidence-Based Routing](#confidence-based-routing)
+- [Agent Handoffs](#agent-handoffs)
+- [Project AGENTS.md](#project-agentsmd)
+- [A2A-Inspired Communication (Google Protocol)](#a2a-inspired-communication-google-protocol)
+- [Agentic Patterns Reference (awesome-agentic-patterns)](#agentic-patterns-reference-awesome-agentic-patterns)
+- [The 41 Agent Roles (37 Domain + 4 Orchestration)](#the-41-agent-roles-37-domain--4-orchestration)
+<!-- TOC:END -->
+
 > **Full agent type definitions:** See `references/agent-types.md` for complete 41 agent role specifications across 8 domains (Engineering, Operations, Business, Data, Product, Growth, Review, Orchestration). These are prompt-defined specifications the orchestrator adopts per phase; parallelism on Claude Code comes from the blind review council, the adversarial reviewer, and optional git-worktree streams, sequential on other providers.
 
 ---

package/skills/artifacts.md

@@ -1,5 +1,17 @@
 # Artifact Generation & Code Transformation
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [Artifact Generation (Antigravity Pattern)](#artifact-generation-antigravity-pattern)
+- [Artifact Types](#artifact-types)
+  - [Verification Report](#verification-report)
+  - [Architecture Diff](#architecture-diff)
+  - [Screenshot Gallery](#screenshot-gallery)
+- [Code Transformation Agent (Amazon Q Pattern)](#code-transformation-agent-amazon-q-pattern)
+- [Release Notes Generation](#release-notes-generation)
+<!-- TOC:END -->
+
 ## Artifact Generation (Antigravity Pattern)
 
 **Auto-generate verifiable deliverables for audit trail without human intervention.**

package/skills/compound-learning.md

@@ -1,5 +1,25 @@
 # Compound Learning & Deep Planning
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [Knowledge Compounding (Post-VERIFY)](#knowledge-compounding-post-verify)
+  - [When to Compound](#when-to-compound)
+  - [When NOT to Compound](#when-not-to-compound)
+  - [Solution File Format](#solution-file-format)
+  - [Categories](#categories)
+  - [YAML Frontmatter Fields](#yaml-frontmatter-fields)
+- [Loading Solutions (REASON Phase)](#loading-solutions-reason-phase)
+  - [Matching Logic](#matching-logic)
+  - [Context Injection Format](#context-injection-format)
+- [Deepen-Plan Phase](#deepen-plan-phase)
+  - [When to Run](#when-to-run)
+  - [Research Agents (4 parallel -- launch in ONE message)](#research-agents-4-parallel----launch-in-one-message)
+  - [After All 4 Complete](#after-all-4-complete)
+  - [Example Output Integration](#example-output-integration)
+- [Composable Phases](#composable-phases)
+<!-- TOC:END -->
+
 **Inspired by:** Compound Engineering Plugin (Every/Kieran Klaassen) -- knowledge compounding philosophy where each unit of work makes subsequent work easier.
 
 ---

package/skills/documentation.md

@@ -1,5 +1,23 @@
 # Documentation Skill Module
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [Research Foundation](#research-foundation)
+- [When to Load This Module](#when-to-load-this-module)
+- [Documentation Types](#documentation-types)
+- [Model Selection](#model-selection)
+- [Repowise Integration](#repowise-integration)
+  - [Detection](#detection)
+- [Documentation Quality Criteria](#documentation-quality-criteria)
+- [Prompts](#prompts)
+  - [For README generation](#for-readme-generation)
+  - [For ARCHITECTURE generation](#for-architecture-generation)
+  - [For API documentation](#for-api-documentation)
+  - [For DECISIONS documentation](#for-decisions-documentation)
+- [Integration with Other Skills](#integration-with-other-skills)
+<!-- TOC:END -->
+
 ## Research Foundation
 
 | Source | Key Contribution | Citation |

package/skills/extending.md

@@ -1,5 +1,18 @@
 # Extending the Loop
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [What is actually extensible today](#what-is-actually-extensible-today)
+- [The reviewer seam (R10)](#the-reviewer-seam-r10)
+  - [Install](#install)
+  - [When it fires](#when-it-fires)
+- [Three invariants you cannot override](#three-invariants-you-cannot-override)
+- [Manifests are data, never code](#manifests-are-data-never-code)
+- [`src/plugins/` is NOT a seam (status: unwired)](#srcplugins-is-not-a-seam-status-unwired)
+- [Adding a real gate](#adding-a-real-gate)
+<!-- TOC:END -->
+
 **When to load:** you want to add your own reviewer, agent, or gate to the RARV
 loop without editing engine files.
 

package/skills/factory-operations.md

@@ -1,5 +1,28 @@
 # Factory Operations (skill module)
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [1. Roles: what each one DECIDES vs what it ADVISES](#1-roles-what-each-one-decides-vs-what-it-advises)
+- [2. Partition: how two teams never edit the same file](#2-partition-how-two-teams-never-edit-the-same-file)
+  - [2.1 Per-file ownership is the primary mechanism](#21-per-file-ownership-is-the-primary-mechanism)
+  - [2.2 Worktree isolation is the EXCEPTION, not the default](#22-worktree-isolation-is-the-exception-not-the-default)
+  - [2.3 A red test during a review window may be someone else's mutation](#23-a-red-test-during-a-review-window-may-be-someone-elses-mutation)
+- [3. WIP limit](#3-wip-limit)
+  - [3.1 Why one gate, not more](#31-why-one-gate-not-more)
+  - [3.2 Why 3 implementation streams](#32-why-3-implementation-streams)
+  - [3.3 The admission rule](#33-the-admission-rule)
+- [4. Escalation: what a blocked team does instead of waiting](#4-escalation-what-a-blocked-team-does-instead-of-waiting)
+  - [4.1 A stall is a measurement problem, not a patience problem](#41-a-stall-is-a-measurement-problem-not-a-patience-problem)
+  - [4.2 An exit code reports a PROCESS, never the WORLD](#42-an-exit-code-reports-a-process-never-the-world)
+- [5. Release windows: main is WIP=1](#5-release-windows-main-is-wip1)
+- [6. Contended main: verify ancestry, never force](#6-contended-main-verify-ancestry-never-force)
+- [7. The void measurement: the failure shape that costs the most](#7-the-void-measurement-the-failure-shape-that-costs-the-most)
+  - [7.1 The three rules that follow](#71-the-three-rules-that-follow)
+  - [7.2 Why this is a COORDINATION rule, not a testing tip](#72-why-this-is-a-coordination-rule-not-a-testing-tip)
+  - [7.3 If this module is ever trimmed](#73-if-this-module-is-ever-trimmed)
+<!-- TOC:END -->
+
 **Purpose:** the operating system for running multiple agent teams against this
 repo at once without losing work, without false greens, and without the teams
 blocking each other.

package/skills/github-integration.md

@@ -1,5 +1,32 @@
 # GitHub Integration (v5.41.0)
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [Quick Reference](#quick-reference)
+- [Environment Variables](#environment-variables)
+- [Issue Import Workflow](#issue-import-workflow)
+  - [1. Check gh CLI Authentication](#1-check-gh-cli-authentication)
+  - [2. Import Open Issues](#2-import-open-issues)
+  - [3. Priority Mapping](#3-priority-mapping)
+- [PR Creation Workflow](#pr-creation-workflow)
+  - [PR Body Template](#pr-body-template)
+- [Status Sync Workflow](#status-sync-workflow)
+- [Usage Examples](#usage-examples)
+  - [Import Issues and Create PR](#import-issues-and-create-pr)
+  - [Sync with Specific Repo](#sync-with-specific-repo)
+  - [Filter by Milestone](#filter-by-milestone)
+- [Multiple issues at once (parallel, reliably)](#multiple-issues-at-once-parallel-reliably)
+  - [Sequential (simplest, one process, one checkout)](#sequential-simplest-one-process-one-checkout)
+  - [Concurrent (one isolated run PER issue)](#concurrent-one-isolated-run-per-issue)
+  - [Inside a Claude Code session (the Loki Mode skill)](#inside-a-claude-code-session-the-loki-mode-skill)
+- [CLI Commands](#cli-commands)
+- [Dashboard API](#dashboard-api)
+- [Sync Behavior](#sync-behavior)
+- [Error Handling](#error-handling)
+- [gh CLI Quick Reference](#gh-cli-quick-reference)
+<!-- TOC:END -->
+
 **When:** Importing issues from GitHub, creating PRs, syncing task status back
 
 > **Requires:** `gh` CLI authenticated (`gh auth status`)

package/skills/healing.md

@@ -1,5 +1,33 @@
 # Legacy System Healing
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [Research Foundation](#research-foundation)
+- [When to Load This Module](#when-to-load-this-module)
+- [Core Principles](#core-principles)
+  - [1. Friction is Semantics (Amazon AGI Lab)](#1-friction-is-semantics-amazon-agi-lab)
+  - [2. Characterize Before Modifying (Feathers)](#2-characterize-before-modifying-feathers)
+  - [3. Strangler Fig Pattern (Fowler)](#3-strangler-fig-pattern-fowler)
+  - [4. Anti-Corruption Layer (Evans, DDD)](#4-anti-corruption-layer-evans-ddd)
+  - [5. System-Boundary Verification (RepoMod-Bench)](#5-system-boundary-verification-repomod-bench)
+- [Healing Pipeline](#healing-pipeline)
+  - [Phase Gates](#phase-gates)
+- [Healing RARV Cycle](#healing-rarv-cycle)
+  - [RARV-C Closure Flags (v7.5.0+)](#rarv-c-closure-flags-v750)
+- [Structured Fault Injection (Honest Alternative to RL Gyms)](#structured-fault-injection-honest-alternative-to-rl-gyms)
+- [Multi-Agent Decomposition (AWS Transform Pattern)](#multi-agent-decomposition-aws-transform-pattern)
+- [Health Score Formula](#health-score-formula)
+- [Healing-Specific Code Review](#healing-specific-code-review)
+- [Healing Metrics](#healing-metrics)
+  - [Golden-master boundary equivalence (modernize -> validate gate)](#golden-master-boundary-equivalence-modernize---validate-gate)
+- [Healing Signals](#healing-signals)
+- [Environment Variables](#environment-variables)
+- [Known Limitations](#known-limitations)
+- [Quick Reference](#quick-reference)
+- [Checkpoint metadata hardening (v7.5.8)](#checkpoint-metadata-hardening-v758)
+<!-- TOC:END -->
+
 ## Research Foundation
 
 This module synthesizes ideas from multiple validated sources. Each technique is cited.

package/skills/magic-modules.md

@@ -1,5 +1,29 @@
 # Magic Modules Skill
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [Research Foundation](#research-foundation)
+- [When to Load This Module](#when-to-load-this-module)
+- [Core Concept](#core-concept)
+  - [1. Spec-First Generation (MagicModules -- Roman Nurik)](#1-spec-first-generation-magicmodules----roman-nurik)
+  - [2. Multi-Persona Debate (MoMoA -- Reto Meier)](#2-multi-persona-debate-momoa----reto-meier)
+- [Commands](#commands)
+- [Workflow Integration](#workflow-integration)
+  - [With RARV Cycle](#with-rarv-cycle)
+  - [With Documentation System (`loki docs`)](#with-documentation-system-loki-docs)
+  - [With Git Intelligence](#with-git-intelligence)
+  - [With Quality Gates](#with-quality-gates)
+- [File Layout](#file-layout)
+- [Design Tokens](#design-tokens)
+- [Generation Targets](#generation-targets)
+- [Debate Personas](#debate-personas)
+- [Anti-Patterns](#anti-patterns)
+- [Quick Reference](#quick-reference)
+- [Integration with Other Skills](#integration-with-other-skills)
+- [See Also](#see-also)
+<!-- TOC:END -->
+
 ## Research Foundation
 
 | Source | Key Contribution | Citation |

package/skills/memory.md

@@ -1,5 +1,25 @@
 # Memory Integration (v7.2.0+)
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [Flag hierarchy](#flag-hierarchy)
+- [Schema mapping](#schema-mapping)
+- [How RARV-C uses managed memory](#how-rarv-c-uses-managed-memory)
+  - [REASON phase (read augment)](#reason-phase-read-augment)
+  - [REFLECT/VERIFY phase (shadow-write)](#reflectverify-phase-shadow-write)
+  - [Completion council (augment + verdict)](#completion-council-augment--verdict)
+  - [Session-boot hydrate](#session-boot-hydrate)
+- [Multiagent council (research preview)](#multiagent-council-research-preview)
+- [Cross-session learning](#cross-session-learning)
+- [PII redaction](#pii-redaction)
+- [Observability](#observability)
+- [Honest disclosure: what is NOT tested](#honest-disclosure-what-is-not-tested)
+- [Rollback](#rollback)
+- [Troubleshooting](#troubleshooting)
+- [References](#references)
+<!-- TOC:END -->
+
 Loki Mode ships two memory layers:
 
 1. **Local memory** (`.loki/memory/`) -- project-scoped, authoritative, versioned

package/skills/model-selection.md

@@ -1,5 +1,39 @@
 # Model Selection & Task Tool
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [Session-Pinned Model (default)](#session-pinned-model-default)
+- [Fable 5 (top-tier advisory model)](#fable-5-top-tier-advisory-model)
+  - [Mid-flight model switching](#mid-flight-model-switching)
+  - [Architecture-tier opt-in: `LOKI_FABLE_ARCHITECT`](#architecture-tier-opt-in-loki_fable_architect)
+  - [Financial / physical-stakes work (manual override, by design)](#financial--physical-stakes-work-manual-override-by-design)
+  - [Cost estimate honesty](#cost-estimate-honesty)
+- [Multi-Provider Support (v5.0.0)](#multi-provider-support-v500)
+- [Abstract Model Tiers](#abstract-model-tiers)
+  - [Enabling Haiku](#enabling-haiku)
+- [Model Selection by SDLC Phase](#model-selection-by-sdlc-phase)
+- [Task Tool Examples (Claude Only)](#task-tool-examples-claude-only)
+  - [Provider Detection in Code](#provider-detection-in-code)
+- [Task Categories](#task-categories)
+- [Parallelization Strategy (Claude Only)](#parallelization-strategy-claude-only)
+- [Extended Thinking Mode](#extended-thinking-mode)
+  - [Claude Adaptive Thinking (Effort Parameter)](#claude-adaptive-thinking-effort-parameter)
+  - [Codex --sandbox workspace-write Flag](#codex---sandbox-workspace-write-flag)
+- [Prompt Repetition for Haiku](#prompt-repetition-for-haiku)
+- [Advanced Parameters](#advanced-parameters)
+- [Confidence-Based Routing](#confidence-based-routing)
+- [Tiered Agent Escalation Triggers](#tiered-agent-escalation-triggers)
+  - [Tier Definitions](#tier-definitions)
+  - [Automatic Escalation Triggers](#automatic-escalation-triggers)
+  - [Threshold Rationale](#threshold-rationale)
+  - [Always-HIGH Triggers (No Escalation Path)](#always-high-triggers-no-escalation-path)
+  - [De-escalation Triggers (Cost Optimization)](#de-escalation-triggers-cost-optimization)
+  - [Escalation Flow Diagram](#escalation-flow-diagram)
+  - [Implementation in Provider Context](#implementation-in-provider-context)
+  - [Metrics for Tier Optimization](#metrics-for-tier-optimization)
+<!-- TOC:END -->
+
 ## Session-Pinned Model (default)
 
 Since v6.81.0, the main RARV loop uses **one pinned model per session** instead of rotating models per RARV phase. This eliminates per-iteration tier churn and keeps the main loop behavior predictable.

package/skills/openspec-integration.md

@@ -1,5 +1,21 @@
 # OpenSpec Integration
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [When This Module Applies](#when-this-module-applies)
+- [Delta-Aware Development Rules](#delta-aware-development-rules)
+  - [ADDED Requirements](#added-requirements)
+  - [MODIFIED Requirements](#modified-requirements)
+  - [REMOVED Requirements](#removed-requirements)
+- [Task Execution](#task-execution)
+- [Scenario Verification](#scenario-verification)
+- [Source Mapping](#source-mapping)
+- [Complexity Levels](#complexity-levels)
+- [Output Files Reference](#output-files-reference)
+- [Common Mistakes](#common-mistakes)
+<!-- TOC:END -->
+
 > **Reference:** OpenSpec delta specs use ADDED/MODIFIED/REMOVED sections to describe changes to existing system behavior. See `.loki/openspec/delta-context.json` for the parsed delta context injected into your prompt.
 
 ---

package/skills/parallel-workflows.md

@@ -1,5 +1,49 @@
 # Parallel Workflows with Git Worktrees
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [Why Worktree-Based Parallelism](#why-worktree-based-parallelism)
+- [Parallel Work Streams](#parallel-work-streams)
+- [Worktree Management Commands](#worktree-management-commands)
+  - [Create Feature Worktree](#create-feature-worktree)
+  - [Create Testing Worktree (based on main)](#create-testing-worktree-based-on-main)
+  - [Merge Completed Work](#merge-completed-work)
+  - [List and Clean Worktrees](#list-and-clean-worktrees)
+- [Orchestrator Workflow](#orchestrator-workflow)
+- [Supervisor / Judge Pattern](#supervisor--judge-pattern)
+  - [When the supervisor runs](#when-the-supervisor-runs)
+  - [Inputs and outputs](#inputs-and-outputs)
+  - [Resource state as input](#resource-state-as-input)
+- [Dynamic Resource-Aware Session Concurrency](#dynamic-resource-aware-session-concurrency)
+  - [Env knobs (all read in `autonomy/run.sh`)](#env-knobs-all-read-in-autonomyrunsh)
+  - [Honest ceiling: dozens, not thousands](#honest-ceiling-dozens-not-thousands)
+- [Claude Session Per Worktree](#claude-session-per-worktree)
+- [Inter-Stream Communication](#inter-stream-communication)
+  - [Signal Files](#signal-files)
+  - [Workflow Triggers](#workflow-triggers)
+- [Parallel Testing Strategy](#parallel-testing-strategy)
+  - [Continuous Testing Worktree](#continuous-testing-worktree)
+  - [Parallel Test Execution](#parallel-test-execution)
+- [Documentation Stream](#documentation-stream)
+  - [Auto-Documentation Triggers](#auto-documentation-triggers)
+  - [Blog Stream (if site has blog)](#blog-stream-if-site-has-blog)
+- [Worktree State Tracking](#worktree-state-tracking)
+  - [Orchestrator State Schema](#orchestrator-state-schema)
+  - [Dashboard Integration](#dashboard-integration)
+- [Spawn Parallel Streams Script](#spawn-parallel-streams-script)
+- [Optimistic Concurrency Control](#optimistic-concurrency-control)
+  - [The Problem with Locks](#the-problem-with-locks)
+  - [Optimistic Concurrency Pattern](#optimistic-concurrency-pattern)
+  - [Implementation](#implementation)
+  - [When to Use](#when-to-use)
+- [Limitations and Considerations](#limitations-and-considerations)
+  - [When NOT to Use Worktrees](#when-not-to-use-worktrees)
+  - [Merge Conflict Resolution](#merge-conflict-resolution)
+  - [Resource Considerations](#resource-considerations)
+- [Integration with Existing Patterns](#integration-with-existing-patterns)
+<!-- TOC:END -->
+
 > **Research basis:** Claude Code git worktrees pattern, Anthropic "One Feature at a Time" harness, HN production patterns on context isolation.
 
 ---

package/skills/patterns-advanced.md

@@ -1,5 +1,16 @@
 # Advanced Patterns
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [Problem Classification with Expert Hints (OptiMind Pattern)](#problem-classification-with-expert-hints-optimind-pattern)
+- [Ensemble Solution Generation (OptiMind Pattern)](#ensemble-solution-generation-optimind-pattern)
+- [Formal State Machines (k8s-valkey-operator Pattern)](#formal-state-machines-k8s-valkey-operator-pattern)
+- [Constitutional AI Self-Critique (Anthropic)](#constitutional-ai-self-critique-anthropic)
+- [Debate-Based Verification (DeepMind)](#debate-based-verification-deepmind)
+- [Code-Only Agent Pattern (rijnard.com)](#code-only-agent-pattern-rijnardcom)
+<!-- TOC:END -->
+
 ## Problem Classification with Expert Hints (OptiMind Pattern)
 
 **Classify problems before solving. Apply domain-specific expert hints.**

package/skills/production.md

@@ -1,5 +1,24 @@
 # Production Patterns
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [HN 2025 Production Patterns](#hn-2025-production-patterns)
+- [Proactive Context Management (OpenCode Pattern)](#proactive-context-management-opencode-pattern)
+- [Sub-Agents for Context Isolation](#sub-agents-for-context-isolation)
+- [Git Worktree Isolation (Cursor Pattern)](#git-worktree-isolation-cursor-pattern)
+- [Atomic Checkpoint/Rollback (Cursor Pattern)](#atomic-checkpointrollback-cursor-pattern)
+- [CI/CD Automation (Zencoder Patterns)](#cicd-automation-zencoder-patterns)
+  - [CI Failure Analysis and Auto-Resolution](#ci-failure-analysis-and-auto-resolution)
+  - [Automated Review Comment Resolution](#automated-review-comment-resolution)
+  - [Continuous Dependency Management](#continuous-dependency-management)
+- [Batch Processing (Claude API)](#batch-processing-claude-api)
+  - [When to Use Batch API](#when-to-use-batch-api)
+  - [Batch API Limits](#batch-api-limits)
+  - [Implementation Pattern](#implementation-pattern)
+  - [Batch + Prompt Caching](#batch--prompt-caching)
+<!-- TOC:END -->
+
 ## HN 2025 Production Patterns
 
 Narrow scope, deterministic outer loops and context engineering live in `references/production-patterns.md` (single source). The sections below cover deployment-side patterns.

package/skills/providers.md

@@ -1,5 +1,23 @@
 # Multi-Provider Support
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [Provider Comparison](#provider-comparison)
+- [Provider Selection](#provider-selection)
+- [Any Model, Any Provider (ANTHROPIC_BASE_URL)](#any-model-any-provider-anthropic_base_url)
+  - [Keeping the model catalog current](#keeping-the-model-catalog-current)
+- [Claude Code (Default, Full Features)](#claude-code-default-full-features)
+- [OpenAI Codex CLI (Experimental, Degraded Mode)](#openai-codex-cli-experimental-degraded-mode)
+- [Cline CLI (Tier 2 - Near-Full, 12+ Providers)](#cline-cli-tier-2---near-full-12-providers)
+- [Aider (Tier 3 - Degraded, 18+ Providers)](#aider-tier-3---degraded-18-providers)
+- [opencode (Model-Agnostic, 75+ Providers)](#opencode-model-agnostic-75-providers)
+- [Degraded Mode Behavior](#degraded-mode-behavior)
+- [Provider Configuration Files](#provider-configuration-files)
+- [Choosing a Provider](#choosing-a-provider)
+- [Guardrail Parity (engine10)](#guardrail-parity-engine10)
+<!-- TOC:END -->
+
 Loki Mode supports five AI providers for autonomous execution.
 
 ## Provider Comparison

package/skills/quality-gates.md

@@ -1,5 +1,59 @@
 # Quality Gates
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [The Quality Gates (8 blocking default-on + 3 advisory default-on + 1 opt-in)](#the-quality-gates-8-blocking-default-on--3-advisory-default-on--1-opt-in)
+  - [Conditional auditor (not numbered): Backward Compatibility (v6.67.0)](#conditional-auditor-not-numbered-backward-compatibility-v6670)
+- [Gate 7: Documentation Coverage (v6.75.0)](#gate-7-documentation-coverage-v6750)
+- [Gates 5 and 6: Automated Test Integrity](#gates-5-and-6-automated-test-integrity)
+- [Advisory default-on verification gates (LSP, semantic, invariant)](#advisory-default-on-verification-gates-lsp-semantic-invariant)
+  - [Migration: semantic and invariant flags were repurposed](#migration-semantic-and-invariant-flags-were-repurposed)
+  - [Coverage stays opt-in (the exception)](#coverage-stays-opt-in-the-exception)
+- [v7.5.0 Phase 1 environment flags](#v750-phase-1-environment-flags)
+- [Default-on verification-integrity gates (v7.41.1)](#default-on-verification-integrity-gates-v7411)
+- [Other opt-in environment flags (Release 3)](#other-opt-in-environment-flags-release-3)
+- [Output-token compressor (caveman, default-on, Claude-only)](#output-token-compressor-caveman-default-on-claude-only)
+- [Verified-completion evidence gate (v7.19.1, default-on)](#verified-completion-evidence-gate-v7191-default-on)
+  - [Counter-evidence file format (`.loki/state/counter-evidence-<iter>.json`)](#counter-evidence-file-format-lokistatecounter-evidence-iterjson)
+- [Held-out spec evals (v7.28.0, default-on when reserved)](#held-out-spec-evals-v7280-default-on-when-reserved)
+- [Uncertainty-gated escalation (v7.19.2, default-on)](#uncertainty-gated-escalation-v7192-default-on)
+  - [Trigger condition](#trigger-condition)
+  - [Action](#action)
+  - [Knobs](#knobs)
+  - [Honest limits](#honest-limits)
+- [Guardrails Execution Modes](#guardrails-execution-modes)
+- [Chain-of-Verification (CoVe) Protocol](#chain-of-verification-cove-protocol)
+  - [Core Insight](#core-insight)
+  - [The 4-Step CoVe Process](#the-4-step-cove-process)
+  - [Step-by-Step Implementation](#step-by-step-implementation)
+  - [Factor+Revise Variant (Longform Code Generation)](#factorrevise-variant-longform-code-generation)
+  - [Why Factored Execution Matters](#why-factored-execution-matters)
+  - [CoVe Integration with Blind Review](#cove-integration-with-blind-review)
+  - [Metrics](#metrics)
+- [Velocity-Quality Feedback Loop (CRITICAL)](#velocity-quality-feedback-loop-critical)
+  - [Key Findings](#key-findings)
+  - [The Trap to Avoid](#the-trap-to-avoid)
+  - [Mandatory Quality Checks (Per Task)](#mandatory-quality-checks-per-task)
+  - [Metrics to Track](#metrics-to-track)
+- [Specialist Review Pool (v5.30.0)](#specialist-review-pool-v5300)
+  - [Selection Rules](#selection-rules)
+  - [Adding Your Own Reviewer (extension seam)](#adding-your-own-reviewer-extension-seam)
+  - [Dispatch Pattern](#dispatch-pattern)
+  - [Rules (unchanged from blind review)](#rules-unchanged-from-blind-review)
+- [Two-Stage Review Protocol](#two-stage-review-protocol)
+  - [Why Separate Stages Matter](#why-separate-stages-matter)
+  - [Stage 1: Spec Compliance Review](#stage-1-spec-compliance-review)
+  - [Stage 2: Code Quality Review](#stage-2-code-quality-review)
+  - [Implementation in Loki Mode](#implementation-in-loki-mode)
+  - [Common Anti-Pattern](#common-anti-pattern)
+- [Severity-Based Blocking](#severity-based-blocking)
+- [Scale Considerations](#scale-considerations)
+  - [Review Intensity Scaling](#review-intensity-scaling)
+  - [Judge Agent Integration](#judge-agent-integration)
+  - [Cursor's Key Learning](#cursors-key-learning)
+<!-- TOC:END -->
+
 **Never ship code without passing all quality gates.**
 
 ## The Quality Gates (8 blocking default-on + 3 advisory default-on + 1 opt-in)

package/skills/release-cadence.md

@@ -1,5 +1,21 @@
 # Release Cadence (skill module)
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [1. The gate decision, and why two files appear to disagree](#1-the-gate-decision-and-why-two-files-appear-to-disagree)
+  - [1.1 The apparent contradiction, resolved](#11-the-apparent-contradiction-resolved)
+- [2. What the fast tier must contain: the artifact rule](#2-what-the-fast-tier-must-contain-the-artifact-rule)
+  - [2.1 The two rules that generalise past packaging](#21-the-two-rules-that-generalise-past-packaging)
+- [3. What the pipeline enforces for you](#3-what-the-pipeline-enforces-for-you)
+- [4. The two ways a release silently publishes nothing](#4-the-two-ways-a-release-silently-publishes-nothing)
+  - [4.1 The VERSION bump must be the push HEAD](#41-the-version-bump-must-be-the-push-head)
+  - [4.2 Pushing during the window cancels the release's Tests](#42-pushing-during-the-window-cancels-the-releases-tests)
+- [5. After the push: verify provenance, not the version string](#5-after-the-push-verify-provenance-not-the-version-string)
+  - [5.1 Confirm a release-critical fix THREE ways, never one](#51-confirm-a-release-critical-fix-three-ways-never-one)
+- [6. The cadence, end to end](#6-the-cadence-end-to-end)
+<!-- TOC:END -->
+
 **Purpose:** the shortest VERIFIED path from idea to published. Shortest and
 verified are both load-bearing; this repo has shipped fast and shipped nothing
 at the same time, four times in a row, and the cost was invisible for days.

package/skills/sdlc-fleet.md

@@ -1,5 +1,22 @@
 # SDLC Fleet Pattern (skill module)
 
+<!-- TOC:START (generated by scripts/skill-toc.sh; do not edit) -->
+## Contents
+
+- [When to invoke this pattern](#when-to-invoke-this-pattern)
+- [The 6 roles](#the-6-roles)
+  - [1. Architect (1 agent, Plan subagent_type, model: opus)](#1-architect-1-agent-plan-subagent_type-model-opus)
+  - [2. Product Owner (the integrator, NOT a separate agent)](#2-product-owner-the-integrator-not-a-separate-agent)
+  - [3. Dev Fleet (3-5 principal engineers in parallel, model: opus)](#3-dev-fleet-3-5-principal-engineers-in-parallel-model-opus)
+  - [4. SDET (1-2 agents, model: opus)](#4-sdet-1-2-agents-model-opus)
+  - [5. Council Reviewers (3 agents, parallel, model: 2 opus + 1 sonnet)](#5-council-reviewers-3-agents-parallel-model-2-opus--1-sonnet)
+  - [6. Real-User QA (1 agent OR the integrator directly)](#6-real-user-qa-1-agent-or-the-integrator-directly)
+- [Parallel-execution rules](#parallel-execution-rules)
+- [Honest acknowledgements pattern](#honest-acknowledgements-pattern)
+- [Reference run: v7.6.0 LSP integration](#reference-run-v760-lsp-integration)
+- [Per-release checklist (always)](#per-release-checklist-always)
+<!-- TOC:END -->
+
 **Established:** v7.7.4 (2026-05-24)
 **Origin:** user mandate "agent teams with senior most developers, Loki architects, sdet team and council of reviewers exist and coordinate and work in parallel"
 **Proven by:** v7.6.0 fleet ship (architect + 3 principal engineers + SDET + 3-reviewer council + real-user QA) demonstrated the pattern works end-to-end.