@jakkrichm/create-nexus-devflow 2.7.0 → 2.9.0

package/template/AGENTS.md

@@ -1,12 +1,12 @@
-# Nexus-DevFlow 2.7.0 (The 3-Pillars & Single Living Spec Model)
+# Nexus-DevFlow (The 3-Pillars & Pure Task-Isolated Living Spec 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 workflow layer supporting **The 3-Pillars Workspace Architecture & Single Living Spec Model**:
-1. **🔮 Future (Backlog)**: `devflow/ideas.md` — Centralized Idea Inbox with AI scoring.
-2. **⚡ Present (Active Context)**: `devflow/context/` — Living Source of Truth & Active Work (`current-feature.md` Single Living Spec).
+This project uses **Nexus-DevFlow**, an agentic workflow layer supporting **The 3-Pillars Workspace Architecture & Pure Task-Isolated Living Spec Model**:
+1. **🔮 Future (Backlog)**: `devflow/ideas.md`, `devflow/project-plan.md`, `devflow/build-plan.md` — Centralized Idea Inbox & Master Build Plan.
+2. **⚡ Present (Active Context)**: `devflow/context/` — Global Shared Source of Truth (`project-overview.md`, `coding-standards.md`, `ai-interaction.md`, `glossary.md`) & Active Task Workspaces (`devflow/context/{xxx-slug}/`).
 3. **📦 Past (History Archive)**: `devflow/history/` — Categorized delivery archives (`features/`, `fixes/`, `rollbacks/`, and `HISTORY.md`).
 
 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.
@@ -17,9 +17,8 @@ To start a new project, scaffold the application first in an empty folder, then
 - `devflow/context/project-overview.md` - the project's source of truth
 - `devflow/context/coding-standards.md` - engineering conventions & rules to follow
 - `devflow/context/ai-interaction.md` - how to interact with the user on this project
-- `devflow/context/current-stage.md` - active discovery or running delivery state
-- `devflow/context/findings.md` - quality, security, and verification ledger
 - `devflow/context/glossary.md` - domain terms & architecture definitions
+- `devflow/context/{xxx-slug}/` - active task living spec, stage, and findings ledger
 
 ## Project configuration
 
@@ -45,28 +44,28 @@ Unused adapter families can be removed. Codex, Antigravity, GitHub Copilot, and
    - **Dollar Prefix (`$`)**: For OpenAI Codex CLI or skill-invocation tools, e.g., `$feature`, `$fix`, `$continuous`, `$devflow`, `$discovery`.
 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 context in `devflow/context/`.
-5. **Default Artifact & Communication Language (Thai)**: All generated markdown stage artifacts (`current-feature.md`, `discovery.md`, etc.) and user communication MUST default to **Thai (`th`)**, while code, technical terms, file paths, and identifiers remain in English.
+4. **State-Aware Inspection**: When unsure what to do next, invoke `devflow` to automatically inspect active task directories in `devflow/context/{xxx-slug}/`, `devflow/discoveries/`, and `devflow/ideas.md`.
+5. **Default Artifact & Communication Language (Thai)**: All generated markdown stage artifacts (`spec.md`, `discovery.md`, etc.) and user communication MUST default to **Thai (`th`)**, while code, technical terms, file paths, and identifiers remain in English.
 
 ---
 
-## ⚡ The Unified 4-Stage Living Spec Lifecycle
+## ⚡ The Unified 4-Stage Task-Isolated Living Spec Lifecycle
 
-All development tasks (from lean UI fixes to deep architectural epics) execute through the 4-step progressive lifecycle:
+All development tasks execute through the 4-step progressive lifecycle:
 
 ```text
 /feature (หรือ /fix) ──▶ /implement ──▶ /check ──▶ /complete
 ```
 
