@jakkrichm/create-nexus-devflow 2.7.0 → 2.8.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/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Nexus-DevFlow contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Nexus-DevFlow contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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]` เรียบร้อย
 
 ---
 

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._