@jakkrichm/create-nexus-devflow 2.16.4 → 2.17.0

package/dist/scripts/prepare-template.js

@@ -66,6 +66,41 @@ async function copyEntry(entry, inventory) {
                     !normalized.endsWith("README.md")) {
                     return false;
                 }
+                if (normalized.startsWith("devflow/00-context/") &&
+                    normalized !== "devflow/00-context" &&
+                    normalized !== "devflow/00-context/project-overview.md" &&
+                    normalized !== "devflow/00-context/coding-standards.md" &&
+                    normalized !== "devflow/00-context/ai-interaction.md" &&
+                    normalized !== "devflow/00-context/glossary.md") {
+                    return false;
+                }
+                if (normalized.startsWith("devflow/40-tasks/") &&
+                    !normalized.endsWith(".gitkeep") &&
+                    !normalized.endsWith("README.md")) {
+                    return false;
+                }
+                if (normalized.startsWith("devflow/50-history/features/") &&
+                    !normalized.endsWith("README.md")) {
+                    return false;
+                }
+                if (normalized.startsWith("devflow/50-history/fixes/") &&
+                    !normalized.endsWith("README.md")) {
+                    return false;
+                }
+                if (normalized.startsWith("devflow/50-history/rollbacks/") &&
+                    !normalized.endsWith("README.md")) {
+                    return false;
+                }
+                if (normalized.startsWith("devflow/20-discovery/discoveries/") &&
+                    !normalized.endsWith(".gitkeep") &&
+                    !normalized.endsWith("README.md")) {
+                    return false;
+                }
+                if (normalized.startsWith("devflow/20-discovery/decisions/") &&
+                    !normalized.endsWith(".gitkeep") &&
+                    !normalized.endsWith("README.md")) {
+                    return false;
+                }
                 if (matchesPrefix(normalized, "devflow/inbox") ||
                     matchesPrefix(normalized, "devflow/analysis") ||
                     matchesPrefix(normalized, "devflow/scratch") ||
@@ -77,6 +112,17 @@ async function copyEntry(entry, inventory) {
                     matchesPrefix(normalized, "devflow/reports") ||
                     matchesPrefix(normalized, "devflow/docs/playbooks") ||
                     matchesPrefix(normalized, "devflow/research") ||
+                    matchesPrefix(normalized, "devflow/10-ideation/inbox") ||
+                    matchesPrefix(normalized, "devflow/10-ideation/scratch") ||
+                    matchesPrefix(normalized, "devflow/10-ideation/brainstorm") ||
+                    matchesPrefix(normalized, "devflow/10-ideation/brainstorms") ||
+                    matchesPrefix(normalized, "devflow/20-discovery/analysis") ||
+                    matchesPrefix(normalized, "devflow/20-discovery/reports") ||
+                    matchesPrefix(normalized, "devflow/20-discovery/research") ||
+                    matchesPrefix(normalized, "devflow/20-discovery/scratch") ||
+                    matchesPrefix(normalized, "devflow/20-discovery/brainstorm") ||
+                    matchesPrefix(normalized, "devflow/20-discovery/brainstorms") ||
+                    matchesPrefix(normalized, "devflow/60-docs/playbooks") ||
                     matchesPrefix(normalized, "prototypes") ||
                     matchesPrefix(normalized, "evals") ||
                     matchesPrefix(normalized, ".nexus")) {
@@ -100,18 +146,26 @@ async function copyEntry(entry, inventory) {
     }
 }
 async function ensureEmptyDirectories() {
-    const discDir = path.join(templateRoot, "devflow", "discoveries");
-    const decDir = path.join(templateRoot, "devflow", "decisions");
-    const featDir = path.join(templateRoot, "devflow", "history", "features");
-    const fixDir = path.join(templateRoot, "devflow", "history", "fixes");
-    const rollDir = path.join(templateRoot, "devflow", "history", "rollbacks");
-    await fs.mkdir(discDir, { recursive: true });
-    await fs.mkdir(decDir, { recursive: true });
-    await fs.mkdir(featDir, { recursive: true });
-    await fs.mkdir(fixDir, { recursive: true });
-    await fs.mkdir(rollDir, { recursive: true });
-    await fs.writeFile(path.join(discDir, ".gitkeep"), "", "utf8");
-    await fs.writeFile(path.join(decDir, ".gitkeep"), "", "utf8");
+    const dirs = [
+        path.join(templateRoot, "devflow", "00-context"),
+        path.join(templateRoot, "devflow", "10-ideation"),
+        path.join(templateRoot, "devflow", "20-discovery"),
+        path.join(templateRoot, "devflow", "20-discovery", "discoveries"),
+        path.join(templateRoot, "devflow", "20-discovery", "decisions"),
+        path.join(templateRoot, "devflow", "30-planning"),
+        path.join(templateRoot, "devflow", "40-tasks"),
+        path.join(templateRoot, "devflow", "50-history"),
+        path.join(templateRoot, "devflow", "50-history", "features"),
+        path.join(templateRoot, "devflow", "50-history", "fixes"),
+        path.join(templateRoot, "devflow", "50-history", "rollbacks"),
+        path.join(templateRoot, "devflow", "60-docs")
+    ];
+    for (const dir of dirs) {
+        await fs.mkdir(dir, { recursive: true });
+    }
+    await fs.writeFile(path.join(templateRoot, "devflow", "20-discovery", "discoveries", ".gitkeep"), "", "utf8");
+    await fs.writeFile(path.join(templateRoot, "devflow", "20-discovery", "decisions", ".gitkeep"), "", "utf8");
+    await fs.writeFile(path.join(templateRoot, "devflow", "40-tasks", ".gitkeep"), "", "utf8");
 }
 async function sanitizeStarterFiles() {
     // 1. Sanitize AGENTS.md
@@ -154,7 +208,9 @@ This master ledger tracks all released delivery runs, milestones, and rollbacks
 - **\`fixes/\`**: Bug fixes, hotfixes, regressions, security patches, and performance optimizations.
 - **\`rollbacks/\`**: Safe feature reversal and rollback execution records.
 `;
-    await fs.writeFile(path.join(templateRoot, "devflow", "history", "HISTORY.md"), starterHistory, "utf8");
+    const historyPath = path.join(templateRoot, "devflow", "50-history", "HISTORY.md");
+    await fs.mkdir(path.dirname(historyPath), { recursive: true });
+    await fs.writeFile(historyPath, starterHistory, "utf8");
     // 3. Clean Starter ideas.md
     const starterIdeas = `# 🔮 Centralized Idea Inbox & Backlog
 
@@ -176,7 +232,9 @@ This master ledger tracks all released delivery runs, milestones, and rollbacks
 | ID | Title | Shipped In | Completed Date |
 | :--- | :--- | :--- | :--- |
 `;
-    await fs.writeFile(path.join(templateRoot, "devflow", "ideas.md"), starterIdeas, "utf8");
+    const ideasPath = path.join(templateRoot, "devflow", "10-ideation", "ideas.md");
+    await fs.mkdir(path.dirname(ideasPath), { recursive: true });
+    await fs.writeFile(ideasPath, starterIdeas, "utf8");
     // 4. Clean Starter project-overview.md
     const starterOverview = `# Project Overview & Source of Truth
 
@@ -206,7 +264,9 @@ This master ledger tracks all released delivery runs, milestones, and rollbacks
 ## 7. Known Architectural Focus Areas
 - Upcoming priorities, refactoring targets, or known technical considerations.
 `;
-    await fs.writeFile(path.join(templateRoot, "devflow", "context", "project-overview.md"), starterOverview, "utf8");
+    const overviewPath = path.join(templateRoot, "devflow", "00-context", "project-overview.md");
+    await fs.mkdir(path.dirname(overviewPath), { recursive: true });
+    await fs.writeFile(overviewPath, starterOverview, "utf8");
 }
 async function main() {
     const inventory = await loadCoreSkillInventory(path.join(repoRoot, "agent-bundle.manifest.json"));

package/dist/scripts/prepare-template.js.map

@@ -1 +1 @@
-{"version":3,"file":"prepare-template.js","sourceRoot":"","sources":["../../scripts/prepare-template.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"prepare-template.js","sourceRoot":"","sources":["../../scripts/prepare-template.ts"],"names":[],"mappings":"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"}

package/package.json

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

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

@@ -21,10 +21,10 @@ contract in `AGENTS.md`.
 ```text
 # 1. Ingest specific file from any path (PDF, DOCX, XLSX, Image, CSV, Text)
 /analyze C:\Users\...\Downloads\customer-spec.pdf
-/analyze ./mockup.png ./schema.xlsx "ระบบสะสมแต้มสมาชิก"
+/analyze ./mockup.png ./schema.xlsx "Loyalty point system"
 
 # 2. Ingest raw text or requirement from chat
-/analyze "ลูกค้าต้องการระบบผ่อนชำระ 0% เชื่อมกับ KBank Payment Gateway..."
+/analyze "Customer requested 0% installment plan connected to KBank Payment Gateway..."
 
 # 3. Scan pending unassigned files in devflow/inbox/
 /analyze
@@ -46,50 +46,50 @@ contract in `AGENTS.md`.
 
 ---
 
-### Step 1: Auto-Allocate Workspace & Ingestion (Frictionless Ingest)
+## Step 1: Auto-Allocate Workspace & Ingestion (Frictionless Ingest)
 1. **Allocate REQ-ID**: Generate sequential ID format `REQ-YYYYMMDD-NNN` (e.g. `REQ-20260903-001-point-system`).
 2. **Create Request Workspace**:
    ```text
    devflow/inbox/{REQ-ID}/
-   ├── raw/                # เก็บไฟล์ต้นฉบับ (PDF, Word, Excel, Images, Email)
-   ├── parsed.md           # ข้อความ/ตารางที่สกัดออกมาแล้ว (Clean Markdown)
-   └── clarifications.md   # รายการคำถามที่ต้องไปถาม Stakeholder เพิ่ม
+   ├── raw/                # Original source files (PDF, Word, Excel, Images, Email)
+   ├── parsed.md           # Extracted structured text/tables (Clean Markdown)
+   └── clarifications.md   # Questions and clarifications checklist for stakeholders
    ```
 3. Copy or save incoming files into `devflow/inbox/{REQ-ID}/raw/`.
 
 ---
 
-### Step 2: Parse & Normalize Requirement (`parsed.md`)
+## Step 2: Parse & Normalize Requirement (`parsed.md`)
 1. Extract text and tables from all raw files:
    - For Office/PDF docs: Invoke `convert-any-to-md` or document extractor.
    - For Web URLs / Confluence / Notion: Invoke `defuddle`.
    - For Images / Wireframes / Screenshots: Conduct Multimodal Vision OCR and describe layout and fields.
 2. Structure into `devflow/inbox/{REQ-ID}/parsed.md`:
-   - **Executive Summary**: วัตถุประสงค์หลักของ Requirement
-   - **Target Persona & User Stories**: ใครทำอะไร เพื่ออะไร
-   - **Functional Requirements (FR)**: รายการฟังก์ชันและ Business Rules
-   - **Non-Functional Requirements (NFR)**: Performance, Security, PDPA, Retention
-   - **Data Entities & Fields**: ฟิลด์ข้อมูลและชนิดข้อมูลเบื้องต้น
+   - **Executive Summary**: Core purpose and business objective of the requirement
+   - **Target Persona & User Stories**: Who performs what action and why
+   - **Functional Requirements (FR)**: List of functions and business rules
+   - **Non-Functional Requirements (NFR)**: Performance, Security, PDPA/Privacy, Data Retention
+   - **Data Entities & Fields**: Data fields, schemas, and initial types
 
 ---
 
-### Step 3: Codebase Impact & Blast Radius Analysis (`codebase-impact.md`)
-*(ดำเนินการเมื่อเป็นระบบเดิม / Brownfield Codebase)*
+## Step 3: Codebase Impact & Blast Radius Analysis (`codebase-impact.md`)
+*(Execute when operating on an existing system / brownfield codebase)*
 
 1. Search codebase patterns using `grep_search`, `rg`, and AST analysis for affected models, controllers, APIs, and routes.
 2. Calculate **Blast Radius & Complexity Score**:
-   - **Affected Files & Modules**: รายการไฟล์ที่ต้องแก้ไขหรือสร้างใหม่
-   - **API & Contract Breaking Risk**: ตรวจสอบว่ากระทบกับ API เดิมหรือ Third-Party หรือไม่
-   - **Complexity Rating**: `Low` | `Medium` | `High` | `Extreme` พร้อมเหตุผล
+   - **Affected Files & Modules**: List of files to be modified or newly created
+   - **API & Contract Breaking Risk**: Check if existing APIs or third-party contracts are impacted
+   - **Complexity Rating**: `Low` | `Medium` | `High` | `Extreme` with rationale
 3. Save analysis report to `devflow/analysis/{REQ-ID}/codebase-impact.md`.
 
 ---
 
-### Step 4: Socratic Gap Detection & Clarification Checklist (`clarifications.md`)
+## Step 4: Socratic Gap Detection & Clarification Checklist (`clarifications.md`)
 1. Apply `grilling` and `domain-modeling` lenses to detect gaps:
-   - **Missing Edge Cases**: เงื่อนไขขอบ, กรณีข้อมูลผิดพลาด, เน็ตหลุด, Concurrent Requests
-   - **Ambiguous Business Rules**: กฎที่ยังคลุมเครือ ไม่ระบุ SLA หรือขั้นตอนที่ชัดเจน
-   - **Security & Authorization**: การกำหนด Role, สิทธิ์การเข้าถึงข้อมูล, ข้อมูลส่วนบุคคล (PII)
+   - **Missing Edge Cases**: Boundary conditions, error states, network drops, concurrent requests
+   - **Ambiguous Business Rules**: Unclear policies, unspecified SLAs, or undefined workflows
+   - **Security & Authorization**: Role definitions, access permissions, personal identifiable data (PII)
 2. Generate an actionable checklist in `devflow/inbox/{REQ-ID}/clarifications.md` for the SA to take directly into stakeholder meetings.
 
 ---

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

@@ -110,14 +110,22 @@ the fresh-session handoff; Phase B must omit `Actual execution` so the legacy
 request and receipt keep both execution fields absent.
 
 1. Require an active spec with every build step checked and status `verified`, a
-   non-default work branch, a reliable merge base, and a clean working tree.
+   non-default work branch, a reliable merge base, and a working tree matching
+   the target except existing `devflow/context/{xxx-slug}/review.md` and
+   `devflow/context/{xxx-slug}/findings.md` evidence.
    Independent mode accepts only a locally recorded remote default branch,
    local `main`, or local `master` as its enforceable base ref. Stop when none
    reliably covers the active work.
-   The current full `HEAD` must be the approved review checkpoint, including the
-   verified spec. Never create that commit inside Audit. If work is dirty, stop
-   and ask the user to approve a review checkpoint through `/implement`, even
-   when normal checkpoint commits are disabled.
+   The current full `HEAD` must be the approved application-code checkpoint.
+   Include the verified spec when tracked; for a new ignored-spec request, prepare
+   the exact local `Spec snapshot` under the reference contract. Never force-add
+   it or change ignore visibility. Never create a commit inside Audit. If any
+   tracked, staged, unstaged, or untracked path other than those two evidence
+   paths differs from the target, stop and ask the user to approve a review
+   checkpoint through `/implement`, even when normal checkpoint commits are
+   disabled. Do not create a checkpoint solely for review/findings changes.
+   This normal Phase A exception never allows snapshot Git differences or
+   overwriting conflicting completion-recovery evidence.
 2. Read installed adapters from `.nexus/nexus-devflow.json` or manifest when valid.
    Detect `.agents/skills` as `antigravity`/`codex`/`copilot` and `.claude/skills`
    as `claude`.
@@ -133,32 +141,37 @@ request and receipt keep both execution fields absent.
      isolated child through the current runtime. Do not discover, select, or
      depend on a globally installed role, skill, prompt, or another workflow
      such as TraversyFlow. If the runtime cannot start that generic child from
-     project-local instructions, or capability, isolation, identity, model, or
-     completion cannot be confirmed, use the manual path.
+     project-local instructions, or capability, isolation, identity, model,
+     completion, or access to the same ignored spec/snapshot inputs cannot be
+     confirmed, use the manual path in the original checkout.
 4. Record the full target SHA, full merge-base SHA, the exact local base ref
    used to calculate it, exact spec SHA-256, current adapter and model,
    requested reviewer adapter and model, requested execution from
    `review.independentExecution`, workflow, and
-   whether the configured Check gate is required. Write the pending template
-   into `devflow/context/{xxx-slug}/review.md`.
+   whether the configured Check gate is required. For a new ignored-spec request,
+   create or reuse the exact snapshot first and record `Spec snapshot` as defined
+   in the reference. Never add that field to an existing pending or completed
+   record. Write the pending template into `devflow/context/{xxx-slug}/review.md`.
 5. Execute the configured path:
    - For `manual`, set dashboard activity to `ready` and give the exact handoff
      command for the selected adapter. Claude Code uses
      `/audit independent current`; Google Antigravity uses
      `/audit independent current`; Codex uses `$audit independent current`;
      Copilot and OpenCode receive the equivalent plain-language instruction.
-     Tell the user to open a fresh session with only the handoff, not the builder
-     chat.
+     Tell the user to open a fresh session in the original checkout with only the
+     handoff, not the builder chat. Include target/base SHAs and, when present,
+     the exact snapshot path and spec hash.
    - For `automatic`, freeze all parent product, test, spec, and config changes.
      Start one generic isolated child without the builder transcript. Instruct
      it to read the project-local Audit skill and
      `reference/independent-review.md` from the current adapter tree, then
-     execute Phase B against the prepared request. All review instructions come
-     from that installed DevFlow project. The reviewer may write only
-     `devflow/context/{xxx-slug}/findings.md` and `devflow/context/{xxx-slug}/review.md`; it must
-     not repair code, change the spec, commit, or perform external actions. Wait
-     for completion, then reread and validate the normal receipt before
-     continuing. Record `fresh subagent` as its reviewer context.
+     execute Phase B using the same local spec/snapshot inputs against the
+     prepared request. All review instructions come from that installed DevFlow
+     project. The reviewer may write only `devflow/context/{xxx-slug}/findings.md`
+     and `devflow/context/{xxx-slug}/review.md`; it must not repair code, change
+     the spec, commit, or perform external actions. Wait for completion, then
+     reread and validate the normal receipt before continuing. Record `fresh subagent`
+     as its reviewer context.
 
 If automatic execution fails or any required property becomes uncertain, keep
 the pending request intact, set activity to `ready`, and stop with the existing
@@ -177,7 +190,9 @@ Use this phase when a current pending request exists in `devflow/context/{xxx-sl
    `HEAD` matches `Target commit`, the recorded base ref still produces the
    recorded merge base, the exact spec hash matches, and no path differs from
    the target except `devflow/context/{xxx-slug}/review.md` and
-   `devflow/context/{xxx-slug}/findings.md`. Stop on any mismatch or stale state.
+   `devflow/context/{xxx-slug}/findings.md`. When `Spec snapshot` is present, verify
+   both raw spec/snapshot hashes and every path, visibility, and Git condition in
+   the reference. Stop on any mismatch or stale state.
 2. Proceed only from the fresh reviewer handoff. Record `fresh session` for a
    manual reviewer or `fresh subagent` for an automatic isolated reviewer. This
    is a declaration, never cryptographic proof. If the reviewer has the builder
@@ -206,6 +221,9 @@ Use this phase when a current pending request exists in `devflow/context/{xxx-sl
 After changes are requested, the builder repairs through `/implement`, obtains
 approval for a new checkpoint, and prepares a new request. The next reviewer
 pass reviews the complete new delta, not only the old findings.
+A local-spec-only revision may reuse the same approved product HEAD after normal
+spec and verification gates, with a new snapshot/request and full fresh review;
+it never requires an empty commit.
 
 ## Step 1 - gather context
 

package/template/.agents/skills/audit/reference/independent-review.md

@@ -68,6 +68,56 @@ work branch, and `Base commit` cannot equal `Target commit`. If none of those
 base refs reliably covers the active work, stop instead of creating a receipt
 whose review range cannot be re-derived.
 
+## Local spec snapshot
+
+For a new request whose verified spec is intentionally ignored, keep application
+code in the approved checkpoint and freeze the spec outside Git. Add exactly one
+field after `Spec hash`, using a plain path with no backticks:
+
+```markdown
+**Spec snapshot:** devflow/.state/review-specs/<Target commit>-<Spec hash>.md
+```
+
+Substitute the request's full lowercase target SHA and lowercase spec hash. This
+is the only permitted snapshot path; duplicate fields or another path are
+malformed. Tracked-spec requests do not need this field. Existing requests and
+receipts without it retain their previous hash, freshness, and execution rules.
+Never retroactively add `Spec snapshot` to a pending or completed record.
+
+Phase A prepares the copy before publishing a new pending request:
+
+1. Read the verified active spec as raw bytes and calculate its SHA-256 without
+   decoding, trimming, or normalizing line endings. Use that digest as `Spec hash`.
+2. Use `lstat` on the selected project root and every directory below it leading
+   to the spec and snapshot. Require ordinary directories, a regular spec file,
+   and a regular file for any existing snapshot. Reject symbolic links, including
+   dangling links. Ancestor aliases above the selected root are not inspected.
+   Create missing snapshot directories only beneath verified ordinary parents;
+   a missing snapshot leaf is allowed only for exclusive creation below them.
+3. Require both paths to be ignored and untracked, absent from the index and
+   `Target commit`. Check ignore status separately for each path, require no
+   entries from `git ls-files --stage -- <spec-path> <snapshot-path>` or
+   `git ls-tree -r --name-only <target> -- <spec-path> <snapshot-path>`, and
+   distinguish expected absence from Git failure. Never force-add files or
+   change ignore visibility to make these checks pass.
+4. Create the snapshot exclusively, for example with Node's `fs.open` using
+   `wx`, then write the raw byte buffer and close the handle. If it already
+   exists, reuse only an ordinary file whose bytes exactly match the spec.
+   Conflicting bytes, unsafe paths, or a failed write stop preparation; never
+   overwrite or repair the existing snapshot in place.
+5. Read both files back and require identical raw bytes and the recorded hash.
+   Recheck their path and Git conditions before writing the request. Keep the
+   snapshot unchanged through review and completion; do not automatically delete
+   or regenerate it to make an existing receipt pass.
+
+The target/base fields bind application code; `Spec hash` binds both local files.
+The snapshot is an input, never another allowed dirty Git path. Manual handoff
+names the original checkout, target/base SHAs, snapshot path, and hash. An
+automatic child must be able to read those same ignored inputs and installed
+project-local skills. If that access cannot be confirmed, retain the request and
+use the manual fresh-session handoff in the original checkout. Do not copy local
+inputs externally or substitute a clone/worktree that lacks them.
+
 ## Completed receipt
 
 Keep the request fields unchanged and replace `pending` with `passed` or
@@ -131,6 +181,9 @@ A receipt is current only when all of these hold:
   equals `Base commit`, and it remains a locally recorded remote default branch,
   local `main`, or local `master`.
 - The exact task spec bytes still match `Spec hash`.
+- When `Spec snapshot` is present, both raw files match that hash and every
+  snapshot path, visibility, and Git condition above still holds. Missing or
+  changed snapshot inputs make the record stale; Git failure never passes.
 - No tracked, staged, unstaged, or untracked path differs from the target except
   `devflow/context/{xxx-slug}/review.md` and `devflow/context/{xxx-slug}/findings.md`.
 - The completed reviewer adapter matches `Requested reviewer`.
@@ -149,8 +202,11 @@ A receipt is current only when all of these hold:
   record the actual value.
 
 Any other code, test, configuration, spec, or acceptance-criteria change makes
-the receipt stale. A stale receipt never proves the new state. Prepare a new
-request against a new approved checkpoint and review the whole delta again.
+the receipt stale. A stale receipt never proves the new state. Product changes
+need a new approved checkpoint. A local-spec-only revision may reuse the same
+approved product HEAD after normal spec and verification gates, with a new
+snapshot, a new request, and a full fresh review. Never create an empty commit
+just to capture ignored spec changes or edit a passed receipt into a new review.
 
 The adapter, model, and context fields are declared metadata. DevFlow proves
 the target and staleness, but it cannot cryptographically prove that a separate

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

@@ -37,7 +37,7 @@ Provide at least 2-3 materially distinct approaches:
 ### 3. Trade-off Comparison Matrix
 Construct a structured evaluation table:
 
-| Option | Pros (ข้อดี) | Cons (ข้อเสีย) | Effort & Complexity | Verdict / Status |
+| Option | Pros | Cons | Effort & Complexity | Verdict / Status |
 | :--- | :--- | :--- | :--- | :--- |
 | **Option A** | ... | ... | Low / Med / High | ... |
 | **Option B** | ... | ... | Low / Med / High | **Recommended** |

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

@@ -33,6 +33,15 @@ passes.
 Read `devflow/config.json`. A missing file means the built-in defaults apply.
 If the file exists but is invalid, stop and point the user to `/doctor`.
 
+Before requiring a real active spec, check for pending completion using
+`reference/completion-recovery.md`. A matching archive may mean archival was
+interrupted, the work commit awaits merge, or the merge already finished. Follow
+that phase instead of restarting logging. Missing or ambiguous evidence stops
+with concrete recovery steps; an archive or clean context never authorizes selecting new work.
+Recovery uses archive and Git proof, never dashboard activity as authority.
+
+For a normal completion with no recovery in progress, continue below.
+
 Confirm the target work is actually finished: `devflow/context/{xxx-slug}/spec.md`
 holds a real spec, its steps are built on a branch, and `Verify`, or the fallback
 build and tests, passes. If any of the
@@ -45,6 +54,7 @@ Read `devflow/context/{xxx-slug}/review.md` (or `devflow/context/review.md`) whe
 changes-requested, malformed, or stale record is always a blocker because the
 user already initiated that gate, even when its configured policy is `manual`.
 
+
 ## Configured regular quality gates
 
 Use `qualityGates.regular` for this work item:
@@ -103,6 +113,15 @@ evidence is missing.
 
 ## Step 1 - log the work
 
+Follow `reference/completion-recovery.md` to capture the source tree and compact
+archive annotation before any logging edits. Preserve the exact verified spec
+prefix, its UTF-8 byte length and SHA-256, branch, original HEAD, and local base.
+Record the reference's narrow `absentOptional` proof before creating any optional
+findings/review stub on an older installation; tree absence alone is insufficient.
+Prepare the entire archive, including the sections below and any generated try
+guide, before placing it at its destination in `devflow/history/features/`, `fixes/`, or `rollbacks/`. An existing matching archive
+enters recovery; never overwrite it or append duplicate sections.
+
 Check whether the spec is a feature, fix, or rollback. A fix is marked
 `Type: Fix` and has no build-plan number. A rollback is marked `Type: Rollback`
 and records the exact target feature, archive, commit, and parent.
@@ -122,11 +141,14 @@ delete the `prototypes/` folder now.
 
 ## Step 2 - make the work commit on feature branch
 
-Stage everything on the branch (any uncommitted step work plus the Step 1 logging
+Show the complete product and logging diff with the proposed commit message,
+then obtain explicit commit approval. Only then stage the reviewed branch work
+(any uncommitted step work plus the Step 1 logging
 changes) and make one conventional work commit on the active branch (for example `feat: <feature>`,
 `fix: <name>`, or `revert: roll back <feature>`). `Verify`, or the fallback build
 and tests, must pass first.
 
+
 ## Step 3 - Mandatory Delivery Gate (Ask User First)
 
 > [!IMPORTANT]