-1. **`feature` / `fix` (`/feature`, `/fix`, `/spec`)**:
-   - **Purpose**: Combines Discover, Define, Spec, and Plan into one unified step. Checks Single Active Run Guardrail, allocates sequential ID (`xxx-slug`), and creates the **Single Living Spec (`devflow/context/current-feature.md`)** with 6 structured sections.
-   - **Artifact**: `devflow/context/current-feature.md`
-2. **`implement` (`/implement`)**:
-   - **Purpose**: Incrementally executes checklist tasks with TDD discipline (Red-Green-Refactor) and appends diff evidence to `current-feature.md`.
-3. **`check` (`/check`)**:
-   - **Purpose**: Senior QA review, multi-lane verification matrix (Typecheck, Lint, Test suites, manual proof), and records empirical proof into `current-feature.md`.
-4. **`complete` (`/complete`)**:
-   - **Purpose**: Final safety pass, records Release Digest, automatically archives to `devflow/history/{features|fixes|rollbacks}/{xxx-slug}.md`, resets the stub, and performs git squash-merge.
+1. **`feature` / `fix` (`/feature`, `/fix`)**:
+   - **Purpose**: Combines Discover, Define, Spec, and Plan into one unified step. Allocates sequential ID (`xxx-slug`) and initializes the **Task-Isolated Living Spec (`devflow/context/{xxx-slug}/spec.md`)**, stage pointer (`stage.md`), and dedicated audit ledger (`findings.md`).
+   - **Artifact**: `devflow/context/{xxx-slug}/spec.md`
+2. **`implement` (`/implement [id]`)**:
+   - **Purpose**: Checks out `feature/{xxx-slug}` (or auto-detects from branch), incrementally executes checklist tasks in `devflow/context/{xxx-slug}/spec.md` with TDD discipline (Red-Green-Refactor), and appends diff evidence.
+3. **`check` (`/check [id]`)**:
+   - **Purpose**: Senior QA review, multi-lane verification matrix (Typecheck, Lint, Test suites, manual proof), and records empirical proof into `devflow/context/{xxx-slug}/spec.md` and findings into `findings.md`.
+4. **`complete` (`/complete [id]`)**:
+   - **Purpose**: Final safety pass, records Release Digest, automatically archives to `devflow/history/{features|fixes|rollbacks}/{xxx-slug}.md`, cleanly removes `devflow/context/{xxx-slug}/`, updates `HISTORY.md` and `build-plan.md`, and performs git squash-merge.
 
 ---
 

package/template/devflow/build-plan.md

@@ -108,3 +108,12 @@
   - *Dependencies*: Feature 12, DISC-20260826-003
   - *Scope*: นำระบบ Deterministic Project Configuration (`devflow/config.json`) และสคิล Autonomous Multi-Feature Loop (`/continuous`) เข้าสู่ Nexus-DevFlow พร้อมอัปเกรด `project-config.ts`, `doctor`, `status`, `dashboard` และอัปเดต upstream baseline tracking สู่ v0.14.0
 
+---
+
+## ⚡ Phase 14: Pure Multi-Run Task-Isolated Architecture
+
+- [x] **14. Pure Multi-Run Task-Isolated Architecture (`DISC-20260826-004`)** `[Size: M]`
+  - *Dependencies*: Feature 11, Feature 12, Feature 13
+  - *Scope*: ยกเลิกไฟล์ Single Living Spec ที่ Root (`current-feature.md`, `current-stage.md`, `findings.md`) อย่างสมบูรณ์ ปรับโครงสร้างสู่ Task-Isolated Subdirectories 100% (`devflow/context/{xxx-slug}/`), อัปเกรด Agent Directives, Core Context Resolver, Scaffolding Templates และ Workflow Skills ทั้งหมด
+
+

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

@@ -27,46 +27,60 @@ Format every response for fast scanning and readability:
 
 ---
 
