@jakkrichm/create-nexus-devflow 2.12.0 → 2.12.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jakkrichm/create-nexus-devflow",
-  "version": "2.12.0",
+  "version": "2.12.2",
   "description": "Installer and workflow manager for Nexus-DevFlow agentic workflow layer.",
   "license": "MIT",
   "author": "Jakkrich",

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

@@ -29,7 +29,48 @@ and project behavior already exist and need to be reflected into the plans.
 No argument is required. If the user provides context about the stack, hosting,
 database, auth, or preferred tool, use it as a hint and verify against files.
 
-## Step 0 - confirm this is onboarding, not adoption
+## Step 0 - confirm Git and make an unborn repository usable
+
+Before reading application code or changing setup files, confirm both Git states:
+
+```bash
+git rev-parse --is-inside-work-tree
+git rev-parse --verify HEAD
+```
+
+If this is not a Git repository, stop and ask the user to initialize one, then
+rerun `/onboard`.
+
+An existing first commit may contain only the scaffold or may already contain
+DevFlow. Both are valid. Do not ask the user to rewrite either history shape.
+
+If Git reports an unborn `HEAD`, handle it here instead of sending the user away
+to run Git commands:
+
+1. Inspect status and build a safe scaffold-only candidate from paths outside
+   `AGENTS.md`, `CLAUDE.md`, `.agents/`, `.claude/`, and `devflow/`. Exclude
+   secrets, dependencies, caches, build output, generated state, and anything
+   else that should not enter source control. Include the existing `.gitignore`
+   when it is safe.
+2. Resolve the intended default branch from a remote default when available,
+   then an existing `main` or `master`, then Git's configured initial branch,
+   and otherwise `main`. Preserve the current unborn branch name as the setup
+   branch when it is not the intended default. If the intended name is genuinely
+   ambiguous, ask only that one question.
+3. Show the exact candidate and the branch result, then ask once:
+   `Create the initial scaffold commit and continue Onboard? (Recommended)`
+   State that this creates one local commit and never pushes.
+4. On approval, stage only the reviewed candidate, verify the staged diff, and
+   commit it as `chore: scaffold application`. If needed, rename the unborn
+   branch before committing so the root commit establishes the intended default
+   branch. Then create or return to the named setup branch at that same commit
+   and continue Onboard in the same run.
+
+If there is no safe scaffold candidate, stop with the exact blocker rather than
+creating an empty or mixed root commit. Never create the commit without explicit
+approval.
+
+Then confirm this is onboarding, not adoption.
 
 Inspect the repository and the two planning docs:
 
@@ -41,7 +82,7 @@ Inspect the repository and the two planning docs:
   Continue only with setup files such as `AGENTS.md`, `coding-standards.md`,
   `.gitignore`, and optional notes.
 
-Never run a framework scaffolder. The Blueprint is already overlaid.
+Never run a framework scaffolder. DevFlow is already overlaid.
 
 ## Step 1 - survey the project facts
 
@@ -55,7 +96,8 @@ Read only enough to identify the setup:
   `tailwind.config.*`, database config, test config)
 - source layout, route layout, and app/package directories
 - existing `.gitignore`
-- whether `.agents/` and `.claude/` are both needed
+- `devflow/.state/manifest.json` or `.nexus/nexus-devflow.json`, when present, and its selected adapter list
+- which selected tools need `.agents/`, `.claude/`, or both
 - whether Blueprint workflow paths are already tracked by git
 - existing verification commands and `.github/workflows/`
 - project name, from `package.json`, the folder name, existing docs, or the user
@@ -237,14 +279,26 @@ Recommend option 1 by default. If the user chooses option 2:
   `git rm --cached -r .agents .claude devflow CLAUDE.md`, and
   only run it if the user explicitly approves. Never delete the local files.
 
