@jakkrichm/create-nexus-devflow 2.0.25 → 2.1.0

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

@@ -65,17 +65,17 @@ The entire lifecycle is driven by the **Single Living Spec (`devflow/context/cur
 *Recommended for large architectural epics, database migrations, security audits, and multi-agent coordination.*
 
 ```text
-00-discover ➔ 10-define ➔ 20-spec ➔ 30-plan ➔ 40-execute ➔ 50-verify ➔ 60-report ➔ 70-release
+00-explore ➔ 10-define ➔ 20-spec ➔ 30-plan ➔ 40-execute ➔ 50-verify ➔ 60-report ➔ 70-deliver
 ```
 
-1. `00-discover`: Explore request before delivery commitment (`DISC-YYYYMMDD-NNN`).
+1. `00-explore`: Explore request before delivery commitment (`DISC-YYYYMMDD-NNN`).
 2. `10-define`: Turn approved discovery into bounded delivery run in `devflow/context/current-run/10-define.md`.
 3. `20-spec`: Formalize markdown 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, git merge, archives `devflow/context/current-run/` ➔ `devflow/history/{features|fixes|rollbacks}/{xxx-slug}/`, and closes the run.
+8. `70-deliver`: Release packaging, git merge, archives `devflow/context/current-run/` ➔ `devflow/history/{features|fixes|rollbacks}/{xxx-slug}/`, and closes the run.
 
 ---
 
@@ -102,7 +102,7 @@ Progress lives in persistent files, not in transient chat history:
 ## 6. Single Active Run Guardrail (One Thing at a Time)
 
 - Only one active run is allowed at a time across both Fast-Track and Deep-Track.
-- The AI will actively block opening a new feature or fix until the current one is completed with `/complete` or `70-release` (or explicitly rolled back/cancelled).
+- The AI will actively block opening a new feature or fix until the current one is completed with `/complete` or `70-deliver` (or explicitly rolled back/cancelled).
 
 ---
 

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

@@ -63,7 +63,7 @@ nexus-devflow/
 ├── .nexus/                     # Metadata tracking & upstream baseline ledger
 ├── devflow/                    # Framework workspace context, history, and discoveries
 │   ├── context/                # Living source-of-truth context files
-│   ├── discoveries/            # Pre-delivery discovery records (00-discover.md)
+│   ├── discoveries/            # Pre-delivery discovery records (00-explore.md)
 │   ├── history/                # Master delivery archive (features/, fixes/, rollbacks/, HISTORY.md)
 │   └── ideas.md                # Idea Inbox and backlog
 ├── packages/
@@ -79,7 +79,7 @@ nexus-devflow/
 ## 6. Naming Conventions
 
 - **Files & Directories**:
-  - Skills and command directories: `kebab-case` (e.g. `00-discover`, `report-html`, `sync-upstream`).
+  - Skills and command directories: `kebab-case` (e.g. `00-explore`, `report-html`, `sync-upstream`).
   - Source modules and scripts: `kebab-case.ts` / `kebab-case.mjs` (e.g. `current-work.ts`, `check-devflow.ts`).
   - Test files: `[module].test.ts` (e.g. `status.test.ts`, `uninstall.test.ts`).
 - **Identifiers**:
@@ -117,7 +117,7 @@ Testing is a core quality gate in Nexus-DevFlow, not an afterthought:
   - `fixed`: Repaired in code, pending QA re-verification.
   - `closed`: Verified by QA as completely resolved without regressions.
   - `accepted`: Formally waived with recorded user justification.
-- **P0/P1 Blockers**: Any P0 or P1 finding in `open` or `fixed` status unconditionally blocks `/complete` and `70-release`.
+- **P0/P1 Blockers**: Any P0 or P1 finding in `open` or `fixed` status unconditionally blocks `/complete` and `70-deliver`.
 
 ---
 

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

@@ -2,7 +2,7 @@
 
 - **Active Discovery ID**: `None`
 - **Active Running ID**: `None`
-- **Current Stage**: `Idle (Ready for new /feature, /fix, /00-discover, or /10-define)`
+- **Current Stage**: `Idle (Ready for new /feature, /fix, /00-explore, or /10-define)`
 - **Living Spec**: `None`
 - **Last Completed Run**: `None`
 - **Last Updated**: `None`

package/template/devflow/context/findings.md

@@ -6,7 +6,7 @@
 > `### <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`.
+> - **Release Gate Rule**: Any `P0` or `P1` finding in `open` or `fixed` status unconditionally blocks `/complete` and `70-deliver`.
 
 ---
 

package/template/devflow/history/HISTORY.md

@@ -1,6 +1,6 @@
 # Master Release History Ledger
 
-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.
+This master ledger tracks all released delivery runs, milestones, and rollbacks in chronological order. Each entry is recorded during `/complete` or `70-deliver` and links to its exact Git commit hash, release status, category, and archived delivery artifacts.
 
 ---
 
@@ -8,7 +8,7 @@ This master ledger tracks all released delivery runs, milestones, and rollbacks
 
 | 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 | - | - | - |
+| _No shipped runs yet_ | - | - | Run `/feature` or `/00-explore` to start your first delivery run | - | - | - |
 
 ---
 

package/template/devflow/project-plan.md

@@ -0,0 +1,79 @@
+# 🗺️ Project Plan (User-Owned Architectural Vision)
+
+> **Document Type**: Project Plan (User-Owned)  
+> **Purpose**: แหล่งความจริงหลัก (Single Source of Truth) สำหรับวิสัยทัศน์ผลิตภัณฑ์ สถาปัตยกรรมระบบ มาตรการความปลอดภัย กฎเกณฑ์การส่งมอบ และแผนงานพัฒนาต่อยอด ถูกนำไปประมวลผลเป็น `devflow/context/project-overview.md` ผ่านคำสั่ง `/overview`
+
+---
+
+## 1. Product Vision & Problem Statement
+
+- **What this is**: **Nexus-DevFlow** คือระบบ **Agentic Workflow Layer & Pair Programming Operating System** ที่เชื่อมต่อระหว่างนักพัฒนา (Human Developer) และปัญญาประดิษฐ์ (AI Coding Agents เช่น Google Antigravity, Claude Code, OpenAI Codex, Cursor, GitHub Copilot) เพื่อยกระดับการพัฒนาซอฟต์แวร์สู่มาตรฐานระดับวิศวกรรมสากล
+- **Target Audience**:
+  - นักพัฒนาเดี่ยว (Solo Developers) ที่ต้องการความเร็วสูงแต่ยังคงมีระเบียบวินัยและหลักฐานการทดสอบที่ชัดเจน
+  - ทีมพัฒนาและองค์กร (Engineering Teams & Tech Leads) ที่ต้องการมาตรฐานการส่งมอบโค้ดที่ตรวจสอบได้ (Traceable), ตรวจสอบย้อนหลังได้ (Auditable) และไม่มีปัญหาโค้ดตีกัน (Zero Merge Conflict)
+- **Core Value Proposition**:
+  - **The 3-Pillars Model**: จัดระเบียบบริบทเป็น 3 เสาหลักอย่างชัดเจน — *🔮 Future (Inbox `ideas.md`)* ➔ *⚡ Present (Living Context `devflow/context/`)* ➔ *📦 Past (Categorized History `devflow/history/`)*
+  - **Dual-Track Delivery Model**: เลือกความเร็วให้เหมาะกับขนาดงาน — *Fast-Track (4 ขั้นตอน)* สำหรับ 85% ของงานประจำวัน และ *Deep-Track (8 ขั้นตอน)* สำหรับ 15% ของงานสถาปัตยกรรม
+  - **Hard Quality Gates**: ระบบปฏิเสธการปล่อยงานเมื่อไม่ผ่านเกณฑ์การทดสอบ หรือมีข้อบกพร่องความปลอดภัยค้างอยู่
+
+---
+
+## 2. Architecture & Tech Stack
+
+- **Runtime & Language**: Node.js (>=18.17.0), TypeScript (Strict ESM-First `"type": "module"`)
+- **Persistence & State**:
+  - Markdown-First Architecture พร้อม Type-Safe Schema Validation (Zod)
+  - Git-Backed History Archive (`devflow/history/features/`, `devflow/history/fixes/`, `devflow/history/rollbacks/`, `HISTORY.md`)
+  - Local State Management & Backup Snapshots (`.nexus/`)
+- **Key Modules & Subsystems**:
+  - **Distribution CLI & Package**: `packages/create-nexus-devflow` (Scaffolding, Doctor, Status, Update, Gatekeeper)
+  - **Interactive Web Dashboard**: Embedded Local Webview Dashboard (`/dashboard`) พร้อม Dual-Track Visualizer และ Real-time Snapshot
+  - **Gatekeeper Engine**: ระบบตรวจสอบคุณภาพโค้ดและ Finding Blockers (`nexus-devflow check-gate`)
+  - **Model Context Protocol (MCP) Server**: JSON-RPC Hub สำหรับเชื่อมต่อ AI Agents แบบ Type-Safe
+  - **Dynamic Context Slicer**: ระบบจัดสรรและตัดตอนบริบทแบบ Just-In-Time (JIT) เพื่อประหยัด Token
+- **Integration Points & AI Adapters**:
+  - Google Antigravity & OpenAI Codex (`.agents/skills/`)
+  - Claude Code (`.claude/skills/`)
+  - Model Context Protocol (`@modelcontextprotocol/sdk`)
+
+---
+
+## 3. Constraints, Defensive Guardrails & Non-Goals
+
+- **5 เสาหลักมาตรการป้องกันความเสี่ยง (Hard Defensive Guardrails)**:
+  1. *Hard Quality Gates & Git Hooks*: บล็อกการ Commit ทันทีหาก Spec ไม่ครบ หรือมี `P0/P1 Finding` ค้างอยู่ในสถานะ `open`
+  2. *Model Context Protocol (MCP)*: บังคับใช้ Typed Function Calling เพื่อป้องกันความเสียหายจากการ Parse ข้อความ Markdown
+  3. *Branch-Scoped Context Isolation*: แยกโฟลเดอร์ State ตาม Git Branch ใน `.nexus/branches/<name>/` ป้องกัน Merge Conflict เมื่อทำงานเป็นทีม
+  4. *Dynamic Context Slicing*: ส่งเฉพาะบริบทที่จำเป็นต่อ Stage นั้นๆ เข้าสู่ AI ลด Token Bloat 60–70%
+  5. *State Drift Reconciler*: ตรวจจับความไม่สอดคล้องระหว่าง Git Diffs กับ Spec Tasks และเสนอทางเลือก Auto-Sync ทันที
+- **Non-Goals**:
+  - ไม่ใช่ Proprietary IDE หรือ Closed Cloud SaaS — DevFlow เป็น Transparent Git-Native Layer ที่ฝังตัวในโปรเจกต์ใดก็ได้
+  - ไม่ใช่ Auto-GPT ที่ปล่อยให้ AI เขียนโค้ดตามใจโดยไม่มี Human-in-the-Loop Review Gates
+- **Delivery Rules**:
+  - เคร่งครัดใน TDD Mandate: โค้ดที่เพิ่มหรือแก้ไขต้องมี Automated Unit Tests เสมอ
+  - ห้ามข้ามขั้นตอน Verification: ต้องมีหลักฐานเชิงประจักษ์ (Empirical Proof) ใน `/check` ก่อนอนุมัติ `/complete`
+
+---
+
+## 4. Key Milestones & Evolution Roadmap
+
+- **🚀 Milestone 1: Hard Quality Gates & Pre-commit Enforcement**
+  - ติดตั้ง `check-gate` เข้าสู่ Git Pre-commit Hooks และ CI Pipeline
+  - บล็อกการส่งมอบเมื่อมี Unchecked Tasks หรือ P0/P1 Blockers
+- **⚡ Milestone 2: DevFlow MCP Server Hub & Type-Safe Schemas (`IDEA-004`)**
+  - พัฒนา MCP Server ผ่าน JSON-RPC สำหรับ Antigravity, Claude, Codex, Cursor
+  - ใช้ Zod Schema ควบคุมการอัปเดต Task, Findings, และ Stage State 100% Type-safe
+- **🌿 Milestone 3: Branch-Scoped Context Isolation & Dynamic Router**
+  - รองรับการเก็บ State แยกตาม Git Branch ป้องกัน Merge Conflict ในทีม
+  - ระบบ Auto-Cleanup ลบ Branch State หลังจบ `/complete` และย้ายเข้าสู่ History
+- **✂️ Milestone 4: JIT Context Slicing & Token Budgeting Engine**
+  - ปรับระบบส่ง Context ให้ AI ตาม Stage แบบไดนามิก ประหยัด Token 70%
+  - ควบคุมขนาด `project-overview.md` ไม่ให้เกินงบประมาณ Token
+- **🔄 Milestone 5: Git Diff Reconciler & Self-Healing State**
+  - ตรวจจับความคลาดเคลื่อนระหว่างการแก้โค้ดของมนุษย์กับ Living Spec
+  - ระบบ Smart Reconciliation แจ้งเตือนและซิงค์สเปกอัตโนมัติ
+- **🖥️ Milestone 6: IDE Native Extension & Visual Kanban Studio**
+  - ส่วนขยายบน VS Code / Antigravity Webview สำหรับควบคุม DevFlow ครบวงจรใน IDE
+- **🤖 Milestone 7: Multi-Agent Swarm Orchestration & Semantic Code RAG**
+  - ระบบประสานงาน Subagents หลายตัว (Coder, QA, Auditor) ทำงานขนานกัน
+  - Local Dependency Graph & Semantic Code Search เพื่อดึงบริบทที่แม่นยำสูงสุด