@jakkrichm/create-nexus-devflow 2.12.1 → 2.12.3

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

@@ -111,6 +111,8 @@ During `/check`:
 ### ⚡ Review Cadence & Implementation Loop
 - **Efficient Default (`stepReview: "feature"`)**: Presents one comprehensive review packet after all implementation steps of the feature complete, with step checkpoint commits disabled (`checkpointCommits: "disabled"`). This minimizes review fatigue and saves context window tokens.
 - **Guided Review (`stepReview: "every"`)**: Available for high-risk changes, pair programming, or instructional sessions. Pauses for user approval after each small step and offers checkpoint commits (`checkpointCommits: "enabled"`).
+- **Post-Implementation Walkthrough**: After the final review packet, `/implement` always offers an optional read-only walkthrough of the finished code, regardless of review cadence or checkpoint settings.
+- **Independent Review Execution**: Regular and Continuous independent review default to `when-sensitive`, while `review.independentExecution` defaults to `automatic` (spawning an isolated reviewer child when the active adapter supports it). Setting `review.independentExecution: "manual"` produces the fresh-session handoff.
 - **Configuration**: Managed directly in `devflow/config.json`.
 
 ---

package/template/devflow/inbox/REQ-20260904-001-sync-upstream-ai-blueprint/clarifications.md

@@ -0,0 +1,28 @@
+# Socratic Gap Detection & Clarification Checklist
+
+> **Request ID**: `REQ-20260904-001-sync-upstream-ai-blueprint`  
+> **Source**: Upstream AI Blueprint Synchronization Analysis
+
+---
+
+## 🔍 Socratic Review & Technical Clarifications
+
+### 1. ตำแหน่งไฟล์ Manifest ใน Nexus-DevFlow
+- **ประเด็น**: ใน Upstream `ai-blueprint` ใช้ไฟล์ `blueprint/.state/manifest.json` เป็นหลัก ขณะที่ Nexus-DevFlow มีทั้ง `.nexus/nexus-devflow.json` (จากตัวติดตั้ง package) และ `devflow/.state/manifest.json`
+- **แนวทาง**: ในคำสั่ง `/onboard` ควรอ้างอิงทั้ง `devflow/.state/manifest.json` และ `.nexus/nexus-devflow.json` โดยให้ความสำคัญกับไฟล์ที่มีอยู่จริง เพื่อความยืดหยุ่นสูงสุด
+
+### 2. รายชื่อเครื่องมือที่รองรับใน DevFlow vs Upstream
+- **ประเด็น**: Upstream รองรับ 4 ตัวหลัก (`codex`, `claude`, `copilot`, `opencode`) ขณะที่ Nexus-DevFlow มี First-Class Support เพิ่มเติมสำหรับ **Google Antigravity** (`antigravity` ซึ่งแชร์โครงสร้าง `.agents/`)
+- **แนวทาง**: ข้อความใน Step 6 ของ Onboard ต้องระบุชื่อเครื่องมือให้ครอบคลุม: "Codex, Antigravity, GitHub Copilot, และ OpenCode"
+
+### 3. สถานะ Version Tagging & Roadmap
+- **ประเด็น**: Upstream ออก release 1.5.3 สำหรับการแก้นี้ สำหรับ Nexus-DevFlow จะจัดเป็น Run `072` มุ่งสู่ Minor/Patch release ถัดไป (v2.12.2)
+- **แนวทาง**: กำหนดหมายเลข Run `072-sync-upstream-ai-blueprint-v153` และบันทึกลงใน Build Plan
+
+---
+
+## ✅ Readiness Checklist for Implementation
+- [x] ตรวจสอบ Diff ละเอียดจาก Upstream ครบถ้วน 100%
+- [x] วิเคราะห์จุดแตกต่างระหว่างสถาปัตยกรรม DevFlow และ AI Blueprint
+- [x] กำหนดขอบเขต E2E Scenario และ Static Contract เรียบร้อย
+- [ ] รอเจ้านายอนุมัติเพื่อเริ่มกระบวนการ `/feature` หรือ `/implement`

