@jakkrichm/create-nexus-devflow 2.17.2 → 2.17.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/package.json +1 -1
  2. package/template/devflow/build-plan.md +24 -274
  3. package/template/devflow/project-plan.md +38 -65
  4. package/template/devflow/runs/.gitkeep +1 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jakkrichm/create-nexus-devflow",
3
- "version": "2.17.2",
3
+ "version": "2.17.3",
4
4
  "description": "Installer and workflow manager for Nexus-DevFlow agentic workflow layer.",
5
5
  "license": "MIT",
6
6
  "author": "Jakkrich",
package/template/devflow/build-plan.md CHANGED
@@ -1,295 +1,45 @@
1
- # 📋 Build Plan (User-Owned Feature Queue)
1
+ # Build Plan
2
2
 
3
- > **Document Type**: Build Plan (User-Owned)
4
- > **Purpose**: รายการคิวฟีเจอร์การพัฒนาปรับปรุงระบบตามลำดับ พร้อมการประเมินขนาด (Sizing) และความสัมพันธ์ (Dependencies) สำหรับ `/brief` และ `/feature`
3
+ > **Document Type**: Build Plan (User-Owned)
4
+ > **Purpose**: รายการฟีเจอร์ตามลำดับการพัฒนาจริง (Ordered Feature Roadmap Checklist)
5
+ > **Workflow**: ใช้เครื่องหมาย Checkbox `- [ ]` เรียงลำดับ 1, 2, 3... เพื่อให้ `/feature` ดึงไปทำทีละงาน
5
6
 
6
7
  ---
7
8
 
8
- ## 🚀 Phase 1: Hard Quality Gates & Pre-commit Enforcement
9
+ ## 🚀 Phase 1: Core Foundation & Data Layer
9
10
 
10
- - [x] **1. Automated Quality Gatekeeper & Pre-commit Hook Integration** `[Size: S]`
11
- - *Dependencies*: None
12
- - *Scope*: ผสาน `nexus-devflow check-gate` เข้าสู่ Git Pre-commit Hooks และ CI เพื่อบล็อกการ Commit/Merge เมื่อมี Unchecked Tasks, Test ล้มเหลว หรือมี P0/P1 Finding ค้างอยู่
11
+ - [ ] 1. **Core Schema & Data Models** - สร้าง Data Models, Schemas (Zod) และ Database Migrations เบื้องต้น
12
+ - [ ] 2. **Base Layout & Main UI Shell** - วางโครงสร้างหน้าจอหลัก, Navigation Shell และ Design Tokens
13
+ - [ ] 3. **Primary Feature Flow** - พัฒนาฟังก์ชันการทำงานหลัก พร้อม Input Form และ Validation
13
14
 
14
15
  ---
15
16
 
16
- ## ⚡ Phase 2: DevFlow Model Context Protocol (MCP) Server Hub
17
+ ## ⚡ Phase 2: Interactivity & Core Capabilities
17
18
 
18
- - [x] **2. DevFlow MCP Server Hub & Type-Safe Schema Engine (`IDEA-004`)** `[Size: M]`
19
- - *Dependencies*: Feature 1
20
- - *Scope*: สร้าง Subcommand `nexus-devflow mcp` เปิด JSON-RPC Server พร้อมเครื่องมือ Typed Tools (`update_task`, `record_finding`, `get_stage_context`) ด้วย Zod Schema Validation
19
+ - [ ] 4. **Live Preview / Action Pipeline** - เชื่อมต่อ Input เข้าสู่ระบบประมวลผลและการแสดงผลแบบ Real-time
20
+ - [ ] 5. **Export / Output Engine** - พัฒนาระบบส่งออกข้อมูล เช่น Image Generation, PDF Download หรือ API Response
21
+ - [ ] 6. **Local Persistence & Settings** - บันทึกการตั้งค่าและประวัติการใช้งานลงใน Local Storage หรือ Database
22
+ - [ ] 6a. **Settings Panel** - UI สำหรับปรับแต่งค่าและการจัดเก็บ State
23
+ - [ ] 6b. **History & Recall** - แสดงรายการประวัติย้อนหลังและปุ่มเรียกข้อมูลกลับมาใช้
21
24
 
22
25
  ---
23
26
 
24
- ## 🌿 Phase 3: Branch-Scoped Context Isolation
27
+ ## 🚢 Phase 3: Polish, Quality & Production Hardening
25
28
 
26
- - [x] **3. Branch-Scoped Context Isolation & Dynamic Router** `[Size: M]`
27
- - *Dependencies*: Feature 2
28
- - *Scope*: แยกจัดเก็บ State ตาม Git Branch ใน `.nexus/branches/<branch-name>/`, ระบบ Canonical Dynamic Router สำหรับ AI Agent และระบบ Auto-Cleanup หลัง `/complete`
29
+ - [ ] 7. **Edge Cases & Input Polish** - จัดการ Loading States, Error Boundaries และ Responsive Layout
30
+ - [ ] 8. **Deployment Readiness & Production Verification** - ตั้งค่า Environment Config, ตรวจสอบ Production Build และ Health Check
29
31
 
30
32
  ---
31
33
 
32
- ## ✂️ Phase 4: JIT Context Slicing & Token Optimizer
34
+ ## 🛠️ Architecture & Deployment Notes (Optional)
33
35
 
34
- - [x] **4. Just-In-Time (JIT) Dynamic Context Slicing Engine** `[Size: M]`
35
- - *Dependencies*: Feature 3
36
- - *Scope*: สร้างตัวตัดตอนบริบท (Context Slicer) สำหรับสคิล `/implement`, `/check`, `/discovery` เพื่อส่งเฉพาะข้อมูลที่จำเป็นและควบคุม Token Budget ลดการใช้ Token 60–70%
36
+ - **Key Technical Decisions**:
37
+ - [บันทึกการตัดสินใจทางเทคนิคที่สำคัญ]
38
+ - **Environment & Hosting Constraints**:
39
+ - [ข้อกำหนดด้านสภาพแวดล้อมและการ Deploy]
37
40
 
