@jakkrichm/create-nexus-devflow 2.0.13 → 2.0.15

package/template/.claude/skills/overview/SKILL.md

@@ -0,0 +1,114 @@
+---
+name: overview
+description: "[Devflow] Scan codebase architecture, data models, and shipped history to synthesize or refresh devflow/context/project-overview.md as the living source of truth."
+---
+
+# overview - Living Context Synthesis & Sync
+
+Where this sits in the workflow:
+
+```text
+codebase + devflow/history/HISTORY.md  ->  [overview]  ->  devflow/context/project-overview.md  ->  00-discover / 10-define / 20-spec
+(reality & shipped runs)                    (sync &         (living source of truth)             (informed planning)
+                                             synthesize)
+```
+
+`overview` is the context synchronization and synthesis engine for Nexus-DevFlow. It inspects the actual codebase (manifest, dependencies, directory layout, models/schemas, entry points) along with the completed delivery history (`devflow/history/HISTORY.md` and `devflow/runs/`) to build or refresh `devflow/context/project-overview.md`.
+
+It ensures that `project-overview.md` remains a **Living Source of Truth** that evolves alongside your software, rather than a stale artifact left behind after onboarding.
+
+## Usage
+
+```text
+/overview
+$overview
+overview
+```
+
+Use this when:
+- Multiple delivery runs (`RUN-xxx`) have shipped and `project-overview.md` needs to reflect newly added capabilities.
+- New database schemas, ORM models, or API boundaries were introduced.
+- Major dependencies or architectural patterns were added or modified.
+- After completing `70-release` to keep project context perfectly aligned.
+- Preparing for a new initiative or discovery pass.
+
+---
+
+## Process
+
+### Step 1 - Scan Reality (Codebase Survey)
+
+Inspect the actual codebase to establish hard facts:
+
+1. **Manifest & Tooling**:
+   - Read `package.json`, `pyproject.toml`, `go.mod`, `Cargo.toml`, `pom.xml`, or `Gemfile`.
+   - Identify language versions, primary framework, state management, and build tools.
+2. **Directory Architecture**:
+   - Map high-level directory layout (`src/`, `app/`, `api/`, `lib/`, `components/`, etc.).
+   - Identify major modules, entry points, and routing conventions.
+3. **Concrete Data Models & Schemas**:
+   - Search for ORM schemas (`schema.prisma`, Drizzle schemas, TypeORM entities, SQLAlchemy models, Zod schemas, or core TypeScript types).
+   - Extract entity names, core fields, relationships, and invariants.
+4. **Verified Commands**:
+   - Inspect package scripts (`dev`, `build`, `test`, `lint`, `check`, `verify`).
+
+---
+
+### Step 2 - Scan History (Delivered Capabilities)
+
+Inspect DevFlow history records:
+
+1. Read `devflow/history/HISTORY.md` for completed and released milestones.
+2. Scan completed delivery runs in `devflow/runs/` to extract shipped user-visible capabilities and core system features.
+
+---
+
+### Step 3 - Synthesize `project-overview.md`
+
+Write or update `devflow/context/project-overview.md` following standard structure:
+
+```markdown
+# Project Overview & Source of Truth
+
+> Living context artifact automatically synchronized with codebase reality and DevFlow delivery history.
+
+## 1. Project Purpose & Target Users
+- High-level summary of what the system does, who it serves, and the core problem it solves.
+
+## 2. Architecture & Directory Layout
+- Visual directory layout tree with short descriptions for major modules and boundaries.
+
+## 3. Technology Stack & Key Tooling
+- Frontend, Backend, Database, ORM, Testing frameworks, CI/CD, and Package Manager.
+
+## 4. Concrete Data Models & Entities
+- Field-level definitions of major entities, types, and relationships.
+
+## 5. Shipped Capabilities & Key Modules
+- Consolidated list of active features and subsystems verified in the codebase.
+
+## 6. Verified Commands & Developer Workflow
+- Exact commands for Dev, Build, Test, Lint, and Verify.
+
+## 7. Known Architectural Focus Areas
+- Known technical debt, active migrations, or upcoming architectural focus points.
+```
+
+---
+
+### Step 4 - Review & Report
+
+Present a concise summary of the sync:
+- Models or entities detected and added
+- Shipped capabilities refreshed from history
+- Stack and tooling updates
+- Any inconsistencies or gaps found between code and documentation
+
+---
+
+## Rules & Guardrails
+
+1. **Grounded in Reality**: Never invent non-existent packages, fictional data models, or unverified endpoints. Everything in `project-overview.md` must be traceable to real code or recorded history.
+2. **Preserve User Intent**: Do not erase custom business rules or user-written notes. Integrate new facts smoothly around existing intent.
+3. **Concrete Over Vague**: Provide actual model names, field types, and route paths rather than vague one-line summaries.
+4. **Non-Destructive**: `overview` only writes to `devflow/context/project-overview.md`. It never modifies source code, runs migrations, or touches git history.

