@jakkrichm/create-nexus-devflow 2.5.0 → 2.6.1

package/template/.agents/skills/check/SKILL.md

@@ -1,108 +1,113 @@
 ---
 name: check
-description: "[devflow][F] Prove the current work actually does what its spec says by running the real app and observing behavior against the \"done when\" criteria in current-feature.md. Drives the app (browser, CLI, or server), captures evidence (screenshots, output, console/network errors), and reports pass/fail per criterion. Does not edit source or commit - it observes; fixing stays /implement's job. Use when the user runs /check, asks to confirm a step or feature works, wants proof before /complete, or wants to check a change in the running app rather than just the build. (Supersedes the built-in /verify with a spec-aware version inside blueprint projects.)"
+description: "[devflow] Prove the current work actually does what its spec says and adheres to architectural standards through a Dual-Axis Independent Review. Supports Multi-Run: given an optional ID or name (/check 12), targets that spec and records proof to devflow/context/{xxx-slug}/findings.md. Drives the app, captures empirical evidence, checks Fowler smells, and reports pass/fail. Use when running /check, confirming work, or validating before /complete."
+argument-hint: "[{run-id, number, or name}]"
 ---
 
-# check - prove it works against the spec, with evidence
+# check - Dual-Axis Independent Verification Engine
 
 Where this sits in the workflow:
 
     /implement  ->  [check]  ->  /complete
-    (built a       (run the app,    (only once the
-     step or        prove each       done-whens are
-     the feature)   done-when)       proven)
+    (built a       (dual-axis       (only once both
+     step or        review with      axes pass with
+     the feature)   empirical proof) evidence)
 
-`/implement` builds and does a quick build-plus-screenshot check inline. `/check`
-is the deeper, repeatable gate for when a "done when" needs the *real running app*,
-not just a green build: a click that triggers a download, a route that returns a
-file, a flow across screens. Run it on a single step whose done-when is
-behavioral, or on the whole feature as the acceptance check before `/complete`.
+`/implement` builds and does a quick build-plus-screenshot check inline. `/check` is the rigorous, repeatable gate for when a feature or step needs **empirical proof** on the running app and **two-axis code review** before merging.
 
-The point is evidence. A passing build proves the code compiles; `/check` proves
-the thing the spec promised actually happens. It changes no source and commits
-nothing - it runs the app and reports what it saw.
+It changes no source and commits nothing — it executes, inspects, and reports observed facts.
+
+---
 
 ## Input
 
-Optional: a specific thing to check (a step, a flow, a URL). With no argument,
-verify the whole current feature against every "done when" in
-`devflow/context/current-feature.md`.
+- **Given an ID or name** (e.g. `/check 12`, `/check 012`) -> targets `devflow/context/{xxx-slug}/` and records audit ledger to `{xxx-slug}/findings.md`.
+- **With no argument** (`/check`) -> verifies the active run matching current git branch or single active spec.
 
-## Step 1 - build the checklist
+---
 
-Read `devflow/context/current-feature.md`. Pull the observable "done when"
-criteria from the build steps (and any acceptance notes in the Testing section).
-Turn them into a concrete checklist of claims to prove - each one a specific,
-observable behavior, not "it works". If the user named one thing, scope to that.
+## Step 1 - Build the Dual-Axis Review Matrix
 
-If there's no current feature spec, ask what to verify rather than guessing.
+Read the target spec from `devflow/context/{xxx-slug}/spec.md` (or `devflow/context/current-feature.md`) and `devflow/context/coding-standards.md`. Prepare the inspection criteria across two independent axes:
 
-## Step 2 - get the app running
+1. **Axis 1 (Standards & Architecture Criteria)**:
+   - Coding conventions in `coding-standards.md`
+   - Deep Modules discipline (Small interface, deep implementation, clean seams, no leaky abstractions)
+   - Baseline 12 Fowler Code Smells (Primitive obsession, Feature envy, Shotgun surgery, Speculative generality, etc.)
+   - Multi-lane technical gates (Typecheck, test suites, zero secrets, zero P0/P1 findings)
+2. **Axis 2 (Spec Fidelity & Behavioral Observables)**:
+   - Line-by-line Acceptance Criteria (ACs) and "Done When" observables from `current-feature.md`
+   - Scope Creep detection (Unrequested behavior in the diff)
+   - Missing Requirements detection (Unimplemented edge cases)
 
-Use the project's real commands (see Commands in `AGENTS.md`). Match the project
-type:
+---
 