38
41
  ---
39
42
 
40
- ## 🔄 Phase 5: State Drift Detection & Self-Healing
41
-
42
- - [x] **5. Git Diff Drift Reconciler & Self-Healing State Engine** `[Size: M]`
43
- - *Dependencies*: Feature 4
44
- - *Scope*: ตรวจจับความไม่สอดคล้องระหว่าง `git diff` กับรายการไฟล์ใน Living Spec พร้อมระบบแจ้งเตือนและ Auto-Reconcile ซิงค์สถานะอัตโนมัติ
45
-
46
- ---
47
-
48
- ## 🖥️ Phase 6: IDE Native Extension & Visual Studio
49
-
50
- - [x] **6. IDE Native Extension & Interactive Webview Studio** `[Size: L]`
51
- - *Dependencies*: Feature 5
52
- - *Scope*: พัฒนา Extension สำหรับ VS Code / Antigravity Webview เพื่อแสดง Live Kanban Board, ปุ่มกดรันคำสั่ง DevFlow และ Diff Inspector ในตัว IDE
53
-
54
-
55
- ---
56
-
57
- ## 🤖 Phase 7: Multi-Agent Swarm Orchestration & Code Graph RAG
58
-
59
- - [x] **7. Multi-Agent Swarm Orchestrator & Semantic Code Graph RAG** `[Size: L]`
60
- - *Dependencies*: Feature 6
61
- - *Scope*: พัฒนาระบบกระจายงานแบบคู่ขนานให้ Subagents (Coder, QA Verifier, Security Auditor) และระบบ Indexing Local Codebase Graph เพื่อดึงบริบทที่แม่นยำสูงสุด
62
-
63
- ---
64
-
65
- ## 🔄 Phase 8: Upstream Synchronization & Multi-Adapter Expansion
66
-
67
- - [x] **8. Sync Upstream v0.13.0 (Adopt Visibility, OpenCode & Multi-Adapter Selection)** `[Size: M]`
68
- - *Dependencies*: None
69
- - *Scope*: ผสานความสามารถ Adopt Workflow Visibility (Commit vs Local-only), การรองรับ OpenCode และ Multi-Adapter Checkbox Prompt ใน CLI พร้อมอัปเดต Doctor checks และซิงก์ Baseline SHA เป็น v0.13.0 (`0b65166`)
70
-
71
- ---
72
-
73
- ## 🧪 Phase 9: Strict TDD Sub-Tasks & Two-Stage Review Guardrails
74
-
75
- - [x] **9. Strict TDD Sub-Tasks & Two-Stage Review Guardrails** `[Size: M]`
76
- - *Dependencies*: None
77
- - *Scope*: นำ Strict TDD (Red-Green-Refactor) Sub-Tasks และ Two-Stage Review Pattern (Stage 1: Spec Fidelity, Stage 2: Quality & Security Gate) ผสานเข้าสู่ Prompt Rules, Coding Standards, AI Interaction และ Stage Skills (`30-plan`, `40-execute`, `50-verify`, `feature`, `implement`, `check`, `debug`) พร้อมอัปเดต Template และ Unit Tests
78
-
79
- ---
80
-
81
- ## ⚡ Phase 10: Nexus-DevFlow 2.5.0 (Unified Living Spec Model)
82
-
83
- - [x] **10. Unify Deep-Track and Fast-Track into Single Living Spec Model** `[Size: L]`
84
- - *Dependencies*: ADR-001
85
- - *Scope*: รวมความสามารถเชิงสถาปัตยกรรมระดับลึกของ Deep-Track เข้าสู่ 4 ขั้นตอนหลักของ Fast-Track บนเอกสาร Single Living Spec (`current-feature.md`) จัดเก็บประวัติแบบ Single Archive (`.md`), ปลดระวาง stage skills 10-70 ที่ซ้ำซ้อน, และปรับปรุงเอกสาร & Schemas ทั้งหมด
86
-
87
- ---
88
-
89
- ## 🚀 Phase 11: Multi-Run Context Architecture & Spec Queue Engine
90
-
91
- - [x] **11. Multi-Run Context Architecture & Spec Queue Engine (`IDEA-026`, `DISC-20260826-001`)** `[Size: M]`
92
- - *Dependencies*: Feature 10, Feature 3
93
- - *Scope*: แยกจัดเก็บ Task-Specific Context เป็นโฟลเดอร์ย่อยใน `devflow/context/{xxx-slug}/`, พัฒนา Context Resolver สำหรับสลับและเรียกใช้งาน `/implement <id>`, `/check <id>`, `/complete <id>` แบบระบุ Running ID หรือ Fuzzy Match, และอัปเกรด CLI/Dashboard/Skills ให้รองรับ Spec Queue หลายรันพร้อมกัน
94
-
95
- ---
96
-
97
- ## 🧹 Phase 12: Purge Legacy Deep-Track & Numbered Stage Artifacts
98
-
99
- - [x] **12. Purge Legacy Deep-Track & Numbered Stage Artifacts (`DISC-20260826-002`)** `[Size: M]`
100
- - *Dependencies*: Feature 10, Feature 11
101
- - *Scope*: ล้างโค้ดตกค้างของ Deep-Track (สเตจ 00-70 เช่น `40-execute`, `50-verify`, `60-report`, `70-deliver`, `10-define`, `20-spec`, `30-plan`) ออกจาก package engine (`status.ts`, `current-work.ts`, `history.ts`), agent skills (`.agents/`, `.claude/`), automation scripts & tests ใน `scripts/`, และเอกสาร/mockup ให้เป็นปัจจุบันสมบูรณ์
102
-
103
- ---
104
-
105
- ## 🔄 Phase 13: Upstream AI Blueprint v0.14.0 Synchronization & Deterministic Config Engine
106
-
107
- - [x] **13. Sync Upstream v0.14.0 (Deterministic Config & Continuous Mode)** `[Size: M]`
108
- - *Dependencies*: Feature 12, DISC-20260826-003
109
- - *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
110
-
111
- ---
112
-
113
- ## ⚡ Phase 14: Pure Multi-Run Task-Isolated Architecture
114
-
115
- - [x] **14. Pure Multi-Run Task-Isolated Architecture (`DISC-20260826-004`)** `[Size: M]`
116
- - *Dependencies*: Feature 11, Feature 12, Feature 13
117
- - *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 ทั้งหมด
118
-
119
- ---
120
-
121
- ## 🔄 Phase 15: Upstream AI Blueprint v1.0.0 / v1.0.1 Synchronization
122
-
123
- - [x] **15. Sync Upstream v1.0.0 (Activity Contract, Rollback & Complete Safeguards, Local Linking)** `[Size: M]`
124
- - *Dependencies*: Feature 14, DISC-20260828-001-sync-upstream-ai-blueprint-v100
125
- - *Scope*: ผสาน Activity State Contract (`devflow/.state/run.json`) และ Live Dashboard Activity, เสริม Rollback 40-char SHA & Merge Commit Protection, Complete Fixed Finding Persistence, คำสั่ง `npm run link:local` / `unlink:local` พร้อม `findPackageRoot()`, Onboarding Markers และ Windows Smoke/Path Fixes
126
-
127
- ---
128
-
129
- ## 🖥️ Phase 16: Multi-Task Dashboard & Live Kanban Studio UI
130
-
131
- - [x] **16. Multi-Task Dashboard & Live Kanban Studio UI (`DISC-20260828-002`)** `[Size: M]`
132
- - *Dependencies*: Feature 14, Feature 15
133
- - *Scope*: ปรับปรุง Full Web Dashboard (`dashboard-page.ts`) และ Live Kanban Studio (`webview-studio.ts`) ให้อ่านและวนลูปแสดงผลรายการ Task ทั้งหมดใน `status.activeRuns` จาก `devflow/context/{xxx-slug}/` พร้อม Task Progress Bar, Branch Pill, Findings Indicator และปุ่ม Quick Actions แบบเจาะจง Target Run ID
134
-
135
- ---
136
-
137
- ## 🔌 Phase 17: Unified Third-Party Skills Installer & Updater
138
-
139
- - [x] **17. Unified Third-Party Skills Installation & Update Command (`DISC-20260831-001`, `055-unified-third-party-skills-installer`)** `[Size: S]`
140
- - *Dependencies*: None
141
- - *Scope*: เพิ่มฟังก์ชัน `installRecommendedSkills` และ `updateRecommendedSkills` ใน `skill-manager.ts`, รองรับสวิตช์ `--recommended` ในคำสั่ง `nexus-devflow skill add` และ `nexus-devflow skill update`, พร้อมอัปเดตเอกสาร `README.md`, `README.th.md` และ Automated Tests
142
-
143
- ---
144
-
145
- ## 🔄 Phase 18: Upstream AI Blueprint v1.1.0 & v1.2.0 Synchronization
146
-
147
- - [x] **18. Sync Upstream v1.1.0 & v1.2.0 (Browser Tests & Independent Review System) (`DISC-20260901-001`)** `[Size: M]`
148
- - *Dependencies*: None
149
- - *Scope*: ผสานสคิล `/browser-tests` สำหรับ Playwright/E2E testing, ระบบตรวจทานอิสระ Independent Audit Review (`audit independent current` พร้อม `review.ts` และ `review.md`), อัปเกรด Config Quality Gates (`independentReview`), อัปเดต CLI Engine/Dashboard และปรับปรุงคู่มือ Scaffolding
150
-
151
- ---
152
-
153
- ## 🛡️ Phase 19: BugHunter Master Skill & Upstream Knowledge Sync Engine
154
-
155
- - [x] **19. BugHunter Master Skill & Upstream Knowledge Sync Engine (`DISC-20260901-002`, `065-bughunter-master-skill-and-sync-engine`)** `[Size: M]`
156
- - *Dependencies*: Feature 17, Feature 18
157
- - *Scope*: พัฒนา Master Orchestrator Skill `bughunter` พร้อมระบบ Sync ดึงคลังความรู้ 83 skills และ report patterns จาก `elementalsouls/Claude-BugHunter` เก็บใน `devflow/.vendor/bughunter/`, รองรับคำสั่ง `nexus-devflow skill add/update bughunter`, อัปเดต Manifest และผสานเข้ากับ Multi-Adapter (`.agents/`, `.claude/`)
158
-
159
- ---
160
-
161
- ## 🔄 Phase 20: Upstream AI Blueprint v1.3.0 – v1.4.1 Synchronization
162
-
163
- - [x] **20. Sync Upstream v1.3.0 – v1.4.1 (Planning Baseline Commit & Context Overhead Reduction) (`DISC-20260902-002`, `067-sync-upstream-ai-blueprint-v130-v141`)** `[Size: M]`
164
- - *Dependencies*: Feature 18, DISC-20260902-002
165
- - *Scope*: ผสานสคิล Planning Baseline Commit ใน `/overview` (`chore: establish DevFlow project baseline`), กฎ Overview Compactness Budget (20KB) พร้อม Hard-stop ใน `/feature` และคำเตือนใน `/doctor`, ปรับ Workflow Defaults เป็น `stepReview: "feature"` และ `checkpointCommits: "disabled"` พร้อม Onboarding Presets (Efficient/Guided/Custom), ย่อ Skill Descriptions 31 สคิลให้ <= 400 chars, ปรับ Claude Code Startup Context ใน `CLAUDE.md`, และอัปเดต Framework Validation/Tests ผ่าน 100%
166
-
167
- ---
168
-
169
- ## 🛠️ Phase 21: Upstream Tooling Parity & Comprehensive Evals Suite
170
-
171
- - [x] **21. Upstream Tooling Parity & Comprehensive Evals Suite (E2E Agent Harness, Complete Routing Fixtures, Sandbox Automation & Upstream Drift Monitor) (`DISC-20260902-001`, `068-sync-upstream-ai-blueprint-tooling-and-evals`)** `[Size: M]`
172
- - *Dependencies*: Feature 20, DISC-20260902-001
173
- - *Scope*: ขยายชุดทดสอบ Evals Routing ให้ครอบคลุมทุกสคิล (`browser-tests.json`, `continuous.json`, `bughunter.json`, `publish-devflow.json`), นำเข้าและปรับใช้ Live-Agent E2E Test Harness (`scripts/e2e/`), สคริปต์จำลองติดตั้ง Sandbox Scaffolding (`scripts/scaffold-sandbox.ts`), สคริปต์ตรวจจับ Upstream Drift (`scripts/check-upstream-drift.ts`), และเอกสารวิเคราะห์ Token Efficiency (`benchmarks/context-efficiency.md`)
174
-
175
- ---
176
-
177
- ## 🎨 Phase 22: Visual Dashboard & Diagram Integration
178
-
179
- - [x] **22. Standalone HTML Report Diagram Integration (`DISC-20260902-003`, `069-report-html-diagram-integration`)** `[Size: S]`
180
- - *Dependencies*: Feature 17 (`055`), DISC-20260902-003
181
- - *Scope*: ปรับปรุง `md2html-report.mjs` รองรับการเรนเดอร์ native Mermaid block (`.mermaid`), เพิ่มการสแกนและ embed ไฟล์ไดอะแกรมจาก `devflow/context/{xxx-slug}/diagrams/` (`.svg` และ `.html`), อัปเดต `report-html` skill ให้ตรวจจับและ auto-install `archify` / `diagram-design` ผ่าน `nexus-devflow skill add` และเขียนชุดทดสอบครอบคลุม
182
-
183
- ---
184
-
185
- ## 🧹 Phase 23: Reference Artifacts Housekeeping
186
-
187
- - [x] **23. Prune Studio Reference Artifacts (`069-prune-studio-reference-artifacts`)** `[Size: S]`
188
- - *Dependencies*: None
189
- - *Scope*: ลบไฟล์ Static HTML Snapshot ตกค้าง `devflow/reference/studio.html` และสคริปต์ `scripts/export-studio.ts` โดยยังคงรักษา Webview Studio Engine (`webview-studio.ts`), MCP tool (`devflow_get_studio_html`), CLI Command (`nexus-devflow studio`) และชุดทดสอบทั้งหมดให้ทำงานได้สมบูรณ์ 100%
190
-
191
- ---
192
-
193
- ## 📐 Phase 24: Role-Based Profiles & SA Command Suite Engine
194
-
195
- - [x] **24. Role-Based Profiles & SA Analyze Command Engine (`DISC-20260903-001`, `070-role-based-profile-and-sa-analyze-engine`)** `[Size: M]`
196
- - *Dependencies*: None
197
- - *Scope*: เพิ่มตัวเลือก `--role [sa|dev|full]` ใน CLI Installer (`create-nexus-devflow`), ระบบจำแนกชุด Skill Profiles ใน `skill-manager.ts`, โฟลเดอร์ Template สำหรับ SA (`devflow/inbox/`, `devflow/analysis/`, `devflow/blueprints/`), พัฒนาสคิล `/analyze` สำหรับสกัดเอกสารหลายรูปแบบ (PDF, Word, Excel, รูปภาพ, ข้อความ) และวิเคราะห์ Codebase Impact พร้อมชุดทดสอบ Automated Tests
198
-
199
- ---
200
-
201
- ## 🔄 Phase 25: Upstream AI Blueprint v1.5.0 – v1.5.1 Synchronization
202
-
203
- - [x] **25. Sync Upstream v1.5.0 & v1.5.1 (Hardened Run-State Engine & On-Demand Context Loading) (`DISC-20260903-001`, `070-sync-upstream-ai-blueprint-v150-v151`)** `[Size: M]`
204
- - *Dependencies*: Feature 20, Feature 21, DISC-20260903-001
205
- - *Scope*: พอร์ตและปรับแต่ง Hardened Dashboard Activity State Helper (`.agents/skills/doctor/scripts/run-state.mjs` และ `.claude/`), บังคับใช้ Zero-Manual Writes กับ `devflow/.state/run.json`, ปรับใช้ On-Demand Context Loading Protocol พร้อมแยก Reference Templates ย่อย (`reference/`), เพิ่ม Unit Tests `run-state-helper.test.ts`, อัปเดต `scripts/validate-framework.ts`, `AGENTS.md`, `CLAUDE.md` และยืนยันการผ่าน 100%
206
-
207
- ---
208
-
209
- ## 🔄 Phase 26: Upstream AI Blueprint v1.5.2 Synchronization
210
-
211
- - [x] **26. Sync Upstream v1.5.2 (Unborn Repository Onboarding & Branch Baseline Finalization) (`REQ-20260903-001`, `071-sync-upstream-ai-blueprint-v152`)** `[Size: S]`
212
- - *Dependencies*: Feature 25, REQ-20260903-001
213
- - *Scope*: เพิ่มการตรวจจับและกู้คืน Unborn Git repository ใน `/onboard` ด้วย Scaffold Initial Commit (`chore: scaffold application`), รองรับการ Finalize DevFlow Baseline บน Dedicated Setup Branch ด้วย `git merge --ff-only` ใน `/overview`, เพิ่มชุดทดสอบ E2E Scenario `scripts/e2e/scenarios/unborn-onboarding.ts`, อัปเดต `devflow/context/ai-interaction.md` และอัปเดต Framework Static Contracts ผ่าน 100%
214
-
215
- ---
216
-
217
- ## 🔄 Phase 27: Upstream AI Blueprint v1.5.3 Synchronization
218
-
219
- - [x] **27. Sync Upstream v1.5.3 (Manifest-Aware Adapter Selection in Onboard & E2E Scenario Parity) (`REQ-20260904-001`, `072-sync-upstream-ai-blueprint-v153`)** `[Size: S]`
220
- - *Dependencies*: Feature 26, REQ-20260904-001
221
- - *Scope*: ปรับปรุง `/onboard` (ทั้ง `.agents/` และ `.claude/`) ให้อ่านและยึดถือรายการ `adapters` จาก Manifest (`.nexus/nexus-devflow.json` / `devflow/.state/manifest.json`) เป็นความจริงหลัก (Authoritative Selection) โดยไม่ถามซ้ำและไม่อนุมานผิดพลาด, เพิ่มชุดทดสอบ E2E Scenario ตัวที่ 10 `scripts/e2e/scenarios/adapter-selection.ts`, อัปเดต `agent-bundle.manifest.json` และ `scripts/validate-framework.ts` ให้ครอบคลุม Verification Contracts ใหม่ 100%
222
-
223
- ---
224
-
225
- ## 🔄 Phase 28: Upstream AI Blueprint v1.5.4 – v1.6.0 Synchronization
226
-
227
- - [x] **28. Sync Upstream v1.5.4 & v1.6.0 (Automatic Independent Review, Post-Implementation Walkthroughs & Hardened Dashboard Engine) (`DISC-20260907-001`, `073-sync-upstream-ai-blueprint-v154-v160`)** `[Size: M]`
228
- - *Dependencies*: Feature 27, DISC-20260907-001
229
- - *Scope*: นำเข้าระบบตรวจทานอิสระแบบอัตโนมัติ (`review.independentExecution: "automatic"` พร้อม Isolated Subagent Spawning, Receipts Metadata Schema), ปรับค่าเริ่มต้น Quality Gates เป็น `when-sensitive`, เพิ่ม Post-Implementation Code Walkthrough ใน `implement` / `autopilot`, ปรับปรุงความทนทานของสถานะโครงการและ Dashboard (Sortable Findings, Roadmap Focus, Strict Heading Contracts), อัปเดต Framework Validation และ Unit Tests ผ่าน 100%
230
-
231
- ---
232
-
233
- ## 🖥️ Phase 30: Modernize Web Dashboard with Dynamic Archify Visualizer & Recommended Skills
234
-
235
- - [x] **30. Modernize Web Dashboard with Dynamic Archify Visualizer & Recommended Skills (`DISC-20260907-003`, `080-dashboard-workflow-visualizer`)** `[Size: M]`
236
- - *Dependencies*: Feature 28, DISC-20260907-003
237
- - *Scope*: เพิ่ม Dynamic Archify SVG Workflow Visualizer (Macro Lifecycle Pulse Map พร้อม CSS Trace Motion และ Micro Tracer-Bullet Tickets DAG), เพิ่มการ์ด Recommended Skills & Vendors (`matt-pocock`, `bughunter`, `archify`, `diagram-design`, `9arm-skills`) พร้อมตรวจจับสถานะติดตั้งจริงและแสดงป้ายติ๊กถูก ✔, ปรับลดความรกบนแดชบอร์ด (ลบ Swarm Tab, ยุบ Doctor สรุปคลีน), เพิ่มข้อมูลใน `DashboardSnapshot` และชุดทดสอบความถูกต้องผ่าน 100%
238
- ---
239
-
240
- ## 🧹 Phase 31: Vendor Purge, Unified Debug & Headless Ticket Ingestion
241
-
242
- - [x] **31. Purge Matt Pocock Vendor, Unify Debug Skill & Headless Ticket Ingestion (`081-purge-vendor-and-unify-debug`)** `[Size: S]`
243
- - *Dependencies*: None
244
- - *Scope*: ตัดโฟลเดอร์ vendor `devflow/.vendor/matt-pocock/`, ลบ skill wrapper ของ `matt-pocock` และ `debug-mantra`, รวมสาระสำคัญของ mantra 4 ข้อเข้าสู่ `/debug` (ทั้ง `.agents` และ `.claude`), ลบโฟลเดอร์ตกค้าง `.scratch/` และ `docs/agents/`, อัปเดต `AGENTS.md` และเอกสารเพื่อรองรับการนำเข้า external spec และ tickets จาก `devflow/context/{slug}/issues/` หรือ `tickets/` ได้ทันที
245
-
246
- ---
247
-
248
- ## 🧹 Phase 32: Consolidate 9arm Skills into DevFlow Core & Purge Extension
249
-
250
- - [x] **32. Consolidate 9arm Skills into DevFlow Core & Purge Extension (`DISC-20260908-001`, `082-consolidate-9arm-skills-and-purge`)** `[Size: S]`
251
- - *Dependencies*: None
252
- - *Scope*: รวมสาระสำคัญของ `scrutinize` (Outsider Stance, Call-path tracing, Challenge intent) เข้าสู่ `/audit`, ผสาน `post-mortem` เข้าสู่ `/debug` (Phase 4 Handoff) และ `/complete` (Fix Archive Template), เพิ่ม Executive / Stakeholder Summary ใน `/status` และ `/complete`, ลบโฟลเดอร์ extension `post-mortem`, `scrutinize`, `management-talk` ทั้งใน `.agents/` และ `.claude/`, ลบ entries 9arm-skills ออกจาก `.nexus/nexus-devflow.json`, อัปเดตเอกสารและยืนยัน static contracts ผ่าน 100%
253
-
254
- ---
255
-
256
- ## 🪓 Phase 33: Ponytail Hybrid Compound-Vendor Integration
257
-
258
- - [x] **33. Ponytail Hybrid Compound-Vendor Integration (`DISC-20260909-001`)** `[Size: S]`
259
- - *Dependencies*: Feature 17 (`055`), Feature 19 (`065`), DISC-20260909-001
260
- - *Scope*: นำเข้า `DietrichGebert/ponytail` ในรูปแบบ Hybrid Compound-Vendor (`type: "compound-knowledge"`) โดยโคลน upstream ลง `devflow/.vendor/ponytail/`, สร้าง Master Wrapper Skill (`.agents/skills/ponytail/` และ `.claude/`) พร้อม 5W1H Playbook และ Auto-Bypass สำหรับงาน Frontend/UI, อัปเดต `skill-registry-engine.ts`, บันทึก `thirdPartySkills` ใน `.nexus/nexus-devflow.json` และเขียน Automated Tests ครอบคลุม
261
-
262
- ---
263
-
264
- ## 📦 Phase 34: Unscoped CLI Packages & Shorthand Shims (`npx nexus-devflow` & `npm create nexus-devflow`)
265
-
266
- - [x] **34. Unscoped CLI Packages & Shorthand Shims (`nexus-devflow` & `create-nexus-devflow`) (`084-unscoped-nexus-devflow-cli-package`)** `[Size: S]`
267
- - *Dependencies*: Feature 1 (`check-gate`), Feature 17 (`055`)
268
- - *Scope*: สร้างและกำหนดค่า Wrapper Shims สำหรับ Unscoped NPM Packages: `nexus-devflow` (เพื่อรองรับ `npx nexus-devflow`) และ `create-nexus-devflow` (เพื่อรองรับ `npm create nexus-devflow`), อัปเดต Pipeline การ Publish ใน `.github/workflows/publish.yml` และ `publish-devflow` ให้ซิงก์เวอร์ชันและเผยแพร่คู่ขนานกับ `@jakkrichm/create-nexus-devflow`, อัปเดตเอกสาร `AGENTS.md`, `CLAUDE.md` และ README ให้แนะนำคำสั่งสั้นเป็นหลัก
269
-
270
-
271
-
272
- ---
273
-
274
- ## Phase 35: Superpowers Debugging & TDD Heuristics Integration
275
-
276
- - [x] **35. Superpowers Debugging Heuristics & TDD Reference Guides (`DISC-20260909-003`, `085-superpowers-debugging-heuristics-integration`)** `[Size: S]`
277
- - *Dependencies*: Feature 31 (`081`), Feature 32 (`082`)
278
- - *Scope*: เพิ่ม JIT reference guides สำหรับ root-cause tracing, defense-in-depth, condition-based waiting, TDD anti-patterns และ two-stage review พร้อม 3-Strike Rule และ Iron Law; ซิงก์ `.agents/` กับ `.claude/` และตรวจ file contracts
279
-
280
- ---
281
-
282
- ## Phase 36: Upstream AI Blueprint v1.6.1 Synchronization
283
-
284
- - [x] **36. Sync Upstream v1.6.1 (Installer Symlink Rejection, Completion Recovery Engine, Rebuild History Preservation, Local-Only Spec Review & Status Evidence Alignment) (`DISC-20260911-001`, `086-sync-upstream-ai-blueprint-v161`)** `[Size: M]`
285
- - *Dependencies*: Feature 28 (`073`), DISC-20260911-001
286
- - *Scope*: นำเข้า 5 เสาหลักความปลอดภัยและความแม่นยำจาก AI Blueprint v1.6.1: (1) ปฏิเสธ Symlink paths และตรวจ type compatibility ในตัวติดตั้ง `create-nexus-devflow`, (2) สร้างสัญญา `completion-recovery.md` พร้อม JSON comment annotation `<!-- devflow:completion ... -->` กู้คืนการส่งมอบงานที่สะดุด, (3) สร้างสัญญา `build-history.md` รองรับการตั้งชื่อ `--build-N` เมื่อ Rebuild ฟีเจอร์ที่เคยถูก Rollback, (4) ขยาย `lib/review.ts` ให้รองรับ `specSnapshot` สำหรับ Local-only spec review, (5) บูรณาการ `classifyWorkEvidence` ใน `project-status-engine.ts` และ `dashboard.ts` ป้องกัน False Ready State เมื่อ verification failed หรือพบ malformed records, (6) ซิงก์สคิลและเอกสารทั้ง `.agents/` และ `.claude/` พร้อม automated tests ผ่าน 100%
287
-
288
- ---
289
-
290
- ## 🔌 Phase 37: AI-Orchestrated Project-Local Vendor Skill Ingestion (`/vendor`)
291
-
292
- - [x] **37. AI-Orchestrated Project-Local Vendor Skill Ingestion (`DISC-20260911-002`, `087-ai-orchestrated-vendor-skill-ingestion`)** `[Size: M]`
293
- - *Dependencies*: Feature 33 (`083`), Feature 34 (`084`), DISC-20260911-002
294
- - *Scope*: พัฒนาคำสั่ง `/vendor` (พร้อม aliases: `skill-add`, `equip`, `ingest`) สำหรับนำเข้า Git repository ลงในระดับโปรเจกต์ `devflow/.vendor/<slug>/`, ให้ AI Agent สำรวจโค้ดและสังเคราะห์ Custom Wrapper Skill ใน `.agents/skills/<slug>/SKILL.md` และ `.claude/skills/<slug>/SKILL.md`, พัฒนากลไก Update Protection ใน `update.ts` เพื่อป้องกันไม่ให้คำสั่งอัปเดต DevFlow ลบ custom skills เหล่านี้, บันทึก metadata ลง `.nexus/nexus-devflow.json`, ปรับปรุง CLI `nexus-devflow skill update all` ให้รองรับการ pull upstream ใน `.vendor/` โดยคงรักษา custom wrapper ที่ AI เขียนไว้, พร้อมเขียน Automated Unit Tests ครอบคลุม 100%
43
+ ## 🔮 Later / Post-MVP Backlog (Not in v1)
295
44
 