-## 3. The 3-Pillars Unified Architecture (DevFlow 2.5.0)
+## 3. The 3-Pillars Unified Architecture
 
 ```text
 devflow/
-├── 🔮 ideas.md        # [Future] Idea Inbox with AI Feasibility Scoring
-├── ⚡ context/         # [Present] Single Living Spec (current-feature.md) & Active State
-└── 📦 history/         # [Past] features/, fixes/, rollbacks/, and HISTORY.md
+├── 🔮 ideas.md                     # [Future] Idea Inbox with AI Feasibility Scoring
+├── 🗺️ project-plan.md              # [Future] Master Roadmap
+├── 📋 build-plan.md                # [Future] Master Build Plan & Sizing
+│
+├── ⚡ context/                      # [Present] Living Source of Truth & Active Tasks
+│   ├── project-overview.md         # 🌐 Global Architecture & Stack
+│   ├── coding-standards.md         # 🌐 Global Coding & TDD Standards
+│   ├── ai-interaction.md           # 🌐 Global AI Interaction Rules
+│   ├── glossary.md                 # 🌐 Domain Terms & Glossary
+│   │
+│   └── {xxx-slug}/                 # ⚡ Active Task Workspace
+│       ├── spec.md                 # Living Spec + TDD Checklist
+│       ├── stage.md                # Runtime Stage & Branch Reference
+│       └── findings.md             # Dedicated Audit Ledger (P0-P3)
+│
+└── 📦 history/                     # [Past] features/, fixes/, rollbacks/, and HISTORY.md
 ```
 
-### ⚡ The Unified 4-Stage Living Spec Lifecycle
-*ขับเคลื่อนการพัฒนาทุกระดับ (ตั้งแต่ Fast Fix จนถึง Architectural Epic) ด้วยเอกสารฉบับเดียว **Single Living Spec (`devflow/context/current-feature.md`)** ที่รวมความลึกระดับ Architect Mode เข้ากับความคล่องตัวระดับ Lean Velocity:*
+### ⚡ The Unified 4-Stage Task-Isolated Living Spec Lifecycle
+*ขับเคลื่อนการพัฒนาทุกระดับด้วย **Task-Isolated Living Spec (`devflow/context/{xxx-slug}/spec.md`)** ที่รวมความลึกระดับ Architect Mode เข้ากับความคล่องตัวระดับ Lean Velocity โดยแยก Workspace ของแต่ละงานออกจากกัน 100%:*
 
 ```text
 /feature (หรือ /fix) ──▶ /implement ──▶ /check ──▶ /complete
 ```
 
 1. **Stage 1: Spec (`/feature` หรือ `/fix`)**:
-   - ตรวจสอบ **Single Active Run Guardrail** (บล็อกการเปิดงานซ้อนถ้ามีงานที่ยังไม่เสร็จ)
    - ดึงบริบทจาก `devflow/discoveries/`, `devflow/ideas.md`, หรือคำขอของผู้ใช้
-   - จัดสรร Running ID (`xxx-slug`) และสร้าง Branch `feature/{xxx-slug}` หรือ `fix/{xxx-slug}`
-   - เขียน **Single Living Spec (`current-feature.md`)** ครอบคลุม:
+   - จัดสรร Running ID (`xxx-slug`) และสร้างโฟลเดอร์ `devflow/context/{xxx-slug}/`
+   - เขียน **Task-Isolated Living Spec (`spec.md`)**, `stage.md`, และ `findings.md` ครอบคลุม:
      - `## 🎯 1. Define & Boundaries` (Problem, In/Out Scope, Risks, Success Criteria)
      - `## 📐 2. Technical Spec & Contracts` (Architecture, Models, Interface Contracts, Non-functional, ACs)
      - `## 📋 3. Execution Plan & TDD Checklist` (Atomic tasks, `[TDD-Red/Green/Refactor]` Triplets)
 
-2. **Stage 2: Implement (`/implement`)**:
+2. **Stage 2: Implement (`/implement [id]`)**:
+   - สลับไปยัง Branch `feature/{xxx-slug}` (หรือ Auto-detect จาก Current Branch / Task Queue)
    - ดำเนินการ Task-by-task ตาม Checklist อย่างเคร่งครัดด้วย **TDD (Red-Green-Refactor)**