package/template/devflow/inbox/REQ-20260904-001-sync-upstream-ai-blueprint/parsed.md

@@ -0,0 +1,59 @@
+# Requirement Specification: ซิงก์ส่วนขยาย Upstream AI Blueprint (v1.5.3 / Latest Commits)
+
+> **Request ID**: `REQ-20260904-001-sync-upstream-ai-blueprint`  
+> **Source**: Upstream Repository `aiblueprinthq/ai-blueprint` (Commits `b4eb32e` .. `2b5f334`)  
+> **Ingested Date**: 2026-09-04  
+> **Target Run ID**: `072` (Feature)  
+> **Language**: Thai (`th`) Default
+
+---
+
+## 📌 Executive Summary
+
+สกัดและวิเคราะห์การเปลี่ยนแปลงล่าสุดจากต้นน้ำ (Upstream `ai-blueprint`) หลังการซิงก์รอบ v1.5.2 (Run `071`) โดยพบการอัปเดตสำคัญระดับสถาปัตยกรรมและกระบวนการ Onboarding ใน commit `b4eb32e` (fix: honor selected adapters) พร้อมทั้งการปรับปรุงเอกสารและ Diagram ใน commit `ed9c19c`, `a231195`, `2b5f334` 
+
+หัวใจหลักของการอัปเดตครั้งนี้คือการทำให้ขั้นตอน `/onboard` มีความฉลาดในการอ่านและยึดถือรายการ Adapter จากไฟล์ Manifest (`.nexus/nexus-devflow.json` หรือ `devflow/.state/manifest.json`) เป็นความจริงหลัก (Authoritative Source of Truth) เพื่อแก้ปัญหาที่ Onboard เคยเดาเอาเองว่าการมีโฟลเดอร์ `.agents/` แปลว่าผู้ใช้เลือกเครื่องมือทุกตัว (Codex, Antigravity, GitHub Copilot, OpenCode) และถามผู้ใช้ซ้ำซ้อน
+
+---
+
+## 👥 Target Personas & User Stories
+
+1. **ผู้ใช้ใหม่ที่ติดตั้ง DevFlow ด้วย Interactive Installer**:
+   - *As a developer* ติดตั้ง DevFlow ด้วยคำสั่ง `npx @jakkrichm/create-nexus-devflow` และเลือกเฉพาะ Claude Code และ Antigravity/Codex
+   - *I want* เมื่อรันคำสั่ง `/onboard` ให้ระบบจำการเลือกของฉันจาก Manifest โดยตรง
+   - *So that* AI จะไม่ถามซ้ำ และไม่ทึกทักไปเองว่าเราเลือก GitHub Copilot หรือ OpenCode เพิ่มขึ้นมา
+
+2. **ผู้ใช้เดิมที่รัน Onboard โดยไม่มี Manifest (Legacy / Manual Copy)**:
+   - *As a developer* ที่คัดลอกไฟล์มาเองหรือไม่มี Manifest
+   - *I want* AI อธิบายชัดเจนว่าโครงสร้าง `.agents/` ใช้ร่วมกันได้หลายเครื่องมือ แล้วถามยืนยันว่าใช้เครื่องมือใดบ้าง
+   - *So that* รายงาน Onboarding ถูกต้องตรงกับสิ่งที่ใช้งานจริง
+
+3. **Core Framework Maintainer**:
+   - *As a maintainer* ของ Nexus-DevFlow
+   - *I want* ระบบ E2E Test มี Scenario ตัวที่ 10 (`adapter-selection.ts`) และ Static Contract Validator ป้องกัน Regression
+   - *So that* ฟีเจอร์ Onboard Manifest Preservation ทำงานถูกต้อง 100% ตามมาตรฐาน Upstream
+
+---
+
+## ⚙️ Functional Requirements (FR)
+
+- **FR-1: Manifest-Aware Adapter Inspection ใน `/onboard` (Step 1)**
+  - เพิ่มการอ่านไฟล์ `devflow/.state/manifest.json` หรือ `.nexus/nexus-devflow.json` ในขั้นตอน Preflight/Inspection เพื่อดึง `adapters` list
+- **FR-2: Authoritative Selection & No Repeated Prompts ใน `/onboard` (Step 6)**
+  - เมื่อพบ Manifest ที่ถูกต้อง ให้ยึด `adapters` ใน Manifest เป็นหลัก ห้ามถามผู้ใช้ซ้ำ
+  - อธิบายว่าการมีอยู่ของ `.agents/` ไม่ได้หมายความว่าเลือกเครื่องมือทุกตัว
+  - หากไม่มี Manifest ให้ถามอย่างชัดเจนโดยไม่เดา
+- **FR-3: Dual-Adapter Contract Synchronicity**
+  - ปรับปรุงเนื้อหาใน `.agents/skills/onboard/SKILL.md` และ `.claude/skills/onboard/SKILL.md` ให้ตรงกัน 100%
+- **FR-4: Automated E2E Scenario Integration**
+  - เพิ่มชุดทดสอบ E2E Scenario `scripts/e2e/scenarios/adapter-selection.ts` ตรวจสอบพฤติกรรม Onboard กับ Manifest
+- **FR-5: Static Verification Guardrails**
+  - อัปเดต `agent-bundle.manifest.json` และ `scripts/validate-framework.ts` ให้ตรวจจับ Contract ใหม่ของ Onboard
+
+---
+
+## 🛡️ Non-Functional Requirements (NFR)
+
+- **Context Budget**: Skill Description และ Instruction ต้องไม่เกินขีดจำกัด Context Budget (< 400 ตัวอักษรต่อคำอธิบาย, ไม่ทำให้ไฟล์เกิน 20KB)
+- **Zero Breaking Change**: รักษาความเข้ากันได้กับโปรเจกต์เดิมที่มีหรือไม่มี Manifest
+- **Cross-Tool Parity**: รองรับ Codex, Antigravity, Claude Code, GitHub Copilot และ OpenCode