45
+ - [ ] **Cloud Sync & User Accounts** - ระบบสมัครสมาชิกและซิงค์ข้อมูลบน Cloud
package/template/devflow/project-plan.md CHANGED
@@ -1,79 +1,52 @@
1
- # 🗺️ Project Plan (User-Owned Architectural Vision)
1
+ # Project Plan
2
2
 
3
- > **Document Type**: Project Plan (User-Owned)
4
- > **Purpose**: แหล่งความจริงหลัก (Single Source of Truth) สำหรับวิสัยทัศน์ผลิตภัณฑ์ สถาปัตยกรรมระบบ มาตรการความปลอดภัย กฎเกณฑ์การส่งมอบ และแผนงานพัฒนาต่อยอด ถูกนำไปประมวลผลเป็น `devflow/context/project-overview.md` ผ่านคำสั่ง `/overview`
3
+ > **Document Type**: Project Plan (User-Owned)
4
+ > **Purpose**: แหล่งความจริงหลัก (Single Source of Truth) สำหรับวิสัยทัศน์ผลิตภัณฑ์ สถาปัตยกรรมระบบ ขอบเขตการทำงาน และข้อกำหนดทางเทคนิค
5
+ > **Workflow**: กรอกข้อมูลให้ครบถ้วนแล้วรัน `/overview` เพื่อประมวลผลเป็น `project-overview.md`
5
6
 