-- **Web app** - start (or reuse) the dev/preview server, then drive a real browser
-  to the relevant routes. Prefer reusing an already-running server over starting a
-  duplicate. If Playwright is already installed or declared in `AGENTS.md`, prefer
-  it for browser driving, screenshots, console errors, and failed request checks.
-  If it is not installed, do not add it from `/check`; use another real-browser
-  evidence path and report what you used.
-- **CLI** - run the actual command(s) with representative inputs.
-- **Server/API** - start it and hit the endpoints.
-- **Library** - exercise the public API through an example or the test command.
+## Step 2 - Get the App Running & Exercise Live Proof
 
-If a `test` command is declared in `AGENTS.md`, you may run it as *one* input, but
-`/check` is broader than unit tests: it checks real behavior, which is exactly the
-evidence UI and integration steps ride on instead of unit tests.
+Use the project's real commands (from `AGENTS.md`):
 
-## Step 3 - exercise each claim
+- **Web app**: Start (or reuse) the local dev server. Drive a real browser to relevant routes. Prefer Playwright when installed for screenshots, network errors, and console assertions.
+- **CLI**: Execute commands with representative input fixtures, asserting exit codes and output snapshots.
+- **Server / API**: Hit endpoints with real payloads and assert on HTTP response status and bodies.
+- **Library**: Exercise public interfaces through integration tests or sample scripts.
 
-Drive the app to each checklist item and capture evidence as you go:
+> [!IMPORTANT]
+> **Evidence or it didn't happen**: Every verdict must be backed by empirical evidence (screenshot, command output, status code, response time). Never assume a pass from reading source code alone.
 
-- Navigate and interact for real (click, type, submit, download) - don't assert
-  from the code what the running app would do.
-- Capture **screenshots** for visual/UI claims, **output** for CLI/API claims.
-- Watch for **console errors and failed network requests**; a clean-looking screen
-  with errors in the console is not a pass.
+---
 
-## Step 4 - report (Two-Stage Review Pattern)
+## Step 3 - Dual-Axis Independent Report
 
-Format the verification report into two explicit review stages:
+Format the report into two distinct, un-merged review axes:
 
-### Stage 1: Spec Fidelity & Acceptance Gate
-Give a line-by-line verdict for each Acceptance Criterion and "done when" item:
+```markdown
+# 🔍 Verification Report: [Feature Name]
 
-    [pass] AC-1: Download PDF saves certificate-<slug>.pdf - file downloaded, opened to cert
-    [pass] AC-2: Both buttons show a loading state - screenshot: loading-state.png
-    [fail] AC-3: PDF border missing - printBackground not set; screenshot: pdf-no-border.png
-    [skip] AC-4: Vercel deploy smoke test - can't verify locally (pending staging)
+## ⚖️ Axis 1: Standards, Architecture & Quality Gate
 
-### Stage 2: Code Quality, Security & Architecture Gate
-Report the multi-lane technical verification results:
-- **Type & Syntax**: `tsc --noEmit` (0 errors)
-- **Automated Tests**: Unit & integration tests (100% pass)
-- **Security & Hygiene**: Zero secrets, sanitized inputs
-- **Findings Ledger**: 0 blockers (P0/P1) in `devflow/context/findings.md`
+- **Technical Lanes**:
+  - [pass] Type Safety: `tsc --noEmit` (0 errors)
+  - [pass] Automated Tests: `npm test` (All tests green)
+  - [pass] Security & Hygiene: Zero secrets, sanitized inputs
+  - [pass] Findings Ledger: 0 blocking P0/P1 in `devflow/context/findings.md`
+- **Deep Modules & Architecture**:
+  - [pass] Seam Integrity: Public interfaces remain small, implementation details hidden.
+  - [pass] The Deletion Test: Complexity is concentrated inside the module, not scattered across callers.
+- **Code Smells Assessment**:
+  - [clean] 12 Fowler Code Smells evaluated across git diff: No critical smells detected.
 
-### Final Verdict & Route
-- **All Passed**: State that the feature is verified and ready for `/complete`.
-- **Any Failure**: Hand back to `/implement` with exact failure evidence and reproduction steps. Never fix issues inside `/check`.
-- **Unverifiable**: Clearly state reasons and residual risk. Never fabricate a pass.
+## 🎯 Axis 2: Spec Fidelity & Behavioral Acceptance Gate
 
-## Rules
+Line-by-line verification against `current-feature.md`:
+- [pass] **AC-1 (<title>)**: <Observed empirical evidence / screenshot path>
+- [pass] **AC-2 (<title>)**: <Observed empirical evidence / terminal output>
+- [fail] **AC-3 (<title>)**: <Exact observed failure with reproduction command>
+- [clean] **Scope Creep Check**: No unrequested features or unnecessary abstractions introduced.
+- [clean] **Completeness Check**: 100% of spec requirements addressed.
+
+---
+
+## 🚦 Final Routing & Verdict
 
-- **Observe, don't change.** `/check` runs the app and reports. It never edits
-  source, never commits, never merges. Fixing is `/implement`'s job.
-- **Evidence or it didn't happen.** Every `pass` is backed by something observed -
-  a screenshot, output, a response. No assumed passes from reading the code.
-- **Honest over green.** "Couldn't verify" and "failed" are valid, useful results.
-  Faking a pass defeats the entire gate.
-- **Check the spec, not vibes.** Verify against the done-whens in
-  `current-feature.md`, so "works" means what the spec said it would do.
+- **ALL PASSED**: Both axes green. Ready for `/complete`.
+- **ANY FAILURE**: Hand back to `/implement` with exact failure evidence and reproduction steps.
+- **UNVERIFIABLE**: Clearly document the gap and residual risk. Never fabricate a pass.
+```
 