package/template/.claude/skills/pr/SKILL.md

@@ -40,7 +40,7 @@ You are an orchestrator. Your goal is to call the specialized Git PR Maker agent
 - Prefer markdown-first stage artifacts as the source narrative:
   - `20-spec.md`
   - `30-plan.md`
-  - `40-implement.md`
+  - `40-execute.md`
   - `50-verify.md`
   - `60-report.md` when the final summary already exists
   - `70-release.md` when release execution notes already exist

package/template/.claude/skills/preview/SKILL.md

@@ -38,5 +38,5 @@ This is the preview master skill for Nexus-DevFlow. It manages local development
 ## Relationship To DevFlow 2.0
 
 - **Classification**: Companion command & Runtime support
-- **Mainline stages**: `40-implement` (interactive visual check), `50-verify` (smoke test check)
+- **Mainline stages**: `40-execute` (interactive visual check), `50-verify` (smoke test check)
 - **Handoff**: `50-verify`

package/template/.claude/skills/report-html/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: report-html
+description: "[Devflow] Standalone HTML Report Generator - render an interactive standalone HTML dashboard from spec.md or 60-report.md on demand."
+argument-hint: "{running-id or workspace path}"
+---
+
+# Standalone: Report HTML
+
+$ARGUMENTS
+
+Standalone companion command to generate an interactive, self-contained HTML report dashboard on demand from either a Fast-Track `spec.md` or a Deep-Track `60-report.md`.
+
+> [!NOTE]
+> HTML reports are **never automatically generated** during normal mainline stages (`/complete` or `60-report`). Use this command whenever you or stakeholders wish to view or share an interactive web report.
+
+## Invocations & Aliases
+
+- `/report:html`: Generate HTML report for the active or most recent run
+- `/report:html {running-id}`: Generate HTML report for the specified running ID
+- `npm run report:html -- {running-id}`: CLI npm script invocation
+- `$report:html`: Codex CLI invocation
+
+## Behavior & Contract
+
+When invoked:
+
+### 1. Identify Target Run
+1. Locate target run directory in `devflow/runs/{running-id}` from argument or `devflow/context/current-stage.md`.
+2. Check for either:
+   - Fast-Track Living Spec: `devflow/runs/{RUNNING_ID}/spec.md` (or `blueprint.md`)
+   - Deep-Track Report Digest: `devflow/runs/{RUNNING_ID}/60-report.md`
+
+### 2. Render Interactive HTML Dashboard
+Execute the HTML generation engine:
+```bash
+npm run report:html -- {RUNNING_ID}
+```
+Or execute the renderer to transform Markdown into a styled, standalone HTML document:
+- Path: `devflow/runs/{RUNNING_ID}/report.html`
+
+### 3. Output
+Provide:
+- Generated HTML file path: `file:///devflow/runs/{RUNNING_ID}/report.html`
+- Summary of sections rendered (Spec, Plan, Progress, QA Evidence, Release Notes)
+- Instructions to open the file in any browser

package/template/.claude/skills/review/SKILL.md

@@ -68,4 +68,4 @@ Categorize all findings into actionable severities:
 
 - **Classification**: Companion command & Verification support
 - **Mainline stages**: `50-verify` (QA & Code Review lane), `70-release` (Pre-merge review)
-- **Handoff**: `40-implement` (for fixes), `50-verify`, `70-release`
+- **Handoff**: `40-execute` (for fixes), `50-verify`, `70-release`

package/template/.claude/skills/rollback/SKILL.md

@@ -8,7 +8,7 @@ description: "[Devflow] Plan safe feature or run reversal with dependency and co
 Where this sits in the workflow:
 
 ```text
-completed run + git history  ->  [rollback]  ->  40-implement (or fix run)  ->  50-verify  ->  70-release
+completed run + git history  ->  [rollback]  ->  40-execute (or fix run)  ->  50-verify  ->  70-release
 (run archive + commits)          (risk review    (reverse product diff)          (prove)      (log & finalize)
                                   + plan)
 ```
@@ -51,7 +51,7 @@ Identify:
 
 - Exact commit SHA(s) introducing the feature.
 - Parent commit before the feature was introduced.
-- Associated stage artifacts (`20-spec.md`, `40-implement.md`, `70-release.md`).
+- Associated stage artifacts (`20-spec.md`, `40-execute.md`, `70-release.md`).
 
 ## Step 2 - Separate Product Changes From DevFlow History
 
@@ -98,7 +98,7 @@ Draft the rollback plan containing:
 Present the rollback plan to the user:
 
 - Summarize affected files and dependency risks.