6
7
  ---
7
8
 
8
- ## 1. Product Vision & Problem Statement
9
+ ## 1. Problem - What problem are we solving?
9
10
 
10
- - **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) เพื่อยกระดับการพัฒนาซอฟต์แวร์สู่มาตรฐานระดับวิศวกรรมสากล
11
- - **Target Audience**:
12
- - นักพัฒนาเดี่ยว (Solo Developers) ที่ต้องการความเร็วสูงแต่ยังคงมีระเบียบวินัยและหลักฐานการทดสอบที่ชัดเจน
13
- - ทีมพัฒนาและองค์กร (Engineering Teams & Tech Leads) ที่ต้องการมาตรฐานการส่งมอบโค้ดที่ตรวจสอบได้ (Traceable), ตรวจสอบย้อนหลังได้ (Auditable) และไม่มีปัญหาโค้ดตีกัน (Zero Merge Conflict)
14
- - **Core Value Proposition**:
15
- - **The 3-Pillars Model**: จัดระเบียบบริบทเป็น 3 เสาหลักอย่างชัดเจน — *🔮 Future (Inbox `ideas.md`)* ➔ *⚡ Present (Living Context `devflow/context/`)* ➔ *📦 Past (Categorized History `devflow/history/`)*
16
- - **Single Living Spec Delivery Model**: งานทุกขนาดใช้วงจรเดียว `/feature` (หรือ `/fix`) ➔ `/implement` ➔ `/check` ➔ `/complete` โดยเพิ่มความลึกของสเปกและหลักฐานตามความซับซ้อนของงาน
17
- - **Hard Quality Gates**: ระบบปฏิเสธการปล่อยงานเมื่อไม่ผ่านเกณฑ์การทดสอบ หรือมีข้อบกพร่องความปลอดภัยค้างอยู่
11
+ - **Core Problem**: [ระบุปัญหาหลักที่ผู้ใช้กำลังเผชิญ]
12
+ - **Main Purpose**: [ระบุเป้าหมายหลักของระบบ]
18
13
 
