@jakkrichm/create-nexus-devflow 2.12.2 → 2.12.4

package/template/.claude/skills/onboard/SKILL.md

@@ -164,7 +164,14 @@ than pretending a pattern exists.
 ## Step 4 - check AI interaction rules and workflow configuration
 
 `devflow/config.json` is the user-owned workflow policy for this project. Keep
-it lean and machine-readable: never write stack choices, conventions, custom
+it lean and machine-readable: edit only supported keys, such as branch prefixes,
+logic-test strictness, regular or Continuous quality gates, review execution, or
+Continuous Mode limits. Independent review defaults to `when-sensitive` for
+regular and Continuous work, and its execution defaults to `automatic`. Audit,
+check, and try guide default to `manual`. Preserve these defaults unless the user
+chooses different policies. A `manual` independent-review gate disables
+automatic selection for that workflow without disabling explicit independent
+audits. Never put stack choices, conventions, custom
 commands, product requirements, communication prose, secrets, or permission for
 commits, merges, pushes, deployments, publication, destructive actions, failed
 checks, or finding waivers into config.
@@ -172,12 +179,12 @@ checks, or finding waivers into config.
 Unless the user already chose these values, ask one short **Implementation
 style** question using the current tool's selectable prompt when available:
 
-1. **Efficient (Recommended)** - one feature-level review packet and no step
-   checkpoint prompts. Write `workflow.stepReview: "feature"` and
-   `workflow.checkpointCommits: "disabled"`.
+1. **Efficient (Recommended)** - one feature-level review packet, a final code
+   walkthrough option, and no step checkpoint prompts. Write
+   `workflow.stepReview: "feature"` and `workflow.checkpointCommits: "disabled"`.
 2. **Guided** - pause for approval after every step and offer optional checkpoint
-   commits. Write `workflow.stepReview: "every"` and
-   `workflow.checkpointCommits: "enabled"`.
+   commits, followed by the same final code walkthrough option. Write
+   `workflow.stepReview: "every"` and `workflow.checkpointCommits: "enabled"`.
 3. **Custom** - ask separately when review should happen and whether checkpoint
    commits should be offered, then write the selected low-level values.
 
@@ -185,6 +192,8 @@ These are onboarding presets, not a third configuration field.
 Never write an `implementationStyle` key. Show the current two values before asking, preserve
 them if the user chooses not to change them, and explain that either value can be
 edited later. A later `/implement` run reads the current configuration.
+The final code walkthrough is not a configuration setting and remains available
+with every implementation style.
 
 Read `devflow/context/ai-interaction.md` and update only obvious mismatches.
 Usually the default review loop should stay intact. Flag preferences for the user
@@ -197,6 +206,13 @@ instead of guessing, such as:
   changing only `stepReview` restores the approval pauses, not checkpoint prompts
 - whether branches should use a different naming pattern
 - whether `/check` should require browser evidence for UI work
+- whether audit, independent review, check, or try guides should stay manual, run only for their
+  documented conditional case, or run for every regular or Continuous work item
+- whether a selected independent review should use the default automatic
+  isolated reviewer or `review.independentExecution: "manual"` for a
+  fresh-session handoff. Explain that automatic execution uses a fresh isolated
+  reviewer only when the active adapter can expose its exact identity and model,
+  and otherwise stops with the manual handoff
 
 If no changes are needed, say so.
 