-Then report which adapter folders are needed:
-
-- Codex, Antigravity, and GitHub Copilot: keep `AGENTS.md`, `.agents/`, and `devflow/`; `CLAUDE.md` and
+Then report which selected tools and adapter folders are needed:
+
+- When a valid `devflow/.state/manifest.json` or `.nexus/nexus-devflow.json` exists, its `adapters` list is
+  the authoritative installer selection. The presence of `.agents/` means its
+  files are compatible with Codex, Antigravity, GitHub Copilot, and OpenCode;
+  it does not mean all four tools were selected.
+- Do not ask the user to select adapters again when that valid manifest exists.
+  Keep and report the exact selection. If a required adapter tree is missing,
+  report the mismatch and point to `/doctor` instead of guessing or deleting
+  another tree.
+- Without a valid manifest, explain that folder detection cannot distinguish
+  Codex, Antigravity, GitHub Copilot, and OpenCode, then ask which tools the user actually
+  uses instead of assuming all of them are selected.
+- Codex and Antigravity: keep `AGENTS.md`, `.agents/`, and `devflow/`; `CLAUDE.md` and
   `.claude/` can be deleted.
 - Claude Code only: keep `AGENTS.md`, `CLAUDE.md`, `.claude/`, and `devflow/`;
   `.agents/` can be deleted.
+- GitHub Copilot only: keep `AGENTS.md`, `.agents/`, and `devflow/`.
 - OpenCode: shares either `.agents/` or `.claude/` compatible skill tree without duplicate folders.
-- Mixed tools: keep both `.agents/` and `.claude/` adapters.
+- Mixed tools: keep only the compatible adapter trees required by the selected tools.
 
 Do not delete adapters unless the user explicitly asks.
 

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

@@ -81,8 +81,8 @@ commit. Never create this commit silently.
 Treat this as the initial pre-feature state only when all of these are true:
 
 - the project is a Git repository with an existing `HEAD` commit
-- the current branch is the default branch, resolving the remote default when
-  available and otherwise accepting `main` or `master`
+- the current branch is the default branch, or it is a dedicated setup branch
+  whose starting commit exactly matches the current default-branch tip
 - the version of `devflow/context/project-overview.md` in `HEAD` does not
   already contain a generated overview baseline
 - `devflow/context/` has no active task-isolated workspace directories (`devflow/context/{xxx-slug}/`)
@@ -91,11 +91,11 @@ Treat this as the initial pre-feature state only when all of these are true:
 - `devflow/build-plan.md` contains no checked feature items
 - the DevFlow workflow is meant to be committed, not kept local-only
 
-If there is no `HEAD` yet, stop and ask the user to commit the app scaffold by
-itself before rerunning `/overview`; never create a root commit that mixes the
-app and DevFlow. If the initial run is on a non-default branch, stop and ask
-the user to return to the default branch first. These are recoverable initial
-handoffs, not permission to offer another baseline after one is committed.
+If there is no `HEAD` yet, stop and send the user back to `/onboard`, which owns
+the initial scaffold commit recovery. Overview never creates a root commit. If a
+dedicated setup branch did not start at the current default tip, stop with that
+exact mismatch. These are recoverable initial handoffs, not permission to offer
+another baseline after one is committed.
 
 Detect local-only mode with Git, not memory. Use `git check-ignore` on the
 present workflow paths. If `.agents/`, `.claude/`, `devflow/`, or `CLAUDE.md`
@@ -103,7 +103,7 @@ are ignored as part of the onboarding local-only choice, skip the offer and
 continue to the normal `/feature` guidance. `AGENTS.md` remaining public does not
 make a local-only setup eligible.
 
-Before asking:
+Before asking, record the resolved default branch and its exact tip:
 
 1. Read `git status`, the staged diff, the unstaged diff, and untracked paths.
 2. Build a candidate containing only DevFlow installation, adapter,
@@ -111,16 +111,21 @@ Before asking:
    `CLAUDE.md`, `.agents/`, `.claude/`, and `devflow/`. Include `.gitignore`
    only when every changed hunk is clearly an onboarding or DevFlow ignore
    entry.
-3. Exclude generated local state such as `devflow/.state/`, secrets, logs,
-   caches, dependencies, build output, and application source.
+3. Include the installer-owned `devflow/.state/manifest.json` and
+   `devflow/.state/.gitignore` when present. Exclude transient state such as
+   `run.json`, backups, and staging, plus secrets, logs, caches, dependencies,
+   build output, and application source.
 4. Stop if any staged change or dirty path falls outside the candidate, or if an
    allowed file contains an unrelated hunk. Do not mix app scaffolding or other
    user work into this commit. Tell the user exactly what must be committed,
    moved, or restored first, then leave the repository unchanged.
 5. If the candidate is empty, skip the offer.
 6. Show the exact candidate paths and their diff before asking:
-   `Create the initial planning baseline commit now? (Recommended)`
-   State that accepting creates one local commit and never pushes it.
+   `Finalize the DevFlow baseline locally? (Recommended)`
+   State that accepting creates one local commit. When running on a dedicated
+   setup branch, it also fast-forwards the unchanged default branch to that
+   commit, returns to the default branch, and deletes the setup branch. It never
+   pushes.
 
 If the user accepts, stage only the reviewed candidate, show the staged paths
 and diff summary, verify no other path is staged, and commit with this exact
@@ -130,6 +135,14 @@ message:
 chore: establish DevFlow project baseline
 ```
 
+For a dedicated setup branch, verify before committing that the default tip is
+still the one shown in the prompt. After the commit, require a clean working
+tree, switch to the default branch, run `git merge --ff-only <setup-branch>`, and
+delete the setup branch locally. The single approval above covers only these
+named local actions. If the default moved or any check fails, stop without
+merging or deleting. Then confirm the final branch and working tree and recommend
+`/feature`.
+
 Then confirm the working tree state and recommend `/feature`. If the user
 declines, leave the repository untouched and explain that these setup and
 planning changes will remain uncommitted until they create the baseline later.

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

@@ -29,7 +29,48 @@ and project behavior already exist and need to be reflected into the plans.
 No argument is required. If the user provides context about the stack, hosting,
 database, auth, or preferred tool, use it as a hint and verify against files.
 
-## Step 0 - confirm this is onboarding, not adoption
+## Step 0 - confirm Git and make an unborn repository usable
+
+Before reading application code or changing setup files, confirm both Git states:
+
+```bash
+git rev-parse --is-inside-work-tree
+git rev-parse --verify HEAD
+```
+
+If this is not a Git repository, stop and ask the user to initialize one, then
+rerun `/onboard`.
+
+An existing first commit may contain only the scaffold or may already contain
+DevFlow. Both are valid. Do not ask the user to rewrite either history shape.
+
+If Git reports an unborn `HEAD`, handle it here instead of sending the user away
+to run Git commands:
+
+1. Inspect status and build a safe scaffold-only candidate from paths outside
+   `AGENTS.md`, `CLAUDE.md`, `.agents/`, `.claude/`, and `devflow/`. Exclude
+   secrets, dependencies, caches, build output, generated state, and anything
+   else that should not enter source control. Include the existing `.gitignore`
+   when it is safe.
+2. Resolve the intended default branch from a remote default when available,
+   then an existing `main` or `master`, then Git's configured initial branch,
+   and otherwise `main`. Preserve the current unborn branch name as the setup
+   branch when it is not the intended default. If the intended name is genuinely
+   ambiguous, ask only that one question.
+3. Show the exact candidate and the branch result, then ask once:
+   `Create the initial scaffold commit and continue Onboard? (Recommended)`
+   State that this creates one local commit and never pushes.
+4. On approval, stage only the reviewed candidate, verify the staged diff, and
+   commit it as `chore: scaffold application`. If needed, rename the unborn
+   branch before committing so the root commit establishes the intended default
+   branch. Then create or return to the named setup branch at that same commit
+   and continue Onboard in the same run.
+
+If there is no safe scaffold candidate, stop with the exact blocker rather than
+creating an empty or mixed root commit. Never create the commit without explicit
+approval.
+
+Then confirm this is onboarding, not adoption.
 
 Inspect the repository and the two planning docs:
 
@@ -41,7 +82,7 @@ Inspect the repository and the two planning docs:
   Continue only with setup files such as `AGENTS.md`, `coding-standards.md`,
   `.gitignore`, and optional notes.
 
-Never run a framework scaffolder. The Blueprint is already overlaid.
+Never run a framework scaffolder. DevFlow is already overlaid.
 
 ## Step 1 - survey the project facts
 
@@ -55,7 +96,8 @@ Read only enough to identify the setup:
   `tailwind.config.*`, database config, test config)
 - source layout, route layout, and app/package directories
 - existing `.gitignore`
-- whether `.agents/` and `.claude/` are both needed
+- `devflow/.state/manifest.json` or `.nexus/nexus-devflow.json`, when present, and its selected adapter list
+- which selected tools need `.agents/`, `.claude/`, or both
 - whether Blueprint workflow paths are already tracked by git
 - existing verification commands and `.github/workflows/`
 - project name, from `package.json`, the folder name, existing docs, or the user
@@ -237,14 +279,26 @@ Recommend option 1 by default. If the user chooses option 2:
   `git rm --cached -r .agents .claude devflow CLAUDE.md`, and
   only run it if the user explicitly approves. Never delete the local files.
 
-Then report which adapter folders are needed:
-
-- Codex, Antigravity, and GitHub Copilot: keep `AGENTS.md`, `.agents/`, and `devflow/`; `CLAUDE.md` and
+Then report which selected tools and adapter folders are needed:
+
+- When a valid `devflow/.state/manifest.json` or `.nexus/nexus-devflow.json` exists, its `adapters` list is
+  the authoritative installer selection. The presence of `.agents/` means its
+  files are compatible with Codex, Antigravity, GitHub Copilot, and OpenCode;
+  it does not mean all four tools were selected.
+- Do not ask the user to select adapters again when that valid manifest exists.
+  Keep and report the exact selection. If a required adapter tree is missing,
+  report the mismatch and point to `/doctor` instead of guessing or deleting
+  another tree.
+- Without a valid manifest, explain that folder detection cannot distinguish
+  Codex, Antigravity, GitHub Copilot, and OpenCode, then ask which tools the user actually
+  uses instead of assuming all of them are selected.
+- Codex and Antigravity: keep `AGENTS.md`, `.agents/`, and `devflow/`; `CLAUDE.md` and
   `.claude/` can be deleted.
 - Claude Code only: keep `AGENTS.md`, `CLAUDE.md`, `.claude/`, and `devflow/`;
   `.agents/` can be deleted.
+- GitHub Copilot only: keep `AGENTS.md`, `.agents/`, and `devflow/`.
 - OpenCode: shares either `.agents/` or `.claude/` compatible skill tree without duplicate folders.
-- Mixed tools: keep both `.agents/` and `.claude/` adapters.
+- Mixed tools: keep only the compatible adapter trees required by the selected tools.
 
 Do not delete adapters unless the user explicitly asks.
 

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

@@ -81,8 +81,8 @@ commit. Never create this commit silently.
 Treat this as the initial pre-feature state only when all of these are true:
 
 - the project is a Git repository with an existing `HEAD` commit
-- the current branch is the default branch, resolving the remote default when
-  available and otherwise accepting `main` or `master`
+- the current branch is the default branch, or it is a dedicated setup branch
+  whose starting commit exactly matches the current default-branch tip
 - the version of `devflow/context/project-overview.md` in `HEAD` does not
   already contain a generated overview baseline
 - `devflow/context/` has no active task-isolated workspace directories (`devflow/context/{xxx-slug}/`)
@@ -91,11 +91,11 @@ Treat this as the initial pre-feature state only when all of these are true:
 - `devflow/build-plan.md` contains no checked feature items
 - the DevFlow workflow is meant to be committed, not kept local-only
 
-If there is no `HEAD` yet, stop and ask the user to commit the app scaffold by
-itself before rerunning `/overview`; never create a root commit that mixes the
-app and DevFlow. If the initial run is on a non-default branch, stop and ask
-the user to return to the default branch first. These are recoverable initial
-handoffs, not permission to offer another baseline after one is committed.
+If there is no `HEAD` yet, stop and send the user back to `/onboard`, which owns
+the initial scaffold commit recovery. Overview never creates a root commit. If a
+dedicated setup branch did not start at the current default tip, stop with that
+exact mismatch. These are recoverable initial handoffs, not permission to offer
+another baseline after one is committed.
 
 Detect local-only mode with Git, not memory. Use `git check-ignore` on the
 present workflow paths. If `.agents/`, `.claude/`, `devflow/`, or `CLAUDE.md`
@@ -103,7 +103,7 @@ are ignored as part of the onboarding local-only choice, skip the offer and
 continue to the normal `/feature` guidance. `AGENTS.md` remaining public does not
 make a local-only setup eligible.
 
-Before asking:
+Before asking, record the resolved default branch and its exact tip:
 
 1. Read `git status`, the staged diff, the unstaged diff, and untracked paths.
 2. Build a candidate containing only DevFlow installation, adapter,
@@ -111,16 +111,21 @@ Before asking:
    `CLAUDE.md`, `.agents/`, `.claude/`, and `devflow/`. Include `.gitignore`
    only when every changed hunk is clearly an onboarding or DevFlow ignore
    entry.
-3. Exclude generated local state such as `devflow/.state/`, secrets, logs,
-   caches, dependencies, build output, and application source.
+3. Include the installer-owned `devflow/.state/manifest.json` and
+   `devflow/.state/.gitignore` when present. Exclude transient state such as
+   `run.json`, backups, and staging, plus secrets, logs, caches, dependencies,
+   build output, and application source.
 4. Stop if any staged change or dirty path falls outside the candidate, or if an
    allowed file contains an unrelated hunk. Do not mix app scaffolding or other
    user work into this commit. Tell the user exactly what must be committed,
    moved, or restored first, then leave the repository unchanged.
 5. If the candidate is empty, skip the offer.
 6. Show the exact candidate paths and their diff before asking:
-   `Create the initial planning baseline commit now? (Recommended)`
-   State that accepting creates one local commit and never pushes it.
+   `Finalize the DevFlow baseline locally? (Recommended)`
+   State that accepting creates one local commit. When running on a dedicated
+   setup branch, it also fast-forwards the unchanged default branch to that
+   commit, returns to the default branch, and deletes the setup branch. It never
+   pushes.
 
 If the user accepts, stage only the reviewed candidate, show the staged paths
 and diff summary, verify no other path is staged, and commit with this exact
@@ -130,6 +135,14 @@ message:
 chore: establish DevFlow project baseline
 ```
 