19
14
  ---
20
15
 
21
- ## 2. Architecture & Tech Stack
22
-
23
- - **Runtime & Language**: Node.js (>=18.17.0), TypeScript (Strict ESM-First `"type": "module"`)
24
- - **Persistence & State**:
25
- - Markdown-First Architecture พร้อม Type-Safe Schema Validation (Zod)
26
- - Git-Backed History Archive (`devflow/history/features/`, `devflow/history/fixes/`, `devflow/history/rollbacks/`, `HISTORY.md`)
27
- - Local State Management & Backup Snapshots (`.nexus/`)
28
- - **Key Modules & Subsystems**:
29
- - **Distribution CLI & Package**: `packages/create-nexus-devflow` (Scaffolding, Doctor, Status, Update, Gatekeeper)
30
- - **Interactive Web Dashboard**: Embedded Local Webview Dashboard (`/dashboard`) พร้อม Living Spec Visualizer และ Real-time Snapshot
31
- - **Gatekeeper Engine**: ระบบตรวจสอบคุณภาพโค้ดและ Finding Blockers (`nexus-devflow check-gate`)
32
- - **Model Context Protocol (MCP) Server**: JSON-RPC Hub สำหรับเชื่อมต่อ AI Agents แบบ Type-Safe
33
- - **Dynamic Context Slicer**: ระบบจัดสรรและตัดตอนบริบทแบบ Just-In-Time (JIT) เพื่อประหยัด Token
34
- - **Integration Points & AI Adapters**:
35
- - Google Antigravity & OpenAI Codex (`.agents/skills/`)
36
- - Claude Code (`.claude/skills/`)
37
- - Model Context Protocol (`@modelcontextprotocol/sdk`)
16
+ ## 2. Users - Who is this for?
17
+
18
+ - **Primary Audience**: [เช่น Solo Developers, Content Creators]
19
+ - **Secondary Audience (Later)**: [เช่น ทีมงานองค์กร, ลูกค้าปลายทาง]
20
+ - **User Personas & Access Tiers**:
21
+ - `Anonymous / Guest`: [สิทธิ์การใช้งานทั่วไป]
22
+ - `Authenticated User`: [สิทธิ์การใช้งานหลัก]
23
+ - `Admin`: [สิทธิ์การจัดการระบบ]
24
+
25
+ ---
26
+
27
+ ## 3. Features - What does v1 need?
28
+
29
+ ### Core MVP Features (v1):
30
+ - **Feature 1**: [คำอธิบายฟีเจอร์]
31
+ - **Feature 2**: [คำอธิบายฟีเจอร์]
32
+ - **Feature 3**: [คำอธิบายฟีเจอร์]
33
+
34
+ ### Later / Post-MVP (Not in v1):
35
+ - [เช่น ระบบสมัครสมาชิกและ Billing]
36
+ - [เช่น การส่งออกข้อมูลปริมาณมาก]
38
37
 