-- If approved, route to `40-implement` (or allocate a dedicated Fixrollback Run) to safely execute the reversal steps behind review gates.
+- If approved, route to `40-execute` (or allocate a dedicated Fixrollback Run) to safely execute the reversal steps behind review gates.
 
 ## Rules
 

package/template/.claude/skills/security-review/SKILL.md

@@ -59,5 +59,5 @@ This is the comprehensive security master skill for Nexus-DevFlow. It combines s
 ## Relationship To DevFlow 2.0
 
 - **Classification**: Companion command & Safety gate
-- **Mainline integration**: Run during `40-implement` or `50-verify` before `70-release`.
-- **Handoff**: P0/P1 security findings block release and return to `40-implement` for immediate remediation.
+- **Mainline integration**: Run during `40-execute` or `50-verify` before `70-release`.
+- **Handoff**: P0/P1 security findings block release and return to `40-execute` for immediate remediation.

package/template/.claude/skills/simplify/SKILL.md

@@ -66,5 +66,5 @@ Delete commented-out code blocks, `// removed` notes, and unused variables (`_un
 ## Relationship To DevFlow 2.0
 
 - **Classification**: Companion command & Refactoring support
-- **Mainline integration**: Used during `40-implement` (Refactor step of TDD) or `50-verify`.
+- **Mainline integration**: Used during `40-execute` (Refactor step of TDD) or `50-verify`.
 - **Handoff**: `50-verify` (proves zero regressions).

package/template/.claude/skills/spec/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: spec
+description: "[Devflow] Fast-Track Spec router in DevFlow (Blueprint Mode) - aliases and routes to /feature or /fix to create the single living spec.md contract."
+argument-hint: "{feature title, bug description, IDEA-xxx, or running-id}"
+---
+
+# Fast-Track: Spec Router (Blueprint Mode)
+
+$ARGUMENTS
+
+Unified Fast-Track entry point that routes to `/feature` or `/fix` to create and maintain the **Single Living Spec (`spec.md`)**.
+
+> [!TIP]
+> **Preferred Commands**:
+> - ใช้ **`/feature <title>`** สำหรับฟีเจอร์ใหม่หรืองานพัฒนาทั่วไป
+> - ใช้ **`/fix <bug-description>`** สำหรับแก้บั๊กหรือ hotfix
+
+## Invocations & Aliases
+
+- `/feature <title>`: Fast-Track feature workflow (แนะนำ)
+- `/fix <bug-description>`: Fast-Track ad-hoc bugfix workflow (แนะนำ)
+- `/spec <title>` or `/spec IDEA-xxx`: Generic Fast-Track specification
+- `$feature`, `$fix`, `$spec`: Codex CLI invocation
+
+## Fast-Track Mainline Workflow
+
+```text
+/feature (หรือ /fix) ──▶ /implement ──▶ /check ──▶ /complete
+```
+
+## Behavior & Contract
+
+When invoked:
+
+1. If the input describes a bug or hotfix, routes to `/fix` behavior.
+2. Otherwise, routes to `/feature` behavior.
+3. Allocates sequential Running ID (`RUN-xxx`), creates directory `devflow/runs/{RUNNING_ID}/`, and generates `spec.md` in **Thai (`th`)**.
+4. Updates `devflow/context/current-stage.md` and reports next step: `/implement`.

package/template/.claude/skills/test/SKILL.md

@@ -81,7 +81,7 @@ For browser and UI features, unit tests alone are insufficient:
 
 ## 6. Test Generation & Persistent Execution Reports
 
-When generating or logging test runs during `40-implement` or `50-verify`:
+When generating or logging test runs during `40-execute` or `50-verify`:
 - Save summary reports to `devflow/reports/{date}-test-report-{slug}.md`
 - Include: Target, Test Cases (Happy Path, Error, Edge Cases), Pass/Fail statistics, and gaps/risks.
 
@@ -90,5 +90,5 @@ When generating or logging test runs during `40-implement` or `50-verify`:
 ## Relationship To DevFlow 2.0
 
 - **Classification**: Companion command & Engineering standard
-- **Mainline stages**: `30-plan` (TDD decisions), `40-implement` (TDD execution), `50-verify` (QA gate)
+- **Mainline stages**: `30-plan` (TDD decisions), `40-execute` (TDD execution), `50-verify` (QA gate)
 - **Handoff**: `50-verify`, `Debug`, `autopilot`

package/template/.claude/skills/try/SKILL.md

@@ -8,7 +8,7 @@ description: "[Devflow] Generate human manual QA review walkthrough guide (where
 Where this sits in the workflow:
 
 ```text
-40-implement or 50-verify or 60-report  ->  [try]  ->  human review & verification
+40-execute or 50-verify or 60-report  ->  [try]  ->  human review & verification
 (work implemented / verified)                  (manual    (where to go,
                                                steps)     what to click)
 ```
@@ -36,7 +36,7 @@ Read:
 - `devflow/context/current-stage.md`
 - `devflow/context/project-overview.md`
 - `devflow/context/coding-standards.md`
-- Active run artifacts: `20-spec.md`, `30-plan.md`, `40-implement.md`, `50-verify.md` (or archived run artifacts)
+- Active run artifacts: `20-spec.md`, `30-plan.md`, `40-execute.md`, `50-verify.md` (or archived run artifacts)
 - Current git branch and status
 
 Do not dump the full spec. Extract only the concrete routes, screens, CLI commands, API endpoints, test data, and expected outcomes that a human needs to verify the feature.

package/template/AGENTS.md

@@ -1,10 +1,14 @@
-# Nexus-DevFlow 2.0 (Blueprint-Style Model)
+# Nexus-DevFlow 2.0 (Dual-Track Blueprint & Architect Model)
 
 Instructions for AI coding agents working in this project. This is the cross-tool entry point: Codex, Google Antigravity, Cursor, GitHub Copilot, Gemini CLI, Aider, Zed, Windsurf, and others read `AGENTS.md`. Claude Code reads `CLAUDE.md`, which imports this file (`@AGENTS.md`), so there is a single source of truth.
 
 ## What this is
 
-This project uses **Nexus-DevFlow**, an agentic stage-based workflow layer. To start a new project, scaffold the application first in an empty folder, then run `npx @jakkrichm/create-nexus-devflow` to overlay DevFlow onto your codebase.
+This project uses **Nexus-DevFlow**, an agentic workflow layer supporting **Dual-Track Delivery**:
+1. **🏎️ Fast-Track (Blueprint Mode - 4 Steps)**: High-velocity spec-driven loop driven by a **Single Living Spec (`spec.md`)**.
+2. **🏗️ Deep-Track (Architect Mode - 8 Steps)**: Full-lifecycle delivery pipeline with modular stage artifacts (`00-70`).
+
+To start a new project, scaffold the application first in an empty folder, then run `npx @jakkrichm/create-nexus-devflow` to overlay DevFlow onto your codebase.
 
 ## Read these for full context
 
@@ -25,66 +29,70 @@ Unused adapter families can be removed. Codex and Antigravity projects keep `.ag
 
 ### Universal Invocation & Agent Directives:
 
-1. **Canonical Command Names & AI Provider Invocation**: Each workflow stage and companion tool has exactly **one Canonical Name** (e.g. `00-discover`, `10-define`, `20-spec`, `30-plan`, `40-implement`, `50-verify`, `60-report`, `70-release`, `devflow`, `onboard`, `adopt`, `doctor`, `try`, `rollback`, `ci`, `brief`, `autopilot`). The way you invoke commands depends on your AI Provider / Tool:
-   - **Canonical Name (Plain text)**: Directly invoke or prompt the command by its standard name (e.g., `00-discover`, `devflow`).
-   - **Slash Prefix (`/`)**: For tools supporting slash commands (Claude Code, Google Antigravity, Gemini CLI), e.g., `/00-discover`, `/devflow`.
-   - **Dollar Prefix (`$`)**: For OpenAI Codex CLI or skill-invocation tools, e.g., `$00-discover`, `$devflow`.
+1. **Canonical Command Names & AI Provider Invocation**: Each workflow stage and companion tool has exactly **one Canonical Name** (e.g. `feature`, `fix`, `implement`, `check`, `complete`, `00-discover`, `10-define`, `20-spec`, `30-plan`, `40-execute`, `50-verify`, `60-report`, `70-release`, `report-html`, `devflow`, `onboard`, `adopt`, `doctor`, `try`, `rollback`, `ci`, `brief`, `autopilot`, `idea`, `spec`). The way you invoke commands depends on your AI Provider / Tool:
+   - **Canonical Name (Plain text)**: Directly invoke or prompt the command by its standard name (e.g., `feature`, `40-execute`, `devflow`).
+   - **Slash Prefix (`/`)**: For tools supporting slash commands (Claude Code, Google Antigravity, Gemini CLI), e.g., `/feature`, `/fix`, `/implement`, `/40-execute`, `/devflow`.
+   - **Dollar Prefix (`$`)**: For OpenAI Codex CLI or skill-invocation tools, e.g., `$feature`, `$fix`, `$40-execute`, `$devflow`.
 2. **OpenAI Codex & Non-Native CLI Tools**: In environments without automatic background skill discovery (such as OpenAI Codex CLI, Aider, or generic terminals), **you MUST use your file reading tool to inspect `.agents/skills/<skill>/SKILL.md` before executing the stage** to strictly follow its schema, artifact contract, and quality gates.
 3. **Google Antigravity & Claude Code**: Native skill engines automatically discover and surface `.agents/skills/` and `.claude/skills/`.
 4. **State-Aware Inspection**: When unsure what to do next, invoke `devflow` to automatically inspect `devflow/context/current-stage.md` and active runs in `devflow/runs/`.
-5. **Default Artifact & Communication Language (Thai)**: All generated markdown stage artifacts (`00-discover.md`, `10-define.md`, `20-spec.md`, `30-plan.md`, `40-implement.md`, `50-verify.md`, `60-report.md`, `70-release.md`) and user communication MUST default to **Thai (`th`)**, while code, technical terms, file paths, and identifiers remain in English.
+5. **Default Artifact & Communication Language (Thai)**: All generated markdown stage artifacts (`spec.md`, `00-discover.md`...`70-release.md`) and user communication MUST default to **Thai (`th`)**, while code, technical terms, file paths, and identifiers remain in English.
+
+---
+
+## 🏎️ Track 1: Fast-Track (Blueprint Mode - 4 Steps)
 
-## Timeline Workflow
+Recommended for 85% of daily work (features, bug fixes, UI improvements, iterative tasks):
 
 ```text
-00-discover -> 10-define -> 20-spec -> 30-plan -> 40-implement -> 50-verify -> 60-report -> 70-release
+/feature (หรือ /fix) ──▶ /implement ──▶ /check ──▶ /complete
 ```
 
-### Mainline Stages:
+1. **`feature` / `fix` (`/feature`, `/fix`, `/spec`)**:
+   - **Purpose**: Combines Discover, Define, Spec, and Plan into one unified step. Allocates sequential Running ID (`RUN-xxx`) and creates the **Single Living Spec (`spec.md`)**.
+   - **Artifact**: `devflow/runs/{running-id}-{slug}/spec.md`
+2. **`implement` (`/implement`)**:
+   - **Purpose**: Incrementally executes checklist tasks with TDD discipline and appends progress to `spec.md`.
+3. **`check` (`/check`)**:
+   - **Purpose**: Senior QA review, multi-lane verification matrix (Typecheck, Lint, Test suites, manual proof), and records evidence into `spec.md`.
+4. **`complete` (`/complete`)**:
+   - **Purpose**: Final safety pass, records Release Digest in `spec.md`, performs git merge, and closes the run without auto HTML generation.
 
-1. `00-discover`
-   - **Purpose**: Explore a request before delivery commitment without allocating a running ID.
-   - **Artifact**: `devflow/discoveries/{discovery-id}-{slug}/00-discover.md`
-   - **Gate**: Produces `Proceed`, `Defer`, or `Reject` decision.
+---
 
-2. `10-define`
-   - **Purpose**: Turn an approved discovery into one or more bounded delivery runs with stable scope and sequential Running IDs.
-   - **Artifact**: `devflow/runs/{running-id}-{slug}/10-define.md`
-   - **Gate**: Approved run map and explicit in-scope / out-of-scope boundaries.
+## 🏗️ Track 2: Deep-Track (Architect Mode - 8 Steps)
 
-3. `20-spec`
-   - **Purpose**: Formalize markdown-first delivery contract and testable acceptance criteria from a stable definition.
-   - **Artifact**: `devflow/runs/{running-id}-{slug}/20-spec.md`
-   - **Gate**: Unambiguous acceptance criteria and hard constraints.
+Recommended for large architectural epics, database migrations, and multi-agent coordination:
+
+```text
+00-discover ──▶ 10-define ──▶ 20-spec ──▶ 30-plan ──▶ 40-execute ──▶ 50-verify ──▶ 60-report ──▶ 70-release
+```
 
-4. `30-plan`
-   - **Purpose**: Transform `20-spec.md` into phased executable tasks with explicit test decisions (Required / Manual / Not Required).
-   - **Artifacts**: `30-plan.md`, `checklists/implementation-checklist.md`, `checklists/verification-checklist.md`
-   - **Gate**: Ordered dependencies, scoped subtasks, and TDD decisions.
+1. `00-discover`: Explore request before delivery commitment without allocating running ID (`00-discover.md`).
+2. `10-define`: Turn approved discovery into bounded delivery run(s) with sequential Running IDs (`10-define.md`).
+3. `20-spec`: Formalize markdown-first delivery contract & acceptance criteria (`20-spec.md`).
+4. `30-plan`: Breakdown spec into executable tasks with test decisions (`30-plan.md` + checklists).
+5. `40-execute`: Incremental task execution behind review gates (`40-execute.md`).
+6. `50-verify`: Senior QA review & multi-lane verification checks (`50-verify.md`).
+7. `60-report`: Standardized markdown delivery digest (`60-report.md`).
+8. `70-release`: Release packaging, release notes, git merge, and deployment (`70-release.md`).
 
-5. `40-implement`
-   - **Purpose**: Execute planned tasks incrementally one scoped unit at a time behind review gates.
-   - **Artifact**: `40-implement.md` (and updated checklists)
-   - **Gate**: Code changes tested, verification recorded, deviations documented.
+---
 
-6. `50-verify`
-   - **Purpose**: Senior QA review and multi-lane validation check across functionality, regressions, and quality standards.
-   - **Artifact**: `50-verify.md` (optional `50-verify-impact.md`)
-   - **Gate**: Pass or return-to-implement decision with evidence.
+## 🌐 Standalone HTML Reporting Policy
 
-7. `60-report`
-   - **Purpose**: Produce the standardized final markdown and self-contained HTML summary report for the completed run.
-   - **Artifacts**: `60-report.md`, `60-report.html`
-   - **Gate**: Completed delivery digest ready for stakeholder review.
+> [!IMPORTANT]
+> **No Auto-Generated HTML**: Mainline flows (`/complete` and `60-report`) strictly output Markdown only.
+> When an interactive web dashboard is desired for presentation or sharing, invoke the standalone companion command:
+> `/report:html` (or `npm run report:html -- {RUNNING_ID}`).
 
-8. `70-release`
-   - **Purpose**: Package verified work for delivery, git merge, pull request, changelog update, or deployment.
-   - **Artifact**: `70-release.md`
-   - **Gate**: Safe handoff, release notes, and deployment readiness.
+---
 
-### Public Companion Commands:
+## Public Companion Commands
 
 - `devflow`: Flagship interactive guide, state inspector, and intent router.
+- `idea` (`/idea`): Quick idea capture and AI feasibility enrichment into `devflow/ideas.md`.
+- `report-html` (`/report:html`): Standalone interactive HTML report dashboard generator.
 - `onboard`: Initial stack detection and baseline setup for fresh/scaffolded projects.
 - `adopt`: Survey existing brownfield codebases and bootstrap DevFlow context.
 - `doctor`: Read-only health check for context files, adapters, commands, and workflow drift.
@@ -92,49 +100,39 @@ Unused adapter families can be removed. Codex and Antigravity projects keep `.ag
 - `rollback`: Safe feature/run reversal planner with dependency and commit risk analysis.
 - `ci`: Automatic GitHub Actions workflow (`.github/workflows/verify.yml`) setup and alignment.
 - `brief`: Read-only scope, dependency, and size pre-briefing before speccing a run.
-- `autopilot`: Optional explicit mode for one bounded spec/plan/implement/verify/report pass with checkpoint commits and review packet.
+- `autopilot`: Optional explicit mode for one bounded spec/plan/implement/verify/report pass.
 - `goal`: Route broad, open-ended goals before Discovery.
 - `brainstorm`: Structured divergent & convergent ideation without creating running IDs.
 - `research`: Conduct deep codebase or web research with source-backed citations.
 - `debug`: Root cause investigation before or during implementation without editing code.
-- `prd`: Product Requirements Document drafting before delivery commitment.
-- `issue-triage`: Intake, categorize, and prioritize incoming issues and bug reports.
-- `security-review`: High-severity vulnerability and security review.
-- `wiki`: Knowledge base management and ingestion under `devflow/wiki/`.
+- `overview`: Refresh `devflow/context/project-overview.md`.
+- `wiki`: Knowledge base management under `devflow/wiki/`.
 - `check-for-updates`: Verify or upgrade DevFlow setup.
 - `help`: Routing and process assistance across DevFlow workflows.
 
-## Invocation Reference
+---
 
-> **Note on AI Providers**: Commands use a single Canonical Name. Use the prefix appropriate for your tool (`/` for Claude/Antigravity, `$` for Codex, or plain text).
+## Invocation Reference
 
-| Stage / Category | Canonical Name | Claude / Antigravity (`/`) | OpenAI Codex (`$`) | Purpose / Action |
+| Track / Category | Canonical Name | Claude / Antigravity (`/`) | OpenAI Codex (`$`) | Purpose / Action |
 | :--- | :--- | :--- | :--- | :--- |
-| **Setup (Fresh)** | `onboard` | `/onboard` | `$onboard` | Detect tech stack and establish initial project baseline |
-| **Adopt (Exist)** | `adopt` | `/adopt` | `$adopt` | Adopt existing brownfield codebase into DevFlow |
-| **Diagnostics** | `doctor` | `/doctor` | `$doctor` | Read-only health check for configs, tools, and drift |
-| **Manual QA** | `try` | `/try` | `$try` | Step-by-step manual testing guide for human verification |
-| **Reversal** | `rollback` | `/rollback` | `$rollback` | Reversal planner with dependency & commit risk analysis |
-| **CI Setup** | `ci` | `/ci` | `$ci` | Generate GitHub Actions automated verify workflow |
-| **Pre-Check** | `brief` | `/brief` | `$brief` | Read-only scope, dependency, and size pre-briefing |
-| **Autopilot** | `autopilot` | `/autopilot` | `$autopilot` | Bounded autonomous spec/plan/implement/verify pass |
-| **Stage 00** | `00-discover` | `/00-discover` | `$00-discover` | Explore request and decide Proceed, Defer, or Reject |
-| **Stage 10** | `10-define` | `/10-define` | `$10-define` | Turn approved discovery into bounded delivery run(s) |
-| **Stage 20** | `20-spec` | `/20-spec` | `$20-spec` | Formal markdown delivery contract & acceptance criteria |
-| **Stage 30** | `30-plan` | `/30-plan` | `$30-plan` | Breakdown spec into executable tasks with test decisions |
-| **Stage 40** | `40-implement` | `/40-implement` | `$40-implement` | Implement tasks in small reviewable increments |
-| **Stage 50** | `50-verify` | `/50-verify` | `$50-verify` | Senior QA review & multi-lane verification checks |
-| **Stage 60** | `60-report` | `/60-report` | `$60-report` | Standalone markdown & HTML summary report |
-| **Stage 70** | `70-release` | `/70-release` | `$70-release` | Package for delivery, git merge, PR, or deployment |
+| **Fast: Feature** | `feature` | `/feature` | `$feature` | 4-step Fast-Track spec & living spec creation for new features (supports `IDEA-xxx`) |
+| **Fast: Fix** | `fix` | `/fix` | `$fix` | 4-step Fast-Track spec & living spec creation for bug fixes (supports `IDEA-xxx`) |
+| **Fast: Implement** | `implement` | `/implement` | `$implement` | Fast-Track incremental execution with TDD |
+| **Fast: Check** | `check` | `/check` | `$check` | Fast-Track QA review & multi-lane verification |
+| **Fast: Complete** | `complete` | `/complete` | `$complete` | Fast-Track safety pass, release digest & git merge |
+| **Idea Capture** | `idea` | `/idea` | `$idea` | Quick idea capture and AI feasibility enrichment |
+| **HTML Report** | `report-html` | `/report:html` | `$report:html` | Standalone interactive HTML dashboard generator |
+| **Deep: 00** | `00-discover` | `/00-discover` | `$00-discover` | Explore request and decide Proceed, Defer, or Reject |
+| **Deep: 10** | `10-define` | `/10-define` | `$10-define` | Turn approved discovery into bounded delivery run(s) |
+| **Deep: 20** | `20-spec` | `/20-spec` | `$20-spec` | Formal markdown delivery contract & acceptance criteria |
+| **Deep: 30** | `30-plan` | `/30-plan` | `$30-plan` | Breakdown spec into executable tasks with test decisions |
+| **Deep: 40** | `40-execute` | `/40-execute` | `$40-execute` | Execute planned tasks in small reviewable increments (`40-execute.md`) |
+| **Deep: 50** | `50-verify` | `/50-verify` | `$50-verify` | Senior QA review & multi-lane verification checks |
+| **Deep: 60** | `60-report` | `/60-report` | `$60-report` | Standalone markdown summary report |
+| **Deep: 70** | `70-release` | `/70-release` | `$70-release` | Package for delivery, git merge, PR, or deployment |
 | **Router** | `devflow` | `/devflow` | `$devflow` | Interactive guide, state inspector, and intent router |
 
-## Mainline Rules
-
-1. Numbered workflows exist only for the linear mainline.
-2. Mainline numbers must move from lower to higher with no backward jump.
-3. If a command is not a true mainline state, do not give it a number.
-4. Companion commands may be suggested by a mainline workflow but do not replace that workflow.
-
 ## Commands
 
 - Dev Server: `npm run dev`

package/template/devflow/context/ai-interaction.md

@@ -24,11 +24,12 @@
 ## DevFlow Timeline Lifecycle
 
 ```text
-/00-Discover -> /10-Define -> /20-Spec -> /30-Plan -> /40-Implement -> /50-Verify -> /60-Report -> /70-Release
+/00-Discover -> /10-Define -> /20-Spec -> /30-Plan -> /40-Execute -> /50-Verify -> /60-Report -> /70-Release
 ```
 
 - Run `/00-Discover` to explore requests under a Discovery ID.
 - Run `/10-Define` to set delivery boundaries and allocate Running IDs.
 - Run `/20-Spec` and `/30-Plan` to establish formal delivery specifications and execution plans.
-- Run `/40-Implement` for step-by-step code implementation with evidence.
+- Run `/40-Execute` for step-by-step code implementation with evidence.
 - Run `/50-Verify`, `/60-Report`, and `/70-Release` for quality verification, reporting, and release packaging.
+- Use **Fast-Track / Quick-Fix mode** for minor hotfixes to skip heavy ceremony while keeping test evidence.

package/template/devflow/context/coding-standards.md

@@ -1,27 +1,40 @@
-# Coding Standards
+# Coding Standards & Guidelines
 
-> Project conventions and rules to follow during development.
-> Run `/onboard` (or `/adopt` for existing codebases) to tune these standards to your specific stack.
+General engineering standards for code, tests, and documentation in Nexus-DevFlow.
 
-## Architecture and Conventions
+## 1. Code Quality & Architecture
 
-- Write clean, modular, and maintainable code with clear single responsibilities.
-- Prefer TypeScript and explicit interfaces where available.
-- Keep dependencies lean and justified.
+- Write clear, self-documenting code with single-responsibility functions.
+- Avoid unnecessary complexity (prefer simple solutions over indirect abstractions).
+- Maintain type safety and static validation across module boundaries.
+- Treat `project-overview.md` as the single source of truth for concrete data models and entity definitions.
 
-## Code Organization & Style
+## 2. Testing & Empirical Proof Standards
 
-- Structure source code following framework-native conventions.
-- Keep functions focused and avoid deeply nested logic.
-- Use consistent naming conventions (camelCase for functions/variables, PascalCase for components/types).
+- **Unit Test Mandate**: Any logic modification or bug fix must be accompanied by new or updated unit tests.
+- **Empirical Proof Contract**: Never claim "passed", "verified", or "working" without citing exact command outputs, test run reports, route responses, logs, or screenshots.
+- **Manual Try Guide**: Every delivery run must provide a human-testable Try Guide ("Where to go", "What to click", "What to expect") for manual validation.
 
-## Error Handling & Security
+## 3. Findings Ledger & Quality Gates (`findings.md`)
 
-- Handle errors explicitly and provide meaningful error messages.
-- Never hardcode credentials, secrets, or API keys in source code.
-- Sanitize and validate all user inputs.
+- All audit, security, and verification issues must be tracked in `devflow/context/findings.md`.
+- **Finding State Machine**:
+  - `open`: Confirmed defect not yet repaired.
+  - `fixed`: Repaired in code, pending verification.
+  - `closed`: Verified in `50-verify` as completely resolved without regressions.
+  - `accepted`: Waived with recorded user rationale.
+  - `invalid`: Proven non-issue with concrete evidence.
+- **P0/P1 Blockers**: P0 and P1 findings in `open` or `fixed` status block `70-release` unconditionally. `fixed` status must be promoted to `closed` via `50-verify` re-examination.
 
-## Testing & Quality
+## 4. Git Workflow & Release Safety
+ 
+- Commit messages follow conventional/imperative format (e.g., `feat(RUN-007): ...`).
+- Feature branches follow `feature/{slug}-{running-id}` or `fix/{slug}-{running-id}`.
+- **2-Stage Release Approvals**: Explicit consent to merge into `main` is strictly separate from consent to `git push` to remote repositories or deploy to production.
 
-- Follow the TDD workflow for behavior-changing code units.
-- Run tests and linting before completing features or fixes.
+## 5. Fast-Track & Quick-Fix Guidelines (Lean Mode)
+
+- For trivial bug fixes, typo corrections, or single-file non-architectural changes, developers and agents may use the **Quick-Fix Fast-Track**:
+  - Consolidate Discovery, Define, and Spec into an inline fix brief (`devflow/runs/{fix-id}/fix-brief.md`).
+  - Jump directly to `40-execute` (with reproduction unit test) ➔ `50-verify` ➔ `70-release`.
+  - Avoid creating heavy redundant documentation for changes under 20 lines of code while preserving Empirical Proof and Unit Test requirements.

package/template/devflow/context/current-stage.md

@@ -2,6 +2,7 @@
 
 - **Active Discovery ID**: None
 - **Active Running ID**: None
-- **Current Stage**: Idle
-- **Last Completed Run**: None
-- **Last Updated**: -
+- **Current Stage**: Idle (Ready for next run)
+- **Living Spec**: None
+- **Last Completed Run**: RUN-018-update-documentation-and-guides (2026-08-20)
+- **Last Updated**: 2026-08-20

package/template/devflow/context/findings.md

@@ -1,9 +1,13 @@
-# Findings Ledger
+# Audit Findings Ledger
 
-> Review findings raised by `/security-review` or QA audits.
-> Resolved findings are tracked with durable IDs.
+Summary of audit findings, quality checks, security bugs, and debt tracked across DevFlow runs.
 
-- **Total Open P0/P1**: 0
-- **Total Tracked**: 0
+## Open Findings
 
-_No findings recorded._
+| ID | Severity | Category | Title | Discovered Run | Status |
+| :- | :--- | :--- | :--- | :--- | :--- |
+
+## Resolved Findings
+
+| ID | Severity | Category | Title | Resolved Run | Date |
+| :- | :--- | :--- | :--- | :--- | :--- |