@@ -250,16 +266,51 @@ DevFlow visibility?
    Keeps AGENTS.md public as the lightweight project agent guide.
 ```
 
-Recommend option 1 by default. If the user chooses option 2:
+Recommend option 1 by default.
+- If option 1 (Commit) is chosen, ensure the project's `.gitignore` ignores transient run files and raw documents:
+  ```gitignore
+  # DevFlow Transient Runtime Data, Research & Scratch Files
+  devflow/runs/*
+  !devflow/runs/.gitkeep
+  devflow/discoveries/*
+  !devflow/discoveries/.gitkeep
+  devflow/reports/*
+  !devflow/reports/.gitkeep
+  devflow/research/*
+  !devflow/research/.gitkeep
+  devflow/scratch/*
+  !devflow/scratch/.gitkeep
+  devflow/decisions/*
+  !devflow/decisions/.gitkeep
+  !devflow/decisions/README.md
+  devflow/inbox/*/raw/*
+  devflow/inbox/raw/*
+  devflow/analysis/*
+  !devflow/analysis/.gitkeep
+  devflow/tmp/*
+  devflow/temp/*
+  devflow/brainstorm/*
+  devflow/brainstorms/*
+  devflow/backups/*
+  devflow/.state/
+  devflow/.vendor/
+  .nexus/
+  prototypes/*
+  !prototypes/.gitkeep
+  ```
+
+If the user chooses option 2 (Local-only / Zero-Visibility):
 
 - Add this block to `.gitignore`, preserving existing entries:
 
   ```gitignore
-  # DevFlow local workflow files
+  # DevFlow local workflow files (Zero-Visibility)
   .agents/
   .claude/
   devflow/
   CLAUDE.md
+  .nexus/
+  prototypes/
   ```
 
 - Keep `AGENTS.md` tracked. It remains the lightweight public project guide for
@@ -273,10 +324,10 @@ Recommend option 1 by default. If the user chooses option 2:
 - Explain that DevFlow state, specs, findings, and history will not travel
   with the repo; another machine needs DevFlow reinstalled or restored
   locally.
-- If any of `.agents/`, `.claude/`, `devflow/`, or
-  `CLAUDE.md` are already tracked, say `.gitignore` will not hide tracked files.
+- If any of `.agents/`, `.claude/`, `devflow/`, `CLAUDE.md`, `.nexus/`, or
+  `prototypes/` are already tracked, say `.gitignore` will not hide tracked files.
   Ask before running
-  `git rm --cached -r .agents .claude devflow CLAUDE.md`, and
+  `git rm --cached -r .agents .claude devflow CLAUDE.md .nexus prototypes`, and
   only run it if the user explicitly approves. Never delete the local files.
 
 Then report which selected tools and adapter folders are needed:

package/template/.claude/skills/overview/SKILL.md

@@ -63,6 +63,20 @@ The compiler writes:
 
 The generated output follows `devflow/reference/project-overview-template.md`.
 
+After the title, write a plan fingerprint in this exact form:
+
+```markdown
+<!-- devflow:source-hash <sha256> -->
+```
+
+Before hashing, normalize only build-plan completion markers by replacing each
+`- [x]` or `- [X]` marker with `- [ ]`, while preserving indentation and every
+other byte. Compute `<sha256>` from the exact UTF-8 bytes of `project-plan.md`,
+one zero byte, then the normalized UTF-8 bytes of `build-plan.md`. This lets
+`/status` detect real plan changes after cloning, copying, or updating without
+treating completed features as overview drift. Replace the previous marker every
+time this skill regenerates the overview.
+
 ## Step 3 - output and report
 
 After compilation:

package/template/.claude/skills/rollback/SKILL.md

@@ -116,7 +116,9 @@ remediation or explicitly plan the dependent rollbacks.
 ## Step 4 - write the rollback spec
 
 Allocate sequential ID (`xxx-slug`) and create `devflow/context/{xxx-slug}/`. Write `devflow/context/{xxx-slug}/spec.md` using
-`reference/rollback-spec-template.md`. Also initialize `stage.md` and `findings.md` in that folder. Fill in:
+`reference/rollback-spec-template.md`. Also initialize `stage.md` and `findings.md` in that folder. Its first heading must be exactly
+`# Rollback: Feature <id> - <title>`, and it must retain the existing
+`**Type:** Rollback` contract. Fill in:
 
 - target feature and archive
 - target commit and parent commit as full 40-character SHA values

package/template/.claude/skills/status/SKILL.md

@@ -35,9 +35,14 @@ Read these, distill them into a few lines, then stop. Do not dump file contents.
 3. **Findings** - `devflow/context/{xxx-slug}/findings.md`. Count findings by status and
    report open and fixed counts next to build-plan progress. Call out any P0 or
    P1 still `open` or `fixed` by ID, since those block `/complete`.
-4. **Overview freshness** - if `devflow/context/project-overview.md` is missing,
-   or if `project-plan.md` or `build-plan.md` appears newer than it by filesystem
-   time, mention that `/overview` should run before new feature work.
+4. **Overview freshness** - if `devflow/context/project-overview.md` is missing
+   or has no `devflow:source-hash`, mention that `/overview` should run before
+   new feature work. Otherwise use `/overview`'s hash contract: exact project-plan
+   bytes, one zero byte, then build-plan bytes with line-start `- [x]` and
+   `- [X]` markers normalized to `- [ ]`. Treat a matching legacy exact-byte hash
+   as current for backward compatibility. Recommend `/overview` only when the
+   recorded hash matches neither value. Do not use filesystem timestamps;
+   `/complete` legitimately makes `build-plan.md` newer when it checks off work.
 5. **Git** - current branch, whether the working tree is clean or has uncommitted
    changes, roughly how many files changed, last commit subject, and whether the
    branch is ahead of its remote. If the directory is not a git repo, say so and
@@ -50,7 +55,12 @@ Read these, distill them into a few lines, then stop. Do not dump file contents.
    A missing file simply means no activity has been recorded. Invalid activity
    state is a warning, not a blocker for the underlying workflow; point to
    `/doctor` to inspect and offer the approved generated-state reset.
-8. **Onboarding check** - Before recommending `/overview`, check whether `AGENTS.md`
+8. **Onboarding & Configuration check** - Read `devflow/config.json` when present.
+   Report effective regular and Continuous quality gates, plus `review.independentExecution`.
+   Explain that independent review defaults to `when-sensitive` for both workflows and
+   execution defaults to `automatic`, which uses an isolated reviewer only when
+   the current adapter supports it. Audit, check, and try guide default to `manual`.
+   Before recommending `/overview`, check whether `AGENTS.md`
    still contains the `<!-- devflow:onboarding-required -->` marker or standard template commands.
    When it does, onboarding is incomplete and `/onboard` is the next action.
 9. **Independent review and browser evidence** - read

package/template/AGENTS.md

@@ -24,9 +24,11 @@ To start a new project, scaffold the application first in an empty folder, then
 
 `devflow/config.json` is the user-owned, machine-readable workflow policy for this project. Workflow skills read the relevant settings before acting. A missing file means built-in defaults. An invalid file falls back to defaults for read-only status reporting, but mutating workflow commands stop and point to `/doctor` instead of guessing.
 
-`qualityGates.regular` controls automatic audit, independent-review, check, and try-guide behavior for the normal workflow and Autopilot. `qualityGates.continuous` controls the same per-feature gates for Continuous Mode. Every gate defaults to `manual`. The conditional modes are `when-sensitive` for audit and independent review, `when-behavioral` for check, and `when-user-facing` for try guides. `always` runs the gate for every work item in that workflow.
+`qualityGates.regular` controls automatic audit, independent-review, check, and try-guide behavior for the normal workflow and Autopilot. `qualityGates.continuous` controls the same per-feature gates for Continuous Mode. Independent review defaults to `when-sensitive` in both workflows, while audit, check, and try guide default to `manual`. Sensitive or unusually broad work therefore selects independent review automatically; ordinary small work does not. Setting a workflow's independent review to `manual` disables that automatic selection, while an explicit `/audit independent current` remains available. The other conditional modes are `when-sensitive` for audit, `when-behavioral` for check, and `when-user-facing` for try guides. `always` runs the gate for every work item in that workflow.
 
-New projects default to one review packet after all small implementation steps (`workflow.stepReview: "feature"`) with step checkpoint commits disabled (`workflow.checkpointCommits: "disabled"`). This keeps the normal loop reviewable without repeating the full session context after every step. Set `stepReview` to `every` when teaching, pairing closely, or working on a high-risk change. That restores the per-step approval pauses. To fully restore the previous workflow, including optional checkpoint prompts after an approved step, also set `checkpointCommits` to `enabled`. Onboarding presents these pairs as Efficient and Guided choices, but stores only the two low-level settings. They can be changed at any time.
+`review.independentExecution` controls how a selected independent-review gate runs. Its default, `automatic`, uses a fresh isolated reviewer child when the active adapter can prove isolation, exact reviewer identity and model, and completion. Otherwise it preserves the request and falls back to the manual handoff. This setting changes execution only; the quality-gate policy still decides whether review is selected. The automatic path spawns a generic child through the current runtime and gives it the installed project-local Audit skill and review contract. It never requires global agent roles or skills. New review requests record requested execution and completed receipts record actual execution. Manual uses `fresh session`; automatic uses `fresh subagent`; an explicit automatic fallback records actual manual with `fresh session`.
+
+New projects default to one review packet after all small implementation steps (`workflow.stepReview: "feature"`) with step checkpoint commits disabled (`workflow.checkpointCommits: "disabled"`). This keeps the normal loop reviewable without repeating the full session context after every step. Set `stepReview` to `every` when teaching, pairing closely, or working on a high-risk change. That restores the per-step approval pauses. To fully restore the previous workflow, including optional checkpoint prompts after an approved step, also set `checkpointCommits` to `enabled`. Onboarding presents these pairs as Efficient and Guided choices, but stores only the two low-level settings. They can be changed at any time. Both styles end with an optional read-only code walkthrough. Review cadence controls approval pauses, not whether the user can ask for an explanation of the finished implementation.
 
 ## Tool-Specific Adapters & Execution Rules
 

package/template/devflow/build-plan.md

@@ -220,4 +220,22 @@
   - *Dependencies*: Feature 26, REQ-20260904-001
   - *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%
 
+---
+
+## 🔄 Phase 28: Upstream AI Blueprint v1.5.4 – v1.6.0 Synchronization
+
+- [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]`
+  - *Dependencies*: Feature 27, DISC-20260907-001
+  - *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%
+
+---
+
+## 🛡️ Phase 29: DevFlow Development Files Hygiene & Client Repo Isolation
+
+- [x] **29. DevFlow Internal Development Files Hygiene, Git Ignore Hardening, and Client Repo Isolation (`DISC-20260907-002`, `074-devflow-development-files-hygiene-and-client-isolation`)** `[Size: S]`
+  - *Dependencies*: DISC-20260907-002
+  - *Scope*: ปรับปรุง `.gitignore` ให้ครอบคลุม `devflow/inbox/*/raw/*`, `devflow/analysis/*`, และไฟล์ทดสอบ/แคชชั่วคราว, เสริมระบบคัดกรองใน `packages/create-nexus-devflow/scripts/prepare-template.ts` เพื่อป้องกันไม่ให้ไฟล์วิเคราะห์และข้อมูลดิบหลุดเข้า Starter Template, เพิ่มคู่มือและคำแนะนำใน `onboard/SKILL.md` และ `adopt/SKILL.md` สำหรับโหมด Local-Only (Zero-Visibility) พร้อม automated tests ตรวจสอบความสะอาดของ template ก่อน publish
+
+
+
 

package/template/devflow/config.json

@@ -13,16 +13,19 @@
     "logicTests": "when-configured",
     "uiEvidence": "when-available"
   },
+  "review": {
+    "independentExecution": "automatic"
+  },
   "qualityGates": {
     "regular": {
       "audit": "manual",
-      "independentReview": "manual",
+      "independentReview": "when-sensitive",
       "check": "manual",
       "tryGuide": "manual"
     },
     "continuous": {
       "audit": "manual",
-      "independentReview": "manual",
+      "independentReview": "when-sensitive",
       "check": "manual",
       "tryGuide": "manual"
     }

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/analysis/REQ-20260903-001-sync-upstream-ai-blueprint/codebase-impact.md

@@ -1,46 +0,0 @@
-# Codebase Impact & Blast Radius Analysis
-
-> **Requirement ID**: `REQ-20260903-001-sync-upstream-ai-blueprint`  
-> **Date**: 2026-09-03  
-> **Complexity Score**: `Low-to-Medium (Controlled Enhancement)`  
-> **Risk Level**: `Low (No Breaking Changes, Backward-Compatible)`  
-
----
-
-## 1. Blast Radius Map (ขอบเขตผลกระทบ)
-
-```mermaid
-graph TD
-    Upstream["Upstream AI Blueprint v1.5.2"] --> Onboard[".agents & .claude /skills/onboard/SKILL.md"]
-    Upstream --> Overview[".agents & .claude /skills/overview/SKILL.md"]
-    Upstream --> Context["devflow/context/ai-interaction.md"]
-    Upstream --> E2E["scripts/e2e/scenarios/unborn-onboarding.ts"]
-    Upstream --> Validator["scripts/validate-framework.ts"]
-    
-    Onboard --> TemplateOnboard["packages/create-nexus-devflow template"]
-    Overview --> TemplateOverview["packages/create-nexus-devflow template"]
-    Context --> TemplateContext["packages/create-nexus-devflow template"]
-```
-
----
-
-## 2. Affected Files & Modules (รายการไฟล์ที่ได้รับผลกระทบ)
-
-| File Path | Action | Description |
-| :--- | :--- | :--- |
-| `.agents/skills/onboard/SKILL.md` | `MODIFY` | เพิ่ม Step 0 ตรวจจับ Unborn repository และเสนอกระบวนการ Root scaffold commit |
-| `.claude/skills/onboard/SKILL.md` | `MODIFY` | ปรับปรุงพฤติกรรมให้ตรงกับ `.agents/` |
-| `.agents/skills/overview/SKILL.md` | `MODIFY` | เพิ่มความสามารถ Setup branch baseline finalization (`git merge --ff-only`) |
-| `.claude/skills/overview/SKILL.md` | `MODIFY` | ปรับปรุงพฤติกรรมให้ตรงกับ `.agents/` |
-| `devflow/context/ai-interaction.md` | `MODIFY` | อัปเดตระเบียบการ baseline commit บน setup branch |
-| `scripts/e2e/scenarios/unborn-onboarding.ts` | `NEW` | เพิ่มชุดทดสอบ E2E scenario ตัวที่ 9 สำหรับ unborn repo & fast-forward baseline |
-| `scripts/validate-framework.ts` | `MODIFY` | เพิ่ม verification contracts สำหรับ onboard unborn check และ overview finalization prompt |
-| `packages/create-nexus-devflow/template/` | `SYNC` | ซิงก์ template ผ่าน `npm run check` |
-
----
-
-## 3. Risk & Breaking Change Assessment
-
-- **Contract Breaking Risk**: `None` — ไม่มีการเปลี่ยนแปลงโครงสร้างคำสั่งหรือโฟลเดอร์หลัก ทุกการเปลี่ยนแปลงเป็นส่วนขยายเพื่อรองรับ Edge Case ที่ยังไม่มี commit
-- **Git Safety Risk**: `Zero Remote Exposure` — มีการล็อกกฎความปลอดภัยไม่ให้มีการ push ไปยัง remote ในระหว่าง Onboard และ Overview อย่างเข้มงวด
-- **Test Coverage Impact**: เพิ่ม Coverage โดยมี scenario ใหม่ `unborn-onboarding.ts` ในชุด E2E Agent Runner

package/template/devflow/analysis/REQ-20260904-001-sync-upstream-ai-blueprint/codebase-impact.md

@@ -1,47 +0,0 @@
-# Codebase Impact & Blast Radius Analysis
-
-> **Request ID**: `REQ-20260904-001-sync-upstream-ai-blueprint`  
-> **Target Run ID**: `072-sync-upstream-ai-blueprint-v153`  
-> **Analysis Date**: 2026-09-04  
-> **Status**: Completed
-
----
-
-## 💥 Blast Radius Overview
-
-| Category | Assessment | Details |
-| :--- | :--- | :--- |
-| **Overall Complexity** | `Low-Medium` 🟢 | แก้ไข Skill Markdown contracts, เพิ่ม 1 E2E Scenario, ปรับปรุง Static Validator |
-| **API / Contract Breaking Risk** | `None` 🟢 | รักษา Backward Compatibility 100% (ทั้งแบบมีและไม่มี manifest) |
-| **Affected Areas** | Core Skills, E2E Test Suite, Static Framework Validator | `.agents/`, `.claude/`, `scripts/` |
-| **Regression Risk** | `Low` 🟢 | มี Static Check และ E2E Scenario ครอบคลุม |
-
----
-
-## 📂 Affected Files & Modules
-
-### 1. Core Skills (`.agents/` & `.claude/`)
-- `.agents/skills/onboard/SKILL.md` (Update Step 1 & Step 6 for manifest-aware adapter reporting)
-- `.claude/skills/onboard/SKILL.md` (Synchronize Step 1 & Step 6 identical contract)
-
-### 2. Validation & Verification Guardrails
-- `agent-bundle.manifest.json` (Add contract phrases for onboard: authoritative installer selection, etc.)
-- `scripts/validate-framework.ts` (Ensure verification covers updated onboard contracts)
-
-### 3. Test Suites & E2E Scenarios
-- `scripts/e2e/scenarios/adapter-selection.ts` (New E2E Scenario 10 ported from upstream)
-- `packages/create-nexus-devflow/test/update.test.ts` (Verify adapter detection & selection tests)
-
-### 4. Documentation & Release Tracking
-- `devflow/build-plan.md` (Record Run 072)
-- `CHANGELOG.md` (Document v1.5.3 sync updates)
-
----
-
-## 🧪 Verification Strategy
-
-1. **Static Validation**: `npm run check:static` (ต้องผ่าน 100% ไม่เกิน context budget)
-2. **Type Checking**: `npm run typecheck`
-3. **Unit / Package Tests**: `npm test`
-4. **End-to-End Test Suite**: `npm run check`
-5. **Upstream Drift Radar**: `npx tsx scripts/check-upstream-drift.ts` (ยืนยัน 100% Skills & Contract Parity)

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

@@ -1,34 +0,0 @@
-# Socratic Clarification Checklist (REQ-20260903-001)
-
-> **Requirement ID**: `REQ-20260903-001-sync-upstream-ai-blueprint`  
-> **Audience**: System Analyst, Tech Lead, Framework Maintainer  
-> **Status**: `Ready for Review`  
-
----
-
-## 🔍 Socratic Review & Alignment Questions
-
-### 1. Root Scaffold Commit Convention
-- [x] **Question**: รูปแบบ Commit Message สำหรับ Scaffold แรกใน Unborn Repo ควรใช้รูปแบบใด?
-  - **Proposed Decision**: `chore: scaffold application` (มาตรฐานเดียวกับ Upstream AI Blueprint และ Conventional Commits)
-  - **Safety Check**: ต้องไม่รวมโฟลเดอร์ `devflow/`, `AGENTS.md`, `CLAUDE.md`, `.agents/`, `.claude/` เข้าไปใน Root Commit นี้เด็ดขาด
-
-### 2. Setup-Branch Fast-Forward Merge Rule
-- [x] **Question**: ใน `/overview` หากผู้ใช้วางแผนบน dedicated branch (เช่น `feature/devflow-plans`) การรวมกลับเข้า `main` ต้องทำอย่างไร?
-  - **Proposed Decision**: บังคับใช้ `git merge --ff-only` เท่านั้นเพื่อรักษา Linear Git History หากมีการแตก branch ออกไปแบบ non-fast-forward จะต้องหยุดและรายงาน mismatch ทันที
-  - **Safety Check**: ยืนยันการลบ local setup branch หลัง merge สำเร็จ เพื่อไม่ให้มี branch ขยะค้าง
-
-### 3. Local-Only & Remote Push Guard
-- [x] **Question**: การทำ Finalize Baseline มีโอกาสหลุดรัน `git push` หรือไม่?
-  - **Proposed Decision**: ล็อกกฎชัดเจนใน `SKILL.md` ว่าทุกคำสั่งใน Onboard และ Overview ทำงานในระดับ Local Git เท่านั้น (No Push)
-
----
-
-## 📋 Actionable Checklist for Implementation
-
-- [ ] ปรับปรุง `.agents/skills/onboard/SKILL.md` และ `.claude/skills/onboard/SKILL.md` เพื่อตรวจจับ Unborn `HEAD` และเสนอ Scaffold Root Commit
-- [ ] ปรับปรุง `.agents/skills/overview/SKILL.md` และ `.claude/skills/overview/SKILL.md` สำหรับ Setup-Branch Baseline Finalization (`git merge --ff-only`)
-- [ ] อัปเดต `devflow/context/ai-interaction.md` ให้ระบุสิทธิการทำ Baseline Finalization บน Setup Branch
-- [ ] พอร์ต E2E Scenario `scripts/e2e/scenarios/unborn-onboarding.ts` ให้เข้ากับโครงสร้างและชื่อคำสั่งของ Nexus-DevFlow
-- [ ] เพิ่ม static verification contract ใน `scripts/validate-framework.ts`
-- [ ] รันการตรวจสอบความถูกต้องของระบบครบทุก Lane (`npm run check:static`, `npm test`, `npm run check`)

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

@@ -1,66 +0,0 @@
-# Business & Technical Requirement Specification (REQ-20260903-001)
-
-> **Requirement ID**: `REQ-20260903-001-sync-upstream-ai-blueprint`  
-> **Source**: Upstream AI Blueprint v1.5.2 (`5b46859`)  
-> **Status**: `Parsed & Normalized`  
-> **Target Release**: Nexus-DevFlow v2.12.1 / Feature `071`  
-
----
-
-## 1. Executive Summary (ภาพรวมผู้บริหาร)
-
-การอัปเดตเพื่อซิงก์ความสามารถและมาตรฐานความปลอดภัย Git จาก Upstream AI Blueprint v1.5.2 เข้าสู่ Nexus-DevFlow:
-1. **การจัดการ Unborn Repository ใน `/onboard`**: รองรับกรณีที่โปรเจกต์เพิ่งรัน `git init` แต่ยังไม่มี First Commit (Unborn `HEAD`) โดย `/onboard` จะตรวจจับอัตโนมัติ เสนอสร้าง Reviewed Scaffold Initial Commit และตั้ง Default Branch (`main`) ให้พร้อมใช้งานทันทีโดยไม่ให้ผู้ใช้ต้องออกจาก IDE ไปพิมพ์คำสั่ง Git เอง
-2. **Setup-Branch Baseline Finalization ใน `/overview`**: รองรับกรณีการ Onboard และวางแผนบน Dedicated Setup Branch (เช่น `feature/devflow-plans`) โดยเมื่ออนุมัติ Baseline Commit จะทำการ commit, fast-forward merge กลับเข้าสู่ `main`, สลับ branch และลบ setup branch ให้เรียบร้อยแบบ Local-Only
-3. **Dedicated E2E Automated Scenario (`unborn-onboarding.ts`)**: ชุดทดสอบ Agentic E2E ตรวจสอบพฤติกรรมของ AI Agent ตั้งแต่ Unborn Repo -> Onboarding -> Baseline Fast-Forward
-
----
-
-## 2. Target Persona & User Stories
-
-| Persona | Problem Statement | Desired Outcome |
-| :--- | :--- | :--- |
-| **New Project Developer** | Scaffold โปรเจกต์ใหม่และรัน `git init` แต่ยังไม่ได้ commit พอรัน `/onboard` AI มัก error หรือสับสนเรื่อง branch | `/onboard` ตรวจจับสถานะ unborn repository และช่วยสร้าง scaffold commit แรกให้อัตโนมัติหลังกดอนุมัติ |
-| **Branch-Isolated Developer** | ต้องการวางแผน DevFlow บน setup branch ชั่วคราวก่อนเริ่มฟีเจอร์แรก | `/overview` อนุมัติ Baseline แล้วรวมกลับเข้า `main` แบบ Fast-Forward และลบ branch ชั่วคราวให้อัตโนมัติ |
-| **DevFlow Maintainer** | ต้องการให้ Nexus-DevFlow มี Feature & Safety Parity 100% กับ Upstream AI Blueprint | มีชุดทดสอบ E2E scenario และ static contracts รองรับ |
-
----
-
-## 3. Functional Requirements (FR)
-
-### FR-1: Unborn Git Pre-flight & Scaffold Initial Commit (`/onboard`)
-- **FR-1.1**: เมื่อเริ่มทำงาน `/onboard` (Step 0) ต้องตรวจสอบ `git rev-parse --is-inside-work-tree` และ `git rev-parse --verify HEAD`
-- **FR-1.2**: หากไม่มี `HEAD` (Unborn repository):
-  - กรอง Candidate Files เฉพาะไฟล์โครงสร้างของ Application (ยกเว้น workflow files เช่น `AGENTS.md`, `CLAUDE.md`, `.agents/`, `.claude/`, `devflow/`)
-  - ค้นหา default branch (จาก `main`, `master`, หรือ Git default)
-  - ถามยืนยัน 1 ครั้ง: `Create the initial scaffold commit and continue Onboard? (Recommended)`
-  - เมื่อได้รับอนุมัติ สร้าง commit `chore: scaffold application` บน default branch และสลับกลับมา setup branch (ถ้ามี) เพื่อ onboard ต่อทันที
-
-### FR-2: Branch-Aware Baseline Finalization (`/overview`)
-- **FR-2.1**: ใน `/overview` อนุญาตให้ทำงานบน Default Branch หรือ Dedicated Setup Branch ที่แตกมาจาก Tip ของ Default Branch
-- **FR-2.2**: หากรันบน Unborn Repo ให้แจ้งให้ไปรัน `/onboard` ก่อน (ไม่สร้าง root commit ใน overview)
-- **FR-2.3**: ปรับ Prompt ข้อความยืนยันเป็น: `Finalize the DevFlow baseline locally? (Recommended)`
-- **FR-2.4**: รวม metadata installer `devflow/.state/manifest.json` เข้า Baseline Commit โดยยกเว้น transient state `run.json`
-- **FR-2.5**: หากรันบน Setup Branch เมื่ออนุมัติแล้ว จะทำการ:
-  1. Commit `chore: establish DevFlow project baseline` บน setup branch
-  2. สลับกลับไป default branch (`git checkout main`)
-  3. รัน `git merge --ff-only <setup-branch>`
-  4. ลบ setup branch ในเครื่อง (`git branch -d <setup-branch>`)
-  5. อยู่บนสถานะ clean working tree พร้อมเริ่ม `/feature`
-
-### FR-3: E2E Test Suite Extension (`unborn-onboarding.ts`)
-- **FR-3.1**: เพิ่มไฟล์ Scenario `scripts/e2e/scenarios/unborn-onboarding.ts`
-- **FR-3.2**: ทดสอบ Full Flow ใน Sandbox: `git init` -> setup branch -> overlay DevFlow -> `/onboard` -> `/overview` -> fast-forward `main`
-
----
-
-## 4. Non-Functional Requirements (NFR)
-
-1. **Security & Local-Only Guarantee**:
-   - ห้ามรัน `git push` ในทุกกรณีของการทำ Baseline Finalization
-   - ห้ามรวม Application Source Code ปะปนเข้ากับ Baseline Commit
-   - ป้องกัน Secret / Token หลุดเข้า Root Commit โดยตรวจสอบ `.gitignore`
-2. **Token & Prompt Efficiency**:
-   - การปรับแต่งคำอธิบายและข้อความใน `SKILL.md` ทั้ง `.agents/` และ `.claude/` ต้องคงความกระชับ ไม่เกินงบประมาณตัวอักษร
-3. **Adapter Parity**:
-   - ทั้ง 5 Adapters (Google Antigravity, Claude Code, OpenAI Codex, GitHub Copilot, OpenCode) ต้องได้รับพฤติกรรมที่เท่าเทียมกัน

package/template/devflow/inbox/REQ-20260903-001-sync-upstream-ai-blueprint/raw/upstream-v152-diff.md

@@ -1,16 +0,0 @@
-# Upstream AI Blueprint v1.5.2 Changes Summary
-
-Commit: 5b468599890a6d59a1570e343e6241db5ffd0ae9
-Author: Brad Traversy <traversymedia@gmail.com>
-Date: Thu Sep 3 08:30:38 2026 -0400
-Message: fix: handle repositories without an initial commit
-
-## Modified Files:
-- `.agents/skills/onboard/SKILL.md` (+43, -1)
-- `.agents/skills/overview/SKILL.md` (+41, -21)
-- `.claude/skills/onboard/SKILL.md` (+43, -1)
-- `.claude/skills/overview/SKILL.md` (+41, -21)
-- `blueprint/context/ai-interaction.md` (+4, -2)
-- `packages/create-ai-blueprint/package.json` (+1, -1)
-- `scripts/e2e/scenarios/unborn-onboarding.ts` (+85)
-- `scripts/validate-blueprint.ts` (+23, -5)

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

@@ -1,28 +0,0 @@
-# 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

@@ -1,59 +0,0 @@
-# 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

@@ -1,23 +0,0 @@
-# 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(-)