-## Formatting
+---
+
+## Why Two Independent Axes?
+
+A code change can pass one axis and fail the other:
+- **Standards Pass, Spec Fail**: Code is beautifully architected and tested, but implements the wrong business behavior.
+- **Spec Pass, Standards Fail**: Feature works end-to-end, but violates encapsulation, introduces shallow modules, or leaks secrets.
+
+Reporting both axes side-by-side stops elegance from masking functional bugs, and stops functional completeness from excusing architectural rot.
+
+---
+
+## Rules
 
-Format the output to match the project's conventions in
-`devflow/context/ai-interaction.md`: concise, scannable markdown, with lists for
-enumerations and tables for matrices rather than dense paragraphs.
+- **Observe, don't change**: `/check` runs the app and reports. It never edits source or commits. Fixing is `/implement`'s job.
+- **Honest over green**: "Failed" and "Could not verify" are valid, valuable outputs. Faking a pass destroys the gate.
+- **Check the spec, not vibes**: Verify against documented ACs, not subjective feelings.

package/template/.agents/skills/ci/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ci
-description: "[devflow][B] Set up or normalize automatic GitHub checks for a Blueprint project around one documented Verify command. Detects the real stack, package manager, existing checks, default branch, and workflows; preserves existing CI; combines only configured typecheck, test, and build commands; runs the command locally; and stops before push or remote ruleset changes. Use when the user runs /ci, invokes $ci, asks to add CI, set up GitHub Actions, add pull-request checks, or create automatic GitHub checks."
+description: "[devflow] Set up or normalize automatic GitHub checks for a Blueprint project around one documented Verify command. Detects the real stack, package manager, existing checks, default branch, and workflows; preserves existing CI; combines only configured typecheck, test, and build commands; runs the command locally; and stops before push or remote ruleset changes. Use when the user runs /ci, invokes $ci, asks to add CI, set up GitHub Actions, add pull-request checks, or create automatic GitHub checks."
 ---
 
 # ci - set up automatic GitHub checks

package/template/.agents/skills/complete/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: complete
-description: "[devflow][F] Wrap up a finished feature, fix, or rollback. Runs a final safety pass, archives its spec to devflow/history/features/, devflow/history/fixes/, or devflow/history/rollbacks/, updates the build plan for features and rollbacks, resets devflow/context/current-feature.md to its stub, and makes the work commit. Enforces a mandatory user gate: asks whether to squash-merge to main/master OR pull latest main/master into the feature/dev branch and push to remote for Merge Request (MR / PR) creation. Never merges into main/master without explicit user instruction."
+description: "[devflow] Wrap up a finished feature, fix, or rollback. Supports Multi-Run: given an optional ID (/complete 12), archives that run from devflow/context/{xxx-slug}/ to devflow/history/, cleans up the run workspace, updates build-plan and HISTORY.md, and makes the work commit. Enforces mandatory user gate (Squash-merge vs MR/PR)."
+argument-hint: "[{run-id, number, or name}]"
 ---
 
 # complete - log the finished work, make the work commit, and deliver
@@ -12,13 +13,18 @@ Where this sits in the workflow:
 
 `/implement` built the feature, fix, or rollback on its branch, with optional per-step commit
 checkpoints. This skill closes it out: it logs the work, makes the single
-work-level commit, and guides the delivery through a **Mandatory User Delivery Gate**. Run it only when the work is done,
+work-level commit, archives from `devflow/context/{xxx-slug}/`, cleans up the active run workspace, and guides the delivery through a **Mandatory User Delivery Gate**. Run it only when the work is done,
 reviewed, and the documented `Verify` command, or the fallback build and tests,
 passes.
 