-   - ติ๊กเครื่องหมาย `- [x]` และบันทึก `## ⚡ 4. Implementation Log & Evidence` (Diff summary, Checkpoints) ลงใน `current-feature.md`
+   - ติ๊กเครื่องหมาย `- [x]` และบันทึก `## ⚡ 4. Implementation Log & Evidence` (Diff summary, Checkpoints) ลงใน `devflow/context/{xxx-slug}/spec.md`
 
-3. **Stage 3: Check (`/check`)**:
+3. **Stage 3: Check (`/check [id]`)**:
    - Senior QA Multi-Lane Verification (Typecheck, Lint, Test Suites, Manual Proof)
-   - บันทึกผลการพิสูจน์เชิงประจักษ์ลงใน `## 🧪 5. Multi-Lane Verification Matrix` ใน `current-feature.md`
+   - บันทึกผลการพิสูจน์เชิงประจักษ์ลงใน `## 🧪 5. Multi-Lane Verification Matrix` ใน `spec.md` และบันทึก Finding ลงใน `findings.md` เฉพาะงาน
 
-4. **Stage 4: Complete (`/complete`)**:
+4. **Stage 4: Complete (`/complete [id]`)**:
    - สรุปผล `## 📦 6. Release Digest & Retrospective` (Changelog, Lessons Learned, ADRs)
-   - ทำการ Archive `current-feature.md` ไปเป็นไฟล์เดี่ยวที่ `devflow/history/{features|fixes|rollbacks}/{xxx-slug}.md`
+   - ทำการ Archive `spec.md` ไปเป็นไฟล์เดี่ยวที่ `devflow/history/{features|fixes|rollbacks}/{xxx-slug}.md`
+   - ลบโฟลเดอร์เฉพาะกิจ `devflow/context/{xxx-slug}/` ออกอย่างหมดจด
    - **Mandatory Delivery Gate**: บังคับถามผู้ใช้ก่อนเสมอว่าต้องการ Delivery รูปแบบใด:
      - **Option 1 (Team MR/PR Flow)**: Pull master/main ล่าสุดมารวมกับ Feature/Dev Branch แล้ว push branch ขึ้นไปเพื่อเปิด MR/PR (ไม่ merge เข้า main/master ในเครื่อง และไม่แตะ protected branch)
      - **Option 2 (Direct Squash-Merge)**: ทำการ Squash-merge เข้า main/master ในเครื่องเฉพาะเมื่อผู้ใช้สั่งโดยตรงเท่านั้น
-   - รีเซ็ต `current-feature.md` กลับเป็น Idle stub เมื่อปิดรอบงานเรียบร้อย
+   - อัปเดต `devflow/history/HISTORY.md` และ `devflow/build-plan.md` ให้เป็น `[x]` เรียบร้อย
 
 ---
 
@@ -145,3 +159,28 @@ Progress lives in persistent files, not in transient chat history:
 - **Lazy Inline Persistence**:
   - Immediately append resolved terms to `devflow/context/glossary.md`.
   - Immediately record major, hard-to-reverse architectural decisions as Architecture Decision Records in `devflow/decisions/ADR-xxx-{slug}.md`.
