@jakkrichm/create-nexus-devflow 2.6.2 → 2.8.0

package/template/devflow/config.json

@@ -0,0 +1,33 @@
+{
+  "schemaVersion": 1,
+  "workflow": {
+    "stepReview": "every",
+    "checkpointCommits": "enabled"
+  },
+  "git": {
+    "featureBranchPrefix": "feature/",
+    "fixBranchPrefix": "fix/",
+    "rollbackBranchPrefix": "rollback/"
+  },
+  "verification": {
+    "logicTests": "when-configured",
+    "uiEvidence": "when-available"
+  },
+  "qualityGates": {
+    "regular": {
+      "audit": "manual",
+      "check": "manual",
+      "tryGuide": "manual"
+    },
+    "continuous": {
+      "audit": "manual",
+      "check": "manual",
+      "tryGuide": "manual"
+    }
+  },
+  "continuous": {
+    "maxFeatures": null,
+    "maxRepairAttempts": 2,
+    "finalIntegrationAudit": false
+  }
+}

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