+## Multi-Run Target Resolution
+
+- **Given an ID or name** (e.g. `/complete 12`, `/complete 058`) -> targets `devflow/context/{xxx-slug}/` for archiving and cleanup.
+- **With no argument** (`/complete`) -> targets the run matching the active branch or single active spec.
+
 ## Before you start
 
-Confirm the work is actually finished: `devflow/context/current-feature.md`
+Confirm the target work is actually finished: `devflow/context/{xxx-slug}/spec.md` (or `current-feature.md`)
 holds a real spec, its steps are built on a branch, and `Verify`, or the fallback
 build and tests, passes. If any of the
 spec's done-whens are behavioral, `/check` should have proven them against the

package/template/.agents/skills/convert-any-to-md/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: convert-any-to-md
-description: "[devflow][B] Converts any document (.xlsx, .pdf, .docx, .txt, .csv, .log, .json, .yaml, etc.) or mixed folders into clean Markdown in devflow/reference. Use whenever documents need to be analyzed, summarized, searched, or extracted from."
+description: "[devflow] Converts any document (.xlsx, .pdf, .docx, .txt, .csv, .log, .json, .yaml, etc.) or mixed folders into clean Markdown in devflow/reference. Use whenever documents need to be analyzed, summarized, searched, or extracted from."
 ---
 
 # Convert Any Document to Markdown

package/template/.agents/skills/debug/SKILL.md

@@ -1,9 +1,9 @@
 ---
 name: debug
-description: "[devflow][B] Diagnose a failing test, broken build, crash, error, regression, or unexpected behavior without editing source or Blueprint state. Reproduces the symptom with the smallest safe command, localizes the failing path, tests competing hypotheses, identifies the root cause when evidence supports one, and reports a repair handoff to /fix or /implement. Use when the user runs /debug, invokes $debug, asks why something is failing or broken, wants a root-cause investigation, or asks to diagnose before fixing."
+description: "[devflow] Diagnose a failing test, broken build, crash, error, regression, or unexpected behavior without editing source or DevFlow state. Follows a strict 6-Phase Scientific Debugging Loop: builds a red-capable tight feedback loop, reproduces & minimises, tests 3-5 falsifiable hypotheses, localizes the failure to a root cause, and reports a repair handoff to /fix or /implement. Use when the user runs /debug, invokes $debug, asks why something is failing or broken, wants a root-cause investigation, or asks to diagnose before fixing."
 ---
 
-# debug - find the cause before changing the code
+# debug - 6-Phase Scientific Debugging Protocol
 
 Where this sits in the workflow:
 
@@ -12,130 +12,112 @@ Where this sits in the workflow:
      crash, behavior)       isolate,       repair active work)
                             explain)
 
-`/debug` separates diagnosis from repair. It gathers evidence, narrows the
-failure to a specific cause when possible, and stops with a useful handoff. It
-does not make the code "temporarily work" while investigating.
+`/debug` separates diagnosis from repair. It gathers empirical evidence, narrows the failure to a specific root cause using scientific method, and stops with an actionable repair handoff. It does not guess, assume, or perform ad-hoc "vibe debugging".
+
+---
 
 ## Input
 
 Accept a symptom, failing command, error message, or unexpected behavior. Examples:
 
-    /debug npm test fails in cart-total.test.js
+    /debug npm test fails in cart-total.test.ts
     /debug the upload route returns 500 for PNG files
-    /debug why does the production build fail?
+    /debug why does the build fail on Windows?
 
-With no useful symptom, ask for the expected behavior, actual behavior, and
-smallest known reproduction. Do not guess which problem the user means.
+With no useful symptom, ask for expected behavior, actual behavior, and smallest known reproduction. Do not guess.
 
-## Step 1 - establish the boundary
+---
 
-Read the project instructions and the context relevant to the failure:
+## 🔬 The 6-Phase Scientific Debugging Loop
 
-- `AGENTS.md` and its real commands
-- `devflow/context/project-overview.md`
-- `devflow/context/coding-standards.md`
-- `devflow/context/current-feature.md`
-- the reported error, failing output, and affected files
-- git status, diff, and recent log when a regression is possible
+### Phase 1: Build a Red-Capable Feedback Loop (Golden Rule)
 
-State the symptom and what would count as reproducing it. Note whether the
-failure belongs to an active feature or is an unplanned bug.
+**This is the core discipline.** If you have a **tight** pass/fail command that actively goes RED on this bug, you will find the root cause. If you do not have one, staring at code will not save you.
 