39
38
  ---
40
39
 
41
- ## 3. Constraints, Defensive Guardrails & Non-Goals
42
-
43
- - **5 เสาหลักมาตรการป้องกันความเสี่ยง (Hard Defensive Guardrails)**:
44
- 1. *Hard Quality Gates & Git Hooks*: บล็อกการ Commit ทันทีหาก Spec ไม่ครบ หรือมี `P0/P1 Finding` ค้างอยู่ในสถานะ `open`
45
- 2. *Model Context Protocol (MCP)*: บังคับใช้ Typed Function Calling เพื่อป้องกันความเสียหายจากการ Parse ข้อความ Markdown
46
- 3. *Branch-Scoped Context Isolation*: แยกโฟลเดอร์ State ตาม Git Branch ใน `.nexus/branches/<name>/` ป้องกัน Merge Conflict เมื่อทำงานเป็นทีม
47
- 4. *Dynamic Context Slicing*: ส่งเฉพาะบริบทที่จำเป็นต่อ Stage นั้นๆ เข้าสู่ AI ลด Token Bloat 60–70%
48
- 5. *State Drift Reconciler*: ตรวจจับความไม่สอดคล้องระหว่าง Git Diffs กับ Spec Tasks และเสนอทางเลือก Auto-Sync ทันที
49
- - **Non-Goals**:
50
- - ไม่ใช่ Proprietary IDE หรือ Closed Cloud SaaS — DevFlow เป็น Transparent Git-Native Layer ที่ฝังตัวในโปรเจกต์ใดก็ได้
51
- - ไม่ใช่ Auto-GPT ที่ปล่อยให้ AI เขียนโค้ดตามใจโดยไม่มี Human-in-the-Loop Review Gates
52
- - **Delivery Rules**:
53
- - เคร่งครัดใน TDD Mandate: โค้ดที่เพิ่มหรือแก้ไขต้องมี Automated Unit Tests เสมอ
54
- - ห้ามข้ามขั้นตอน Verification: ต้องมีหลักฐานเชิงประจักษ์ (Empirical Proof) ใน `/check` ก่อนอนุมัติ `/complete`
40
+ ## 4. Data - What are we storing?
41
+
42
+ - **Core Entities**:
43
+ - [Entity 1]: [Attributes & Purpose]
44
+ - [Entity 2]: [Attributes & Purpose]
55
45
 