package/template/devflow/inbox/REQ-20260904-001-sync-upstream-ai-blueprint/raw/upstream-diff.txt

@@ -0,0 +1,23 @@
+# Upstream AI Blueprint Synchronization Request (v1.5.2 -> v1.5.3 / HEAD)
+
+## Raw Upstream Commits
+- 2b5f334 docs: refresh workflow diagram asset
+- a231195 docs: simplify workflow diagram
+- ed9c19c docs: position AI Blueprint as a workflow framework
+- b4eb32e fix: honor selected adapters
+- 5b46859 fix: handle repositories without an initial commit (synced in 071)
+
+## Core Upstream Changes Diff Stat
+ .agents/skills/onboard/SKILL.md                    |  23 ++++----
+ .claude/skills/onboard/SKILL.md                    |  23 ++++----
+ CHANGELOG.md                                       |  12 +++++
+ README.md                                          |  20 +++----
+ assets/ai-blueprint-workflow-v2.png                | Bin 0 -> 107098 bytes
+ assets/ai-blueprint-workflow.png                   | Bin 216758 -> 0 bytes
+ packages/create-ai-blueprint/README.md             |   5 +-
+ packages/create-ai-blueprint/bin/create-ai-blueprint.ts |   4 +-
+ packages/create-ai-blueprint/package.json          |   2 +-
+ packages/create-ai-blueprint/test/update.test.ts   |   6 +--
+ scripts/e2e/scenarios/adapter-selection.ts         |  59 +++++++++++++++++++++
+ scripts/validate-blueprint.ts                      |   9 +++-
+ 12 files changed, 126 insertions(+), 37 deletions(-)