-Do not treat a dirty working tree as permission to discard or rewrite anything.
-Use the diff as evidence and preserve it.
+**Spend disproportionate effort here. Ways to construct one (in order):**
+1. **Failing Unit / Integration Test** at the responsible module seam.
+2. **Curl / HTTP script** against the running local dev server.
+3. **CLI invocation** diffing stdout/stderr against expected output.
+4. **Headless browser script** (Playwright) asserting on DOM/network/console.
+5. **Replay captured trace**: Replay isolated payload/event log through the code path.
 
-## Step 2 - reproduce safely
+**Completion Criterion for Phase 1**:
+You must name **one single command** (a test invocation, a script, or curl) that you have **already run at least once** and proven:
+- [ ] **Red-capable**: It exercises the actual code path and catches the user's exact symptom (fails red now, will pass green once fixed).
+- [ ] **Deterministic**: Returns the same verdict every run.
+- [ ] **Fast & Agent-runnable**: Completes in seconds, executable without manual intervention.
 
-Run the smallest existing command or interaction that can reproduce the symptom.
+> [!CAUTION]
+> **No Red-Capable Command = No Phase 2.** If you catch yourself reading code to form theories before this command exists, **STOP**. Jumping straight to a hypothesis is the exact failure this protocol prevents.
 
-- Prefer one focused test, request, CLI command, or input over the entire suite.
-- Capture the exact exit code, error, stack trace, output, response, console
-  error, or failed request.
-- Reuse an already-running local app when available. If reproduction requires a
-  long-running server that is not running, ask the user to start it and provide
-  the documented command.
-- Do not install dependencies, change configuration, run migrations, mutate
-  production data, contact external users, or use destructive commands to force
-  a reproduction.
-- Do not edit code to add logs or probes. Use existing logs, debuggers,
-  read-only inspection, or one-off commands that do not change project files.
-- Compare git status after diagnostic commands. If one changes tracked or
-  untracked project files, stop and report those paths. Do not clean, restore,
-  or hide the changes.
+---
 
-If the symptom cannot be reproduced, say what was attempted and what evidence is
-missing. Continue with static investigation only when it can produce a clearly
-labeled hypothesis, not a claimed root cause.
+### Phase 2: Reproduce & Minimise
 
-## Step 3 - localize the failure
+Run the feedback loop and watch it go RED.
 
-Trace from the observed failure toward the smallest responsible area.
+1. **Confirm Symptom**: Ensure the failure mode matches what the user reported (not a nearby unrelated error).
+2. **Minimise the Repro**: Cut inputs, configs, dependencies, and steps **one at a time**, re-running the command after each cut. Keep only what is load-bearing for the failure.
+3. **Done when**: Every remaining parameter is load-bearing (removing any one makes the loop go green).
 
-Use the evidence that fits the project:
+---
 
-- the first relevant application frame in a stack trace
-- the smallest failing test and its inputs
-- request and response data at the failing boundary
-- console and network errors
-- callers, imports, data flow, and configuration reads
-- `git diff`, `git log`, and `git blame` for a suspected regression
-- comparison with a nearby working path or input
+### Phase 3: Form 3–5 Ranked Falsifiable Hypotheses
 
-Separate facts from hypotheses. Test the cheapest safe competing explanations
-first. Do not stop at the first plausible line, blame a dependency without
-evidence, or confuse the place an error surfaced with the place it originated.
+Generate **3 to 5 ranked hypotheses** before testing or inspecting deeply. Never anchor on the first plausible idea.
 
-## Step 4 - confirm or narrow
+Every hypothesis MUST be **falsifiable** using this exact format:
+> *"If `<X>` is the cause, then `<changing Y>` will make the bug disappear / `<changing Z>` will make it worse."*
 
-A root cause is confirmed only when the evidence connects all three:
+If you cannot state the prediction, it is a vibe: sharpen or discard it.
 
-1. the triggering input or state
-2. the responsible code, configuration, or contract
-3. the observed failure
+---
 
-When safe and read-only, vary one input or run a smaller focused command to
-confirm the connection. Do not change implementation or tests to prove the fix.
+### Phase 4: Targeted Instrumentation & Isolation
 
-Use one of these verdicts:
+Test hypotheses by changing **one variable at a time**:
+1. **Tool preference**: Read-only inspection > REPL/debugger > Targeted probe logs.
+2. **Debug Tag Rule**: If temporary diagnostic logs are necessary, tag every log line with a unique prefix, e.g. `[DEBUG-a4f2]`. This guarantees a single `grep` can find and remove all probes.
+3. **Redaction**: Redact all secrets, tokens, and credentials in terminal outputs (`<REDACTED>`).
 