+
+---
+
+## 10. Third-Party Skill Orchestration & Multi-Skill Delegation Protocol
+
+Nexus-DevFlow natively supports extending workflow capabilities with **Third-Party Skills** (installed via `nexus-devflow skill add <repo-or-path>`):
+
+### 🧩 1. Discovery & Inventory
+- Core workflow commands and AI agents automatically inspect `.agents/skills/` (and `.claude/skills/`) or run `nexus-devflow skill list` to discover installed third-party capabilities.
+- Installed third-party skills maintain their exact original directory structure, references, assets, scripts, and `SKILL.md`.
+
+### 🎯 2. Cross-Command Delegation & Genuine Execution
+- **Verbatim & Original Prompt Fidelity**: When a DevFlow stage requires specialized domain expertise (e.g., editorial diagramming, domain modeling, cloud provisioning, UI benchmarking), the AI agent must read the third-party skill's `SKILL.md` (e.g. `.agents/skills/diagram-design/SKILL.md`) and strictly follow its original instructions, philosophy, style guide gates, and complexity constraints.
+- **Workflow Command Integration Map**:
+  - **`/discovery`**: When macro roadmap planning or micro pre-flight exploration involves system architecture, IT landscape, data pipelines, sequence flows, or user journeys, check for `diagram-design` and generate editorial HTML/SVG diagrams.
+  - **`/feature` & `/fix`**: In Section 2 (`## 📐 2. Technical Spec & Contracts`), invoke `diagram-design` for component diagrams, database ER models, or sequence flows.
+  - **`/brainstorm` & `/grill`**: Leverage visual trade-off matrices (Quadrant, Radar spider) or domain models (UML class, ER).
+  - **`/prototype` & `/report-html`**: Embed standalone HTML/SVG assets seamlessly.
+  - **`/devflow`**: Intent router surfaces installed third-party skills (e.g. `/diagram-design`) directly to the user.
+
+### 📁 3. Generated Asset Storage Hierarchy
+- **Discovery Stage**: `devflow/discoveries/{id}/diagrams/` (referenced in `discovery.md`).
+- **Active Task Stage**: `devflow/context/{xxx-slug}/diagrams/` (referenced in `spec.md`).
+- **Global / Reference**: `devflow/reference/diagrams/` or `devflow/reference/assets/`.
+

package/template/devflow/reference/feature-spec-template.md

@@ -1,7 +1,7 @@
 # [ID-slug] Feature Title
 
-> **Template Type**: Single Living Spec (DevFlow 2.5.0)
-> **Active Location**: `devflow/context/current-feature.md`
+> **Template Type**: Task-Isolated Living Spec
+> **Active Location**: `devflow/context/{xxx-slug}/spec.md`
 > **Archive Location**: `devflow/history/{features|fixes|rollbacks}/{ID-slug}.md`
 
 - **Feature ID**: `{xxx-slug}`

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

@@ -15,9 +15,6 @@ devflow/
 │   ├── coding-standards.md     # Engineering, code quality, TDD, and testing standards
 │   ├── ai-interaction.md       # AI agent interaction rules, unified living spec flow, and Thai defaults
 │   ├── glossary.md             # Domain glossary and architecture vocabulary
-│   ├── current-feature.md      # Active Living Spec pointer / legacy fallback
-│   ├── current-stage.md        # Active state pointer and run tracker
-│   ├── findings.md             # Shared/default audit findings ledger (P0-P3)
 │   │
 │   ├── {xxx-slug}/             # Active Run Workspace & Spec Queue (Multi-Run Active Task)
 │   │   ├── spec.md             # Living Spec + Checklist for this run

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

@@ -1,3 +0,0 @@
-# Current Feature
-
-_Nothing in progress. Run /feature, /fix, or /rollback to start._

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

@@ -1,11 +0,0 @@
-# Current Stage
-
-- Active Discovery ID: `None`
-- Active Running ID: `None`
-- Track: `idle`
-- Current Stage: `idle`
-- Active Branch: `main`
-- Living Spec: `devflow/context/current-feature.md`
-- Next Action: `Run /feature, /fix, or /discovery to start new work.`
-- Last Completed Run: `None`
-- Last Updated: `None`

package/template/devflow/context/findings.md

@@ -1,10 +0,0 @@
-# Findings
-
-> **Generated file.** The findings ledger: review findings raised by `/audit`
-> against the work in progress, each with a durable ID, severity (P0-P3), and
-> status. `/implement` marks repaired findings `fixed`, a later `/audit` pass
-> moves them to `closed`, and `/complete` refuses to merge while any P0 or P1
-> finding is `open` or `fixed`, then archives resolved findings with the work
-> and resets this file.
-
-_No findings recorded. `/audit` appends findings here when it finds them._