@jakkrichm/create-nexus-devflow 2.0.15 → 2.0.18

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

@@ -1,8 +1,8 @@
 # Current DevFlow Run Status
 
-- **Active Discovery ID**: None
-- **Active Running ID**: None
-- **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
+- **Active Discovery ID**: `None`
+- **Active Running ID**: `None`
+- **Current Stage**: `Idle (Ready for new /feature, /fix, /00-discover, or /10-define)`
+- **Living Spec**: `None`
+- **Last Completed Run**: `None`
+- **Last Updated**: `None`

package/template/devflow/context/findings.md

@@ -1,13 +1,13 @@
-# Audit Findings Ledger
+# Findings Ledger
 
-Summary of audit findings, quality checks, security bugs, and debt tracked across DevFlow runs.
+> **Generated Ledger File.** Tracks quality findings, security vulnerabilities, regression risks, and architectural debt raised during review and QA passes.
+>
+> **Finding Format**:
+> `### <ID> [<SEVERITY>] <STATUS> - <Title>`
+> - **Severities**: `P0` (Critical Blocker), `P1` (High Blocker), `P2` (Medium), `P3` (Low / Polish)
+> - **Statuses**: `unverified`, `open`, `fixed`, `closed`, `accepted`, `invalid`
+> - **Release Gate Rule**: Any `P0` or `P1` finding in `open` or `fixed` status unconditionally blocks `/complete` and `70-release`.
 
-## Open Findings
+---
 
-| ID | Severity | Category | Title | Discovered Run | Status |
-| :- | :--- | :--- | :--- | :--- | :--- |
-
-## Resolved Findings
-
-| ID | Severity | Category | Title | Resolved Run | Date |
-| :- | :--- | :--- | :--- | :--- | :--- |
+_No active findings recorded. QA and audit passes append findings here as they are discovered._

package/template/devflow/context/project-overview.md

@@ -1,41 +1,27 @@
-# Project Overview
+# Project Overview & Source of Truth
 
-Primary source of truth for the project context, architecture, tech stack, and active DevFlow stage status.
+> Living context artifact automatically synchronized with codebase reality and DevFlow delivery history.
+> Run `/onboard` (for new projects) or `/adopt` (for existing codebases) to populate this file.
 
-## Application Summary
+---
 
-- **Project Name**: Nexus-DevFlow
-- **Goal**: Agent-ready DevFlow 2.0 workflow layer framework with .agents and .claude adapter tooling, living context synchronization, and automated AI Blueprint upstream monitoring.
-- **Target Audience**: AI coding assistants (Google Antigravity, OpenAI Codex, Claude Code, Cursor) and software development teams building resilient agentic delivery workflows.
+## 1. Project Purpose & Target Users
+- Describe what this application does, who it is for, and the problems it solves.
 
-## Tech Stack
+## 2. Architecture & Directory Layout
+- Visual directory layout and overview of core modules.
 
-- **Core & Runtime**: Node.js (>=18.17 / Node 22), TypeScript 5.7, Node Next ESM (`"type": "module"`)
-- **Execution & Tooling**: `tsx` (TypeScript execute/test runner), `tsc` (Typecheck & compilation)
-- **Installer Package**: `@jakkrichm/create-nexus-devflow` (with `dist/` compilation pipeline)
-- **Documentation**: VitePress / Astro website under `website/` (GitHub Pages)
-- **Upstream Integration**: Automated GitHub Actions monitor (`.github/workflows/check-upstream.yml`) tracking `aiblueprinthq/ai-blueprint`
-- **Verification Gate**: `npm run check` (TypeScript typechecking, static contract validation, TF-IDF skill routing evaluations, installer unit tests, packed smoke tests)
+## 3. Technology Stack & Key Tooling
+- Frameworks, languages, databases, ORMs, package managers, and runtime environment.
 
-## Architecture & Key Modules
+## 4. Concrete Data Models & Entities
+- Core entities, database schemas, API interfaces, and types.
 
-- **Dual-Track Delivery Engine**:
-  - **Fast-Track (Blueprint Mode — 4 Steps)**: High-velocity spec loop (`/feature` or `/fix` ➔ `/implement` ➔ `/check` ➔ `/complete`) with Single Living Spec (`spec.md`).
-  - **Deep-Track (Architect Mode — 8 Steps)**: Full-lifecycle delivery pipeline (`00-discover` ➔ `10-define` ➔ `20-spec` ➔ `30-plan` ➔ `40-execute` ➔ `50-verify` ➔ `60-report` ➔ `70-release`).
-- **`packages/create-nexus-devflow/`**: Distribution CLI package with TypeScript compilation (`dist/bin/create-nexus-devflow.js`), atomic update engine (`lib/update.ts`), and prepack template bundler (`scripts/prepare-template.ts`).
-- **`.agents/skills/` & `.claude/skills/`**: 80 synchronized AI agent skills covering Dual-Track workflows and companion tools (`devflow`, `idea`, `report-html`, `try`, `doctor`, `overview`, `sync-upstream`, `ci`, `rollback`).
-- **`scripts/`**: Maintainer infrastructure (`check-devflow.ts`, `validate-framework.ts`, `smoke-package.ts`, `upstream-monitor.ts`, `evals/routing.ts`).
-- **`devflow/`**: Workspace state, discoveries, runs, ideas, context, reference contracts, and master release history ledger.
+## 5. Shipped Capabilities & Milestones
+- Verified features and components currently functional in the codebase.
 