-- **Confirmed** - evidence identifies the cause and explains the failure.
-- **Likely** - evidence narrows the cause, but one specific proof is unavailable.
-- **Blocked** - the failure cannot be reproduced or required evidence is
-  inaccessible.
+---
 
-## Step 5 - report and hand off
+### Phase 5: Confirm Root Cause at Real Seam
 
-Give a concise debug report:
+A root cause is **Confirmed** only when empirical evidence connects all three:
+1. The triggering input or state
+2. The responsible code / configuration boundary
+3. The observed failure
 
-- symptom and reproduction
-- verdict
-- root cause or leading hypothesis
-- evidence, including commands and relevant paths
-- affected behavior and likely repair boundary
-- what was not verified
-- exact next action
+**Seam Identification**: Identify the exact architectural seam (per `devflow/context/coding-standards.md` Deep Modules) where the regression test must live. If no clean seam exists, note that as an architectural finding.
 
-Choose the next action without writing files:
+---
+
+### Phase 6: Report & Hand-off
+
+Give a structured, concise debug report:
 
-- Active feature or fix caused the failure -> return the diagnosis to `/implement` with instructions to write a failing reproduction test ([TDD-Red]) first.
-- No active work item and the bug is confirmed -> recommend `/fix "<concise bug and confirmed cause>"` (which will write a failing test first before fixing).
-- Cause is only likely or blocked -> recommend the next diagnostic evidence, not a speculative repair.
-- The issue is planned product work rather than a defect -> point to `/feature`.
+```markdown
+### 🐞 Debug Report: <Concise Title>
+
+- **Symptom**: <Exact user symptom observed>
+- **Reproduction Command**: `<Single red-capable command>`
+- **Verdict**: Confirmed | Likely | Blocked
+- **Root Cause**: <Precise technical explanation of why it failed>
+- **Responsible Seam**: `<path/to/file.ts#line>`
+- **Evidence**:
+  - Test/Curl output confirming the red signal
+  - Trace connecting triggering state to failure
+- **Next Action**:
+  - For active feature -> Hand back to `/implement` with instructions to write failing test first.
+  - For standalone bug -> Recommend `/fix "<concise description>"` to create spec and implement regression test.
+```
+
+---
 
 ## Rules
 
-- Diagnose, do not repair. Never edit source, tests, configuration, lockfiles, or
-  Blueprint files.
-- Never create, switch, merge, or delete branches. Never commit or push.
-- Do not update the findings ledger. `/audit` owns recorded code-quality
-  findings; `/debug` reports one investigated failure in chat.
-- Evidence outranks confidence. Label uncertainty and failed reproduction
-  honestly.
-- Preserve the user's working tree and running processes.
-- Do not broaden one failure into a general audit or refactor.
-
-## Formatting
-
-Format the output to match the project's conventions in
-`devflow/context/ai-interaction.md`: concise, scannable markdown with a short
-evidence list and a clear next action.
+- **Diagnose, do not repair**: Never edit production source, package lockfiles, or DevFlow state inside `/debug`.
+- **Evidence outranks confidence**: Label uncertainty honestly (`Likely` vs `Confirmed`).
+- **Preserve git state**: Never switch branches, commit, reset, or clean the working tree.
+- **Clean up probes**: Ensure any temporary test scripts in scratch/ are cleanly referenced.

package/template/.agents/skills/devflow/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: devflow
-description: "[devflow][B] Flagship interactive guide, state inspector, and intent router for DevFlow workflows."
+description: "[devflow] Flagship interactive guide, state inspector, and intent router for DevFlow workflows."
 ---
 
 # devflow - Interactive Workflow Guide & Intent Router for Nexus-DevFlow

package/template/.agents/skills/discovery/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: discovery
-description: "[devflow][D] Unified discovery and exploration stage in DevFlow 2.0 - conducts project-level roadmap discovery (project-plan.md/build-plan.md) or feature-level exploration (Stage 00) before delivery commitment."
+description: "[devflow] Unified discovery and exploration stage in DevFlow 2.5.0 - conducts project-level roadmap discovery (project-plan.md/build-plan.md) or feature-level pre-delivery exploration before the Single Living Spec lifecycle."
 argument-hint: "[{title, request, IDEA-xxx, or discovery-id}]"
 ---
 
@@ -10,7 +10,7 @@ $ARGUMENTS
 
 `/discovery` is the central discovery entry point in Nexus-DevFlow. It operates in two adaptive modes based on input scope:
 1. **🗺️ Macro Project Discovery**: Develops high-level product and build roadmap plans (`devflow/project-plan.md` & `devflow/build-plan.md`) through an adaptive conversation before `/overview`.
-2. **🔍 Micro Feature Exploration (Stage 00)**: Explores a specific feature, request, or idea before committing to delivery, routes through supporting lenses, and finishes with a visible `Proceed`, `Defer`, or `Reject` decision before `10-define`.
+2. **🔍 Micro Feature Exploration (Pre-Flight)**: Explores a specific feature, request, or idea before committing to delivery, routes through supporting lenses, and finishes with a visible `Proceed`, `Defer`, or `Reject` decision before `/feature` or `/fix`.
 
 ---
 
@@ -21,7 +21,7 @@ $ARGUMENTS
 /discovery
 /discovery --project
 
-# 2. Micro Feature Exploration Mode (Stage 00 of Deep-Track)
+# 2. Micro Feature Exploration Mode (Pre-Flight)
 /discovery {title or request}
 /discovery IDEA-xxx
 /discovery {discovery-id}
@@ -44,7 +44,7 @@ Use when:
 
 ---
 
-## Mode 2: Micro Feature Exploration (Stage 00 of Deep-Track)
+## Mode 2: Micro Feature Exploration (Pre-Flight)
 
 Use when:
 - Exploring a specific feature, complex architectural change, or pending idea (`/discovery IDEA-xxx`).
@@ -76,8 +76,7 @@ devflow/discoveries/{DISCOVERY_ID}-{slug}/discovery.md
 ### Decision & Approval Gate:
 Set one visible decision:
 - `Proceed`: Enough value and evidence exist to define delivery work:
-  - **🏎️ Fast-Track (Recommended for 85% of standard features/fixes)**: Handoff to `/feature {discovery_id}` or `/fix {discovery_id}` (writes `devflow/context/current-feature.md`).
-  - **🏗️ Deep-Track (For large architectural epics/migrations)**: Handoff to `10-define {discovery_id}` (writes `devflow/context/current-run/10-define.md`).
+  - Handoff to `/feature {discovery_id}` or `/fix {discovery_id}` to create the Single Living Spec in `devflow/context/current-feature.md`.
 - `Defer`: The idea remains relevant but timing or evidence is not ready.
 - `Reject`: The idea should not proceed under current framing.
 
@@ -86,6 +85,5 @@ Set one visible decision:
 ## Next Workflow Recommendations
 
 - **From Macro Project Mode**: Run `/overview` to compile context into `devflow/context/project-overview.md`.
-- **From Micro Stage 00 (Approved Proceed ➔ Fast-Track)**: Run `/feature {discovery_id}` to start lean living spec.
-- **From Micro Stage 00 (Approved Proceed ➔ Deep-Track)**: Run `10-define {discovery_id}` to allocate a Running ID.
-- **From Micro Stage 00 (Defer / Reject)**: No next command needed.
+- **From Micro Pre-Flight (Approved Proceed)**: Run `/feature {discovery_id}` or `/fix {discovery_id}` to start the Single Living Spec lifecycle.
+- **From Micro Pre-Flight (Defer / Reject)**: No next command needed.

package/template/.agents/skills/doctor/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: doctor
-description: "[devflow][B] Run a read-only Blueprint health check for setup, onboarding, required files, tool adapters, commands, optional verification and CI, Blueprint visibility, ignore rules, planning readiness, overview freshness, and workflow drift. Use when the user runs /doctor, asks whether the Blueprint is installed correctly, wants a health check, setup check, doctor pass, or says something feels off before starting or resuming work."
+description: "[devflow] Run a read-only Blueprint health check for setup, onboarding, required files, tool adapters, commands, optional verification and CI, Blueprint visibility, ignore rules, planning readiness, overview freshness, and workflow drift. Use when the user runs /doctor, asks whether the Blueprint is installed correctly, wants a health check, setup check, doctor pass, or says something feels off before starting or resuming work."
 ---
 
 # doctor - Blueprint health check

package/template/.agents/skills/feature/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: feature
-description: "[devflow][F] Turn a feature from build-plan.md into a buildable spec. With no argument, specs the next unchecked item in the build plan; given a number or name, specs that one. If a clearly new feature does not match the plan, proposes a reviewed plan addition, refreshes the overview after approval, then specs it. Sizes the feature and splits anything too big into smaller sub-features (4a, 4b, ...), writes small, reviewable build steps to devflow/context/current-feature.md, then red-teams its own draft for gaps, oversized steps, and scope creep before stopping at a review gate. Use when the user runs /feature, names or numbers a feature, asks to add and start a new feature, or asks to spec out, break down, or start the next feature."
+description: "[devflow] Turn a feature from build-plan.md into a buildable living spec. Supports Multi-Run Spec Queue: drafts dedicated context in devflow/context/{xxx-slug}/ without blocking additional specs. With no argument, specs the next unchecked item; given a number or name, specs that one. Sizes and splits large items (4a, 4b), generates TDD checklist steps, red-teams the draft, and stops at review gate. Use when running /feature, naming a feature, or drafting the next living spec."
+argument-hint: "[{number, name, DISC-id, or IDEA-id}]"
 ---
 
 # feature - turn a build-plan feature into a buildable spec
@@ -8,18 +9,22 @@ description: "[devflow][F] Turn a feature from build-plan.md into a buildable sp
 Where this sits in the workflow:
 
     project-overview.md  +  build-plan.md  ->  [this skill]  ->  build
-    (source of truth,        (which feature       (the spec for      (code,
-     from /overview)          to build)            one feature)        reviewed)
+    (source of truth,        (which feature       (the spec in       (code,
+     from /overview)          to build)            contexts/xxx/)      reviewed)
 
 `build-plan.md` is intentionally high-level - one line per feature, no detail,
 no ordering ceremony. All of that is this skill's job: take one listed feature,
 read the full context from `project-overview.md`, and turn it into something
-buildable.
+buildable in `devflow/context/{xxx-slug}/spec.md`.
+
+## Multi-Run Spec-Ahead Support
+
+`/feature` supports drafting multiple specs ahead of time. Creating a spec creates a dedicated workspace directory at `devflow/context/{xxx-slug}/` and does **not block** drafting subsequent features.
 
 ## Input
 
 A feature from `build-plan.md`, by number or name - e.g. `/feature 3` or
-`/feature "typing engine"`.
+`/feature "typing engine"` or `/feature DISC-20260826-001`.
 
 The request may also describe a genuinely new feature that is not in the build
 plan yet. That goes through the new-feature intake in Step 1. Never silently add

package/template/.agents/skills/fix/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: fix
-description: "[devflow][F] Document an ad-hoc bug fix or small change (one not in the build plan) into devflow/context/current-feature.md so it runs through the same build loop. Writes a short fix spec and stops; then /implement builds it and /complete logs it to devflow/history/fixes/ and merges. Use when the user runs /fix, reports a bug, or asks to fix or change something that isn't a planned build-plan feature."
+description: "[devflow] Document an ad-hoc bug fix or small change (one not in the build plan) into devflow/context/{xxx-slug}/spec.md so it runs through the same build loop. Supports Multi-Run: drafts dedicated fix context and allows selective /implement [id]. Writes a short fix spec and stops; then /implement builds it and /complete logs it to devflow/history/fixes/ and merges. Use when running /fix, reporting a bug, or fixing an ad-hoc issue."
+argument-hint: "[{title or issue-description}]"
 ---
 
 # fix - document an ad-hoc fix, then build it like anything else
@@ -13,7 +14,7 @@ Where this sits in the workflow:
 
 A fix is a bug or small change that isn't a planned build-plan feature. It runs
 through the same loop as a feature (build with review gates, iterate, then merge);
-it just starts here instead of `/feature`, and is logged separately.
+it creates a dedicated run folder at `devflow/context/{xxx-slug}/` (e.g. `059-fix-login-error`).
 
 ## Input
 
@@ -21,16 +22,13 @@ A description of the bug or change, for example `/fix "password reset email neve
 sends"`. If the user just reported the problem in chat, use that.
 
 The input may also be a finding ID from `devflow/context/findings.md`, alone
-or with a description, for example `/fix F-03`. Pull the problem statement from
-that ledger entry. Use this form only between work items, when
-`current-feature.md` is the reset stub: this skill overwrites that file, so
-while a spec is active, repair its findings through `/implement` instead.
+or with a description, for example `/fix F-03`.
 
 ## Step 1 - write the fix spec
 
 Pull context from `devflow/context/project-overview.md` and `devflow/context/coding-standards.md`,
-then write a short spec to `devflow/context/current-feature.md` (this file holds whatever
-is being built now, feature or fix). Keep it lighter than a feature spec:
+calculate the next sequential running ID (e.g. `059-fix-slug`),
+then write a short spec to `devflow/context/{xxx-slug}/spec.md` (and update `devflow/context/current-feature.md`). Keep it lighter than a feature spec:
 
 - **Title** - the bug or change in a few words.
 - **Type:** Fix  (so `/complete` logs it to `devflow/history/fixes/`, not `devflow/history/features/`).