56
46
  ---
57
47
 
58
- ## 4. Key Milestones & Evolution Roadmap
59
-
60
- - **🚀 Milestone 1: Hard Quality Gates & Pre-commit Enforcement**
61
- - ติดตั้ง `check-gate` เข้าสู่ Git Pre-commit Hooks และ CI Pipeline
62
- - บล็อกการส่งมอบเมื่อมี Unchecked Tasks หรือ P0/P1 Blockers
63
- - **⚡ Milestone 2: DevFlow MCP Server Hub & Type-Safe Schemas (`IDEA-004`)**
64
- - พัฒนา MCP Server ผ่าน JSON-RPC สำหรับ Antigravity, Claude, Codex, Cursor
65
- - ใช้ Zod Schema ควบคุมการอัปเดต Task, Findings, และ Stage State 100% Type-safe
66
- - **🌿 Milestone 3: Branch-Scoped Context Isolation & Dynamic Router**
67
- - รองรับการเก็บ State แยกตาม Git Branch ป้องกัน Merge Conflict ในทีม
68
- - ระบบ Auto-Cleanup ลบ Branch State หลังจบ `/complete` และย้ายเข้าสู่ History
69
- - **✂️ Milestone 4: JIT Context Slicing & Token Budgeting Engine**
70
- - ปรับระบบส่ง Context ให้ AI ตาม Stage แบบไดนามิก ประหยัด Token 70%
71
- - ควบคุมขนาด `project-overview.md` ไม่ให้เกินงบประมาณ Token
72
- - **🔄 Milestone 5: Git Diff Reconciler & Self-Healing State**
73
- - ตรวจจับความคลาดเคลื่อนระหว่างการแก้โค้ดของมนุษย์กับ Living Spec
74
- - ระบบ Smart Reconciliation แจ้งเตือนและซิงค์สเปกอัตโนมัติ
75
- - **🖥️ Milestone 6: IDE Native Extension & Visual Kanban Studio**
76
- - ส่วนขยายบน VS Code / Antigravity Webview สำหรับควบคุม DevFlow ครบวงจรใน IDE
77
- - **🤖 Milestone 7: Multi-Agent Swarm Orchestration & Semantic Code RAG**
78
- - ระบบประสานงาน Subagents หลายตัว (Coder, QA, Auditor) ทำงานขนานกัน
79
- - Local Dependency Graph & Semantic Code Search เพื่อดึงบริบทที่แม่นยำสูงสุด
48
+ ## 5. Technology Stack & Constraints
49
+
50
+ - **Language / Framework**: [เช่น Node.js, TypeScript, Next.js / Express]
51
+ - **Database**: [เช่น SQLite, PostgreSQL]
52
+ - **Hosting / Deployment**: [เช่น Local CLI, Vercel, Render, Docker]
package/template/devflow/runs/.gitkeep ADDED
@@ -0,0 +1 @@
1
+