+For a dedicated setup branch, verify before committing that the default tip is
+still the one shown in the prompt. After the commit, require a clean working
+tree, switch to the default branch, run `git merge --ff-only <setup-branch>`, and
+delete the setup branch locally. The single approval above covers only these
+named local actions. If the default moved or any check fails, stop without
+merging or deleting. Then confirm the final branch and working tree and recommend
+`/feature`.
+
 Then confirm the working tree state and recommend `/feature`. If the user
 declines, leave the repository untouched and explain that these setup and
 planning changes will remain uncommitted until they create the baseline later.

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

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

@@ -0,0 +1,47 @@
+# 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/build-plan.md

@@ -204,3 +204,20 @@
   - *Dependencies*: Feature 20, Feature 21, DISC-20260903-001
   - *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%
 
+---
+
+## 🔄 Phase 26: Upstream AI Blueprint v1.5.2 Synchronization
+
+- [x] **26. Sync Upstream v1.5.2 (Unborn Repository Onboarding & Branch Baseline Finalization) (`REQ-20260903-001`, `071-sync-upstream-ai-blueprint-v152`)** `[Size: S]`
+  - *Dependencies*: Feature 25, REQ-20260903-001
+  - *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%
+
+---
+
+## 🔄 Phase 27: Upstream AI Blueprint v1.5.3 Synchronization
+
+- [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]`
+  - *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%
+
+

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

@@ -52,6 +52,8 @@ devflow/
 ### ⚡ 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%:*
 
+After the first successful `/overview`, DevFlow offers a reviewed local commit for the initial workflow setup and plans before Feature 1. It shows the exact candidate diff and asks first. It skips local-only installations and stops rather than mixing app source or unrelated work into the baseline. When setup work is on a dedicated branch, the same approval can finalize the local baseline and fast-forward it into the unchanged default branch. It never pushes.
+
 ```text
 /feature (หรือ /fix) ──▶ /implement ──▶ /check ──▶ /complete
 ```

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

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

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

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

@@ -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(-)