-## Shipped Capabilities (Recent Milestones)
+## 6. Verified Commands & Developer Workflow
+- Dev Server, Build, Test, Lint, and Verify commands.
 
-- **`RUN-017` (2026-08-20)**: Separate Fast-Track skills (`/feature`, `/fix`) and rename Deep-Track stage 40 to `40-execute` to eliminate command collisions.
-- **`RUN-016` (2026-08-20)**: Quick Idea Capture and AI Feasibility Assessment (`/idea`) with centralized Idea Inbox (`devflow/ideas.md`).
-- **`RUN-015` (2026-08-20)**: Dual-Track Architecture (Fast-Track 4 Steps & Deep-Track 8 Steps) + Living Spec (`spec.md`) + Standalone HTML Reporting Policy.
-- **`RUN-014` (2026-08-20)**: Upgraded DevFlow to full TypeScript architecture (`tsconfig.json`, `tsx`, `tsc`, `dist/`), migrated AI Blueprint Upstream Monitor workflow to DevFlow, and established multi-lane verification matrix.
-
-## DevFlow Workspace Status
-
-- **Active Discovery ID**: None (Idle)
-- **Active Running ID**: `RUN-018-update-documentation-and-guides`
-- **Last Completed Run**: `RUN-017-split-spec-and-rename-40-execute`
+## 7. Known Architectural Focus Areas
+- Upcoming priorities, refactoring targets, or known technical considerations.

package/template/devflow/history/HISTORY.md

@@ -1,33 +1,19 @@
-# Nexus-DevFlow Master Release History Ledger
+# Master Release History Ledger
 
-This master ledger tracks all released delivery runs, milestones, and rollbacks in chronological order. Each entry is recorded during the `70-release` stage and links to its exact Git commit hash, release tag, and generated delivery artifacts.
+This master ledger tracks all released delivery runs, milestones, and rollbacks in chronological order. Each entry is recorded during `/complete` or `70-release` and links to its exact Git commit hash, release status, category, and archived delivery artifacts.
 
 ---
 
-## 📜 Release Log
+## 📜 Master Release Log
 
-| Release Date | Running ID | Title | Git Tag / Commit | Release Status | Report Link |
-| :--- | :--- | :--- | :--- | :--- | :--- |
-| 2026-08-20 | `RUN-018` | อัปเดตคู่มือ เอกสาร และ Website Documentation ให้เป็นปัจจุบันและครอบคลุม Dual-Track Model ล่าสุด | `HEAD` | `Released` | [`spec.md`](../runs/RUN-018-update-documentation-and-guides/spec.md) |
-| 2026-08-20 | `RUN-017` | แยกคำสั่ง Fast-Track เป็น `/feature`, `/fix` และเปลี่ยน Deep-Track สเตจ 40 เป็น `40-execute` | `HEAD` | `Released` | [`spec.md`](../runs/RUN-017-split-spec-and-rename-40-execute/spec.md) |
-| 2026-08-20 | `RUN-016` | ระบบบันทึกไอเดียพร้อม AI วิเคราะห์ความเป็นไปได้ (`/idea`) และเชื่อมต่อกับ Status Backlog | `HEAD` | `Released` | [`spec.md`](../runs/RUN-016-idea-capture-inbox-and-status-integration/spec.md) |
-| 2026-08-20 | `RUN-015` | Dual-Track Architecture (Fast-Track 4 Steps & Deep-Track 8 Steps) + Living Spec (`spec.md`) + Standalone HTML Report Policy | `HEAD` | `Released` | [`spec.md`](../runs/RUN-015-fast-track-and-living-blueprint/spec.md) |
-| 2026-08-20 | `RUN-014` | ยกระดับสถาปัตยกรรม DevFlow สู่ TypeScript และย้ายระบบ Check AI Blueprint Upstream Monitor | `HEAD` | `Released` | [`60-report.md`](../runs/RUN-014-typescript-migration-and-upstream-monitor-for-devflow/60-report.md) |
-| 2026-08-20 | `RUN-013` | เพิ่ม Skill `/overview` และระบบ Living Context Sync สำหรับ Nexus-DevFlow | `e30375b` | `Released` | [`60-report.md`](../runs/RUN-013-add-overview-and-context-sync-skill/60-report.md) |
-| 2026-08-18 | `RUN-008` | ปรับปรุงโครงสร้าง Nexus-DevFlow ให้ Lean & Clean ยุบรวม Skills บริหารจัดการ History และ Safe Rollback | `be713ea` | `Released` | [`60-report.md`](../runs/RUN-008-lean-and-clean-devflow-optimization/60-report.md) |
-| 2026-08-18 | `RUN-007` | ยกระดับระบบ Nexus-DevFlow ด้วยวินัยและกลไกสำคัญจาก Blueprint | `e79528b` | `Released` | [`60-report.md`](../runs/RUN-007-integrate-blueprint-skills-enhancements/60-report.md) |
-| 2026-08-18 | `RUN-006` | Standardize Command Naming and Provider Invocation | `HEAD` | `Released` | [`60-report.md`](../runs/RUN-006-standardize-command-naming-and-provider-invocation/60-report.md) |
-| 2026-08-18 | `RUN-005` | Add DevFlow Prefix to Skill Descriptions | `HEAD` | `Released` | [`60-report.md`](../runs/RUN-005-add-devflow-prefix-to-skill-descriptions/60-report.md) |
-| 2026-08-18 | `RUN-004` | Add Autopilot Skill | `HEAD` | `Released` | [`60-report.md`](../runs/RUN-004-add-autopilot-skill/60-report.md) |
-| 2026-08-18 | `RUN-003` | Add Try, Rollback, CI, Brief Skills | `HEAD` | `Released` | [`60-report.md`](../runs/RUN-003-add-try-rollback-ci-brief-skills/60-report.md) |
-| 2026-08-18 | `RUN-002` | Add Onboard, Adopt, Doctor Skills | `HEAD` | `Released` | [`60-report.md`](../runs/RUN-002-add-onboard-adopt-doctor-skills/60-report.md) |
-| 2026-08-18 | `RUN-001` | Align DevFlow with Blueprint Architecture | `HEAD` | `Released` | [`60-report.md`](../runs/RUN-001-align-devflow-blueprint/60-report.md) |
+| Completed Date | Run ID | Category | Title | Git Commit | Status | Archive Link |
+| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
+| _No shipped runs yet_ | - | - | Run `/feature` or `/00-discover` to start your first delivery run | - | - | - |
 
 ---
 
-## 🗄️ Run Lifecycle States
+## 🗄️ History Categories (The Core 3 Model)
 
-- **Active**: Currently executing in `devflow/runs/{running-id}-{slug}/` (tracked in `devflow/context/current-stage.md`).
-- **Released**: Finished `70-release`, merged, and logged in this master ledger.
-- **Archived**: Older historical runs moved to `devflow/history/archived-runs/` to maintain a clean workspace.
-- **Rolled Back**: Features safely reversed via `/rollback` with documented post-reversal verification.
+- **`features/`**: New user-facing features, enhancements, architecture migrations, refactoring, and tooling/infra.
+- **`fixes/`**: Bug fixes, hotfixes, regressions, security patches, and performance optimizations.
+- **`rollbacks/`**: Safe feature reversal and rollback execution records.

package/template/devflow/ideas.md

@@ -1,15 +1,19 @@
-# 💡 DevFlow Idea Inbox & Backlog
+# 🔮 Centralized Idea Inbox & Backlog
 
-บันทึกไอเดียที่รอดำเนินการ พร้อมบทวิเคราะห์ความเป็นไปได้เบื้องต้นจาก AI (บันทึกด้วยคำสั่ง `/idea "<text>"`)
+> Record, analyze, and prioritize feature ideas before starting active delivery.
+> Use the `/idea` command to quickly capture and evaluate new ideas.
 
 ---
 
-## 📌 Pending Ideas
+## 💡 Active Idea Inbox
 
-*(ยังไม่มีไอเดียค้างอยู่ — เพิ่มไอเดียใหม่ได้ด้วยคำสั่ง `/idea "<ข้อความไอเดีย>" หรือ `$idea "<text>"`)*
+| ID | Title | Value (1-5) | Feasibility (1-5) | Status | Notes |
+| :--- | :--- | :---: | :---: | :--- | :--- |
+| _No pending ideas_ | - | - | - | Use `/idea <your idea>` to capture | - |
 
 ---
 
 ## 📦 Archived / Shipped Ideas
 
-*(ไอเดียที่ถูกหยิบไปทำด้วย `/feature IDEA-xxx`, `/fix IDEA-xxx` หรือ `/00-discover IDEA-xxx` จะถูกย้ายมาบันทึกที่นี่)*
+| ID | Title | Shipped In | Completed Date |
+| :--- | :--- | :--- | :--- |

package/template/devflow/reference/running-id-contract.md

@@ -1,39 +1,39 @@
-# DevFlow 2.0 Running ID & Workspace Contract Reference
-
-## DevFlow Workspace Directory Structure
-
-All DevFlow framework context, active runs, templates, and history are consolidated under `devflow/`:
-
-- **Context (`devflow/context/`)**:
-  - `project-overview.md` - Primary source of truth for project architecture and stack.
-  - `coding-standards.md` - Development, code quality, and testing standards.
-  - `ai-interaction.md` - AI agent interaction rules and Thai artifact defaults.
-  - `current-stage.md` - Active stage run state.
-  - `findings.md` - Open and resolved audit findings ledger.
-
-- **Active Delivery Runs (`devflow/runs/{RUNNING_ID}/`)**:
-  - `10-define.md`
-  - `20-spec.md`
-  - `30-plan.md`
-  - `40-execute.md`
-  - `50-verify.md`
-  - `60-report.md` (and `60-report.html`)
-  - `70-release.md`
-
-- **Active Discoveries (`devflow/discoveries/{DISCOVERY_ID}-{slug}/`)**:
-  - `00-discover.md`
-
-- **History Archive (`devflow/history/`)**:
-  - `discoveries/` - Completed discovery archives.
-  - `runs/` - Completed delivery run archives.
-  - `reports/` - Completed stage reports.
-
-- **Reference Contracts (`devflow/reference/`)**:
-  - `running-id-contract.md`
-  - `stage-lifecycle-contract.md`
-
-## Mainline Lifecycle Rules
-
-1. Mainline stages move linearly: `/00-Discover` ➔ `/10-Define` ➔ `/20-Spec` ➔ `/30-Plan` ➔ `/40-Execute` ➔ `/50-Verify` ➔ `/60-Report` ➔ `/70-Release`.
-2. Companion commands (`Goal`, `Brainstorm`, `Research`, `Debug`, `PRD`, `Issue-Triage`, `Security-Review`, `Check-For-Updates`, `Help`) provide supporting context without replacing mainline stage numbers.
-3. Every stage produces markdown-first evidence in `devflow/runs/` before passing verification gates.
+# DevFlow 2.0 Running ID & 3-Pillars Workspace Contract
+
+## The 3-Pillars Workspace Architecture
+
+All DevFlow framework assets are organized into three clean pillars representing Future, Present, and Past:
+
+```text
+devflow/
+├── 🔮 ideas.md                 # [1. Future / Backlog] Centralized Idea Inbox with AI scoring
+│
+├── ⚡ context/                  # [2. Present / Active] Living Source of Truth & Active Work
+│   ├── project-overview.md     # Primary source of truth for project architecture and tech stack
+│   ├── coding-standards.md     # Engineering, code quality, TDD, and testing standards
+│   ├── ai-interaction.md       # AI agent interaction rules, dual-track flow, and Thai defaults
+│   ├── findings.md             # Open and resolved audit findings ledger (P0-P3)
+│   ├── current-stage.md        # Active state pointer and run tracker
+│   ├── current-feature.md      # Fast-Track Single Living Spec (Active work / stub when idle)
+│   └── current-run/            # Deep-Track Active Run folder (Temporary during 10-70 execution)
+│
+├── 📦 history/                  # [3. Past / Completed] Permanent Delivery & Release Archives
+│   ├── features/               # Completed features, architecture migrations, tooling (xxx-slug.md or xxx-slug/)
+│   ├── fixes/                  # Completed bug fixes, hotfixes, security patches (xxx-slug.md)
+│   ├── rollbacks/              # Completed feature reversals (YYYY-MM-DD-xxx-slug.md)
+│   └── HISTORY.md              # Master release ledger summary table
+│
+└── 🔍 discoveries/              # Pre-delivery discovery records (DISC-YYYYMMDD-NNN-slug/00-discover.md)
+```
+
+## Running ID Naming Convention
+
+- **Format**: `xxx-slug` (e.g. `001-setup-auth`, `021-categorized-history-and-clean-living-spec-architecture`)
+- **Prefix Removal**: The legacy `RUN-` prefix is discontinued in favor of clean 3-digit sequential numbering.
+- **Git Branch Standard**: `feature/{xxx-slug}` or `fix/{xxx-slug}`.
+
+## Single Active Run Rule (One Thing at a Time)
+
+1. Only **one active run** is permitted at any given time across both Fast-Track and Deep-Track.
+2. Before opening a new run (`/feature`, `/fix`, or `10-define`), the AI checks `current-stage.md` and `current-feature.md`.
+3. If an active run is in progress, the AI **blocks** starting a new task and requires closing the active run via `/complete` or `70-release` (or explicitly cancelling/rolling back).