@jakkrichm/create-nexus-devflow 2.6.0 → 2.6.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (79) hide show
  1. package/dist/lib/branch-context.d.ts +61 -8
  2. package/dist/lib/branch-context.js +370 -125
  3. package/dist/lib/branch-context.js.map +1 -1
  4. package/dist/lib/current-work.js +15 -108
  5. package/dist/lib/current-work.js.map +1 -1
  6. package/dist/lib/discoveries.js +4 -15
  7. package/dist/lib/discoveries.js.map +1 -1
  8. package/dist/lib/history.js +1 -1
  9. package/dist/lib/history.js.map +1 -1
  10. package/dist/lib/status.d.ts +2 -0
  11. package/dist/lib/status.js +9 -16
  12. package/dist/lib/status.js.map +1 -1
  13. package/package.json +1 -1
  14. package/template/.agents/skills/adopt/SKILL.md +1 -1
  15. package/template/.agents/skills/audit/SKILL.md +1 -1
  16. package/template/.agents/skills/autopilot/SKILL.md +1 -1
  17. package/template/.agents/skills/brainstorm/SKILL.md +2 -2
  18. package/template/.agents/skills/brief/SKILL.md +1 -1
  19. package/template/.agents/skills/check/SKILL.md +5 -3
  20. package/template/.agents/skills/ci/SKILL.md +1 -1
  21. package/template/.agents/skills/complete/SKILL.md +9 -3
  22. package/template/.agents/skills/convert-any-to-md/SKILL.md +1 -1
  23. package/template/.agents/skills/debug/SKILL.md +1 -1
  24. package/template/.agents/skills/devflow/SKILL.md +1 -1
  25. package/template/.agents/skills/discovery/SKILL.md +1 -1
  26. package/template/.agents/skills/doctor/SKILL.md +1 -1
  27. package/template/.agents/skills/feature/SKILL.md +10 -5
  28. package/template/.agents/skills/fix/SKILL.md +6 -8
  29. package/template/.agents/skills/grill/SKILL.md +3 -3
  30. package/template/.agents/skills/idea/SKILL.md +3 -3
  31. package/template/.agents/skills/implement/SKILL.md +10 -4
  32. package/template/.agents/skills/onboard/SKILL.md +1 -1
  33. package/template/.agents/skills/overview/SKILL.md +1 -1
  34. package/template/.agents/skills/prototype/SKILL.md +1 -1
  35. package/template/.agents/skills/release/SKILL.md +1 -1
  36. package/template/.agents/skills/report-html/SKILL.md +13 -13
  37. package/template/.agents/skills/rollback/SKILL.md +1 -1
  38. package/template/.agents/skills/status/SKILL.md +1 -1
  39. package/template/.agents/skills/test/SKILL.md +5 -5
  40. package/template/.agents/skills/tests/SKILL.md +1 -1
  41. package/template/.agents/skills/try/SKILL.md +1 -1
  42. package/template/.claude/skills/adopt/SKILL.md +1 -1
  43. package/template/.claude/skills/audit/SKILL.md +1 -1
  44. package/template/.claude/skills/autopilot/SKILL.md +1 -1
  45. package/template/.claude/skills/brainstorm/SKILL.md +2 -2
  46. package/template/.claude/skills/brief/SKILL.md +1 -1
  47. package/template/.claude/skills/check/SKILL.md +5 -3
  48. package/template/.claude/skills/ci/SKILL.md +1 -1
  49. package/template/.claude/skills/complete/SKILL.md +9 -3
  50. package/template/.claude/skills/convert-any-to-md/SKILL.md +1 -1
  51. package/template/.claude/skills/debug/SKILL.md +1 -1
  52. package/template/.claude/skills/devflow/SKILL.md +1 -1
  53. package/template/.claude/skills/discovery/SKILL.md +1 -1
  54. package/template/.claude/skills/doctor/SKILL.md +1 -1
  55. package/template/.claude/skills/feature/SKILL.md +10 -5
  56. package/template/.claude/skills/fix/SKILL.md +6 -8
  57. package/template/.claude/skills/grill/SKILL.md +3 -3
  58. package/template/.claude/skills/idea/SKILL.md +3 -3
  59. package/template/.claude/skills/implement/SKILL.md +10 -4
  60. package/template/.claude/skills/onboard/SKILL.md +1 -1
  61. package/template/.claude/skills/overview/SKILL.md +1 -1
  62. package/template/.claude/skills/prototype/SKILL.md +1 -1
  63. package/template/.claude/skills/release/SKILL.md +1 -1
  64. package/template/.claude/skills/report-html/SKILL.md +13 -13
  65. package/template/.claude/skills/rollback/SKILL.md +1 -1
  66. package/template/.claude/skills/status/SKILL.md +1 -1
  67. package/template/.claude/skills/test/SKILL.md +5 -5
  68. package/template/.claude/skills/tests/SKILL.md +1 -1
  69. package/template/.claude/skills/try/SKILL.md +1 -1
  70. package/template/AGENTS.md +1 -1
  71. package/template/devflow/build-plan.md +13 -1
  72. package/template/devflow/context/ai-interaction.md +1 -1
  73. package/template/devflow/context/coding-standards.md +2 -2
  74. package/template/devflow/decisions/README.md +1 -1
  75. package/template/devflow/history/features/README.md +1 -1
  76. package/template/devflow/history/fixes/README.md +1 -1
  77. package/template/devflow/history/rollbacks/README.md +1 -1
  78. package/template/devflow/reference/mockup.html +16 -31
  79. package/template/devflow/reference/running-id-contract.md +24 -20
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: devflow
3
- description: "[devflow][B] Flagship interactive guide, state inspector, and intent router for DevFlow workflows."
3
+ description: "[devflow] Flagship interactive guide, state inspector, and intent router for DevFlow workflows."
4
4
  ---
5
5
 
6
6
  # devflow - Interactive Workflow Guide & Intent Router for Nexus-DevFlow
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: discovery
3
- description: "[devflow][D] Unified discovery and exploration stage in DevFlow 2.5.0 - conducts project-level roadmap discovery (project-plan.md/build-plan.md) or feature-level pre-delivery exploration before the Single Living Spec lifecycle."
3
+ description: "[devflow] Unified discovery and exploration stage in DevFlow 2.5.0 - conducts project-level roadmap discovery (project-plan.md/build-plan.md) or feature-level pre-delivery exploration before the Single Living Spec lifecycle."
4
4
  argument-hint: "[{title, request, IDEA-xxx, or discovery-id}]"
5
5
  ---
6
6
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: doctor
3
- description: "[devflow][B] Run a read-only Blueprint health check for setup, onboarding, required files, tool adapters, commands, optional verification and CI, Blueprint visibility, ignore rules, planning readiness, overview freshness, and workflow drift. Use when the user runs /doctor, asks whether the Blueprint is installed correctly, wants a health check, setup check, doctor pass, or says something feels off before starting or resuming work."
3
+ description: "[devflow] Run a read-only Blueprint health check for setup, onboarding, required files, tool adapters, commands, optional verification and CI, Blueprint visibility, ignore rules, planning readiness, overview freshness, and workflow drift. Use when the user runs /doctor, asks whether the Blueprint is installed correctly, wants a health check, setup check, doctor pass, or says something feels off before starting or resuming work."
4
4
  ---
5
5
 
6
6
  # doctor - Blueprint health check
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: feature
3
- description: "[devflow][F] Turn a feature from build-plan.md into a buildable spec. With no argument, specs the next unchecked item in the build plan; given a number or name, specs that one. If a clearly new feature does not match the plan, proposes a reviewed plan addition, refreshes the overview after approval, then specs it. Sizes the feature and splits anything too big into smaller sub-features (4a, 4b, ...), writes small, reviewable build steps to devflow/context/current-feature.md, then red-teams its own draft for gaps, oversized steps, and scope creep before stopping at a review gate. Use when the user runs /feature, names or numbers a feature, asks to add and start a new feature, or asks to spec out, break down, or start the next feature."
3
+ description: "[devflow] Turn a feature from build-plan.md into a buildable living spec. Supports Multi-Run Spec Queue: drafts dedicated context in devflow/context/{xxx-slug}/ without blocking additional specs. With no argument, specs the next unchecked item; given a number or name, specs that one. Sizes and splits large items (4a, 4b), generates TDD checklist steps, red-teams the draft, and stops at review gate. Use when running /feature, naming a feature, or drafting the next living spec."
4
+ argument-hint: "[{number, name, DISC-id, or IDEA-id}]"
4
5
  ---
5
6
 
6
7
  # feature - turn a build-plan feature into a buildable spec
@@ -8,18 +9,22 @@ description: "[devflow][F] Turn a feature from build-plan.md into a buildable sp
8
9
  Where this sits in the workflow:
9
10
 
10
11
  project-overview.md + build-plan.md -> [this skill] -> build
11
- (source of truth, (which feature (the spec for (code,
12
- from /overview) to build) one feature) reviewed)
12
+ (source of truth, (which feature (the spec in (code,
13
+ from /overview) to build) contexts/xxx/) reviewed)
13
14
 
14
15
  `build-plan.md` is intentionally high-level - one line per feature, no detail,
15
16
  no ordering ceremony. All of that is this skill's job: take one listed feature,
16
17
  read the full context from `project-overview.md`, and turn it into something
17
- buildable.
18
+ buildable in `devflow/context/{xxx-slug}/spec.md`.
19
+
20
+ ## Multi-Run Spec-Ahead Support
21
+
22
+ `/feature` supports drafting multiple specs ahead of time. Creating a spec creates a dedicated workspace directory at `devflow/context/{xxx-slug}/` and does **not block** drafting subsequent features.
18
23
 
19
24
  ## Input
20
25
 
21
26
  A feature from `build-plan.md`, by number or name - e.g. `/feature 3` or
22
- `/feature "typing engine"`.
27
+ `/feature "typing engine"` or `/feature DISC-20260826-001`.
23
28
 
24
29
  The request may also describe a genuinely new feature that is not in the build
25
30
  plan yet. That goes through the new-feature intake in Step 1. Never silently add
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: fix
3
- description: "[devflow][F] Document an ad-hoc bug fix or small change (one not in the build plan) into devflow/context/current-feature.md so it runs through the same build loop. Writes a short fix spec and stops; then /implement builds it and /complete logs it to devflow/history/fixes/ and merges. Use when the user runs /fix, reports a bug, or asks to fix or change something that isn't a planned build-plan feature."
3
+ description: "[devflow] Document an ad-hoc bug fix or small change (one not in the build plan) into devflow/context/{xxx-slug}/spec.md so it runs through the same build loop. Supports Multi-Run: drafts dedicated fix context and allows selective /implement [id]. Writes a short fix spec and stops; then /implement builds it and /complete logs it to devflow/history/fixes/ and merges. Use when running /fix, reporting a bug, or fixing an ad-hoc issue."
4
+ argument-hint: "[{title or issue-description}]"
4
5
  ---
5
6
 
6
7
  # fix - document an ad-hoc fix, then build it like anything else
@@ -13,7 +14,7 @@ Where this sits in the workflow:
13
14
 
14
15
  A fix is a bug or small change that isn't a planned build-plan feature. It runs
15
16
  through the same loop as a feature (build with review gates, iterate, then merge);
16
- it just starts here instead of `/feature`, and is logged separately.
17
+ it creates a dedicated run folder at `devflow/context/{xxx-slug}/` (e.g. `059-fix-login-error`).
17
18
 
18
19
  ## Input
19
20
 
@@ -21,16 +22,13 @@ A description of the bug or change, for example `/fix "password reset email neve
21
22
  sends"`. If the user just reported the problem in chat, use that.
22
23
 
23
24
  The input may also be a finding ID from `devflow/context/findings.md`, alone
24
- or with a description, for example `/fix F-03`. Pull the problem statement from
25
- that ledger entry. Use this form only between work items, when
26
- `current-feature.md` is the reset stub: this skill overwrites that file, so
27
- while a spec is active, repair its findings through `/implement` instead.
25
+ or with a description, for example `/fix F-03`.
28
26
 
29
27
  ## Step 1 - write the fix spec
30
28
 
31
29
  Pull context from `devflow/context/project-overview.md` and `devflow/context/coding-standards.md`,
32
- then write a short spec to `devflow/context/current-feature.md` (this file holds whatever
33
- is being built now, feature or fix). Keep it lighter than a feature spec:
30
+ calculate the next sequential running ID (e.g. `059-fix-slug`),
31
+ then write a short spec to `devflow/context/{xxx-slug}/spec.md` (and update `devflow/context/current-feature.md`). Keep it lighter than a feature spec:
34
32
 
35
33
  - **Title** - the bug or change in a few words.
36
34
  - **Type:** Fix (so `/complete` logs it to `devflow/history/fixes/`, not `devflow/history/features/`).
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: grill
3
- description: "[devflow][B] Interactive Socratic alignment & domain modeling - stress-test plans, extract domain glossary, and record architecture decision records (ADRs) before delivery."
3
+ description: "[devflow] Interactive Socratic alignment & domain modeling - stress-test plans, extract domain glossary, and record architecture decision records (ADRs) before delivery."
4
4
  argument-hint: "{topic, plan, or question}"
5
5
  ---
6
6
 
@@ -89,5 +89,5 @@ Allocate the next sequential ID (`ADR-001`, `ADR-002`, ...) and create `devflow/
89
89
  When all design branches are resolved:
90
90
  1. Summarize settled domain terms and created ADRs.
91
91
  2. Provide explicit next command recommendations:
92
- - **Fast-Track (Standard Features/Fixes)**: Run `/feature {topic}` or `/fix {topic}` to immediately start the living spec.
93
- - **Deep-Track (Large Architectural Epics)**: Run `10-define` or `/discovery` with the discovery context.
92
+ - **Living Spec (Standard Delivery)**: Run `/feature {topic}` or `/fix {topic}` to immediately start the living spec.
93
+ - **Pre-Flight Discovery**: Run `/discovery {topic}` to conduct comprehensive discovery exploration before specification.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: idea
3
- description: "[devflow][B] Quick idea capture and AI enrichment - analyze feasibility, value, key points, and record into devflow/ideas.md inbox."
3
+ description: "[devflow] Quick idea capture and AI enrichment - analyze feasibility, value, key points, and record into devflow/ideas.md inbox."
4
4
  argument-hint: "\"<idea text or description>\""
5
5
  ---
6
6
 
@@ -44,7 +44,7 @@ Insert the new idea block directly under `## 📌 Pending Ideas` in `devflow/ide
44
44
  - **Quick Seed (กันลืม)**:
45
45
  1. {ประเด็นสำคัญที่ 1}
46
46
  2. {ประเด็นสำคัญที่ 2}
47
- - **สถานะ**: `Pending` (หยิบไปทำได้ด้วย `/spec IDEA-001` หรือ `/00-explore IDEA-001`)
47
+ - **สถานะ**: `Pending` (หยิบไปทำได้ด้วย `/feature IDEA-001` หรือ `/discovery IDEA-001`)
48
48
  ```
49
49
 
50
50
  *(หากมีข้อความ `*(ยังไม่มีไอเดียค้างอยู่...)*` ให้ลบออกเมื่อมีไอเดียแรก)*
@@ -54,4 +54,4 @@ Report to the user:
54
54
  - Allocated Idea ID: `[IDEA-xxx]`
55
55
  - Summary of Feasibility & Value analysis
56
56
  - Seed points saved
57
- - Instructions for promotion: "เมื่อพร้อมลงมือทำ สามารถพิมพ์ `/spec IDEA-xxx` หรือ `/00-explore IDEA-xxx` ได้ทันที"
57
+ - Instructions for promotion: "เมื่อพร้อมลงมือทำ สามารถพิมพ์ `/feature IDEA-xxx` หรือ `/discovery IDEA-xxx` ได้ทันที"
@@ -1,9 +1,10 @@
1
1
  ---
2
2
  name: implement
3
- description: "[devflow][F] Build the feature, fix, or rollback spec'd in devflow/context/current-feature.md, one small reviewable step at a time. Creates the matching branch, implements each step, shows the diff and explains it in plain English, tests, and iterates until it works. Type: Rollback specs use a guarded reverse patch that preserves Blueprint history. After each approved step it offers an optional commit checkpoint on the branch; the work-level commit, merge, and logging are /complete's job. Use when the user runs /implement, or asks to build, implement, or start the current feature, fix, or rollback once its spec is ready."
3
+ description: "[devflow] Build the feature, fix, or rollback spec, one small reviewable step at a time with Strict TDD. Supports Multi-Run: given an optional ID or name (/implement 12, /implement 012), targets that spec from devflow/context/{xxx-slug}/. Checks out matching branch, runs pre-flight drift revalidation, executes TDD steps with diffs, and offers commit checkpoints. Use when running /implement, or starting work on a spec."
4
+ argument-hint: "[{run-id, number, or name}]"
4
5
  ---
5
6
 
6
- # implement - build the current spec, one reviewed step at a time
7
+ # implement - build the target spec, one reviewed step at a time
7
8
 
8
9
  Where this sits in the workflow:
9
10
 
@@ -12,7 +13,7 @@ Where this sits in the workflow:
12
13
  reviewed) merge + log)
13
14
 
14
15
  `/feature`, `/fix`, or `/rollback` wrote the spec to
15
- `devflow/context/current-feature.md` and stopped.
16
+ `devflow/context/{xxx-slug}/spec.md` (or `devflow/context/current-feature.md`) and stopped.
16
17
  This skill turns that spec into code, following the build loop in
17
18
  `devflow/context/ai-interaction.md`, without vibe coding: small steps, a visible diff plus
18
19
  a plain-English explanation for each, testing, and iteration until it works, all
@@ -20,9 +21,14 @@ behind your approval. It builds on a branch and offers an optional commit
20
21
  checkpoint after each step; the work-level commit, merging, and logging are
21
22
  `/complete`'s job.
22
23
 
24
+ ## Multi-Run Target Resolution
25
+
26
+ - **Given an ID or name** (e.g. `/implement 12`, `/implement 012`, `/implement kanban`) -> locates the matching run folder `devflow/context/{xxx-slug}/`, checks out `feature/{xxx-slug}`, and loads only that run's `spec.md`.
27
+ - **With no argument** (`/implement`) -> checks current git branch, or auto-picks if only 1 spec is active, or prompts the user if multiple specs are queued.
28
+
23
29
  ## Before you start
24
30
 
25
- Read `devflow/context/current-feature.md`. If it has no real spec (still the stub, or its
31
+ Read the target spec from `devflow/context/{xxx-slug}/spec.md` (or `devflow/context/current-feature.md`). If it has no real spec (still the stub, or its
26
32
  status is already complete), stop and tell the user to run `/feature` (for a
27
33
  planned feature), `/fix` (for an ad-hoc bug or change), or `/rollback` (for a
28
34
  completed feature reversal) first. Pull the
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: onboard
3
- description: "[devflow][B] Set up the Blueprint after overlaying it onto a freshly scaffolded or early project. Detects the stack, tunes project files and adapters, documents real commands and existing checks, points to the optional standalone CI setup, and tells the user what to fill in before /overview or $overview. Use when the user runs /onboard, invokes $onboard, just copied the Blueprint into a new project, or asks what to do after overlaying the Blueprint. For an existing app with meaningful shipped features, use adopt instead."
3
+ description: "[devflow] Set up the Blueprint after overlaying it onto a freshly scaffolded or early project. Detects the stack, tunes project files and adapters, documents real commands and existing checks, points to the optional standalone CI setup, and tells the user what to fill in before /overview or $overview. Use when the user runs /onboard, invokes $onboard, just copied the Blueprint into a new project, or asks what to do after overlaying the Blueprint. For an existing app with meaningful shipped features, use adopt instead."
4
4
  ---
5
5
 
6
6
  # onboard - finish the Blueprint overlay setup
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: overview
3
- description: "[devflow][B] Distill user-owned planning docs into `devflow/context/project-overview.md` using a deterministic compiler. The overview is the living source of truth that agents read every session."
3
+ description: "[devflow] Distill user-owned planning docs into `devflow/context/project-overview.md` using a deterministic compiler. The overview is the living source of truth that agents read every session."
4
4
  ---
5
5
 
6
6
  # overview - dynamic project overview compiler
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: prototype
3
- description: "[devflow][B] Interactively prototype the look of a project. Asks about the desired look and feel and which pages to draft, proposes a plan, and only then writes throwaway static HTML/CSS mockups to prototypes/ that share one theme (a set of CSS theme variables). A plan-first, pre-build helper that sits outside the spec-driven feature loop, like scaffolding. Use when the user runs /prototype, names screens to mock up, or asks to prototype the layout, theme, or look and feel."
3
+ description: "[devflow] Interactively prototype the look of a project. Asks about the desired look and feel and which pages to draft, proposes a plan, and only then writes throwaway static HTML/CSS mockups to prototypes/ that share one theme (a set of CSS theme variables). A plan-first, pre-build helper that sits outside the spec-driven feature loop, like scaffolding. Use when the user runs /prototype, names screens to mock up, or asks to prototype the layout, theme, or look and feel."
4
4
  ---
5
5
 
6
6
  # prototype - lock the look before you build
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: release
3
- description: "[devflow][B] Prepare a Blueprint project for deployment to Render or Vercel. Reads the plans, project commands, app config, and current repo state; verifies build, start, output, env, health checks, and provider config; can create or update render.yaml or vercel.json when requested; and stops before any external deploy, service creation, remote env change, push, publish, or destructive action unless the user explicitly approves. Use when the user runs /release, invokes $release, asks for Render setup, Vercel setup, deploy readiness, deployment config, render.yaml, or vercel.json."
3
+ description: "[devflow] Prepare a Blueprint project for deployment to Render or Vercel. Reads the plans, project commands, app config, and current repo state; verifies build, start, output, env, health checks, and provider config; can create or update render.yaml or vercel.json when requested; and stops before any external deploy, service creation, remote env change, push, publish, or destructive action unless the user explicitly approves. Use when the user runs /release, invokes $release, asks for Render setup, Vercel setup, deploy readiness, deployment config, render.yaml, or vercel.json."
4
4
  ---
5
5
 
6
6
  # release - deployment readiness for Render and Vercel
@@ -1,21 +1,21 @@
1
1
  ---
2
2
  name: report-html
3
- description: "[devflow][B] Standalone HTML Report Generator - render an interactive standalone HTML dashboard from current-feature.md or 60-report.md on demand."
4
- argument-hint: "{running-id or workspace path}"
3
+ description: "[devflow] Standalone HTML Report Generator - render an interactive standalone HTML dashboard from current-feature.md or history archives on demand."
4
+ argument-hint: "[{running-id or workspace path}]"
5
5
  ---
6
6
 
7
7
  # Standalone: Report HTML
8
8
 
9
9
  $ARGUMENTS
10
10
 
11
- Standalone companion command to generate an interactive, self-contained HTML report dashboard on demand from either a Fast-Track `current-feature.md` or a Deep-Track `60-report.md`.
11
+ Standalone companion command to generate an interactive, self-contained HTML report dashboard on demand from `current-feature.md`, task-specific context `devflow/context/{xxx-slug}/spec.md`, or archived history files in `devflow/history/`.
12
12
 
13
13
  > [!NOTE]
14
- > HTML reports are **never automatically generated** during normal mainline stages (`/complete` or `60-report`). Use this command whenever you or stakeholders wish to view or share an interactive web report.
14
+ > HTML reports are **never automatically generated** during normal mainline stages (`/complete`). Use this command whenever you or stakeholders wish to view or share an interactive web report.
15
15
 
16
16
  ## Invocations & Aliases
17
17
 
18
- - `/report:html`: Generate HTML report for the active or most recent run
18
+ - `/report:html`: Generate HTML report for the active run
19
19
  - `/report:html {running-id}`: Generate HTML report for the specified running ID
20
20
  - `npm run report:html -- {running-id}`: CLI npm script invocation
21
21
  - `$report:html`: Codex CLI invocation
@@ -25,21 +25,21 @@ Standalone companion command to generate an interactive, self-contained HTML rep
25
25
  When invoked:
26
26
 
27
27
  ### 1. Identify Target Run
28
- 1. Locate target run directory in `devflow/runs/{running-id}` from argument or `devflow/context/current-stage.md`.
29
- 2. Check for either:
30
- - Fast-Track Living Spec: `devflow/runs/{RUNNING_ID}/current-feature.md` (or `spec.md` / `blueprint.md`)
31
- - Deep-Track Report Digest: `devflow/runs/{RUNNING_ID}/60-report.md`
28
+ 1. Locate target markdown document:
29
+ - Active Living Spec: `devflow/context/current-feature.md` or `devflow/context/{xxx-slug}/spec.md`
30
+ - Archived History: `devflow/history/{features|fixes|rollbacks}/{xxx-slug}.md`
31
+ 2. Parse spec sections, checklist steps, QA evidence, and verification logs.
32
32
 
33
33
  ### 2. Render Interactive HTML Dashboard
34
- Execute the HTML generation engine:
34
+ Execute the HTML generation engine or script:
35
35
  ```bash
36
36
  npm run report:html -- {RUNNING_ID}
37
37
  ```
38
- Or execute the renderer to transform Markdown into a styled, standalone HTML document:
39
- - Path: `devflow/runs/{RUNNING_ID}/report.html`
38
+ Or transform Markdown into a styled, standalone HTML document:
39
+ - Output: `devflow/reports/{RUNNING_ID}-report.html` (or adjacent `{xxx-slug}.html`)
40
40
 
41
41
  ### 3. Output
42
42
  Provide:
43
- - Generated HTML file path: `file:///devflow/runs/{RUNNING_ID}/report.html`
43
+ - Generated HTML file path: `file:///devflow/reports/{RUNNING_ID}-report.html`
44
44
  - Summary of sections rendered (Spec, Plan, Progress, QA Evidence, Release Notes)
45
45
  - Instructions to open the file in any browser
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: rollback
3
- description: "[devflow][B] Plan a safe reversal of a completed Blueprint feature using its archived spec and squashed git commit. Finds the exact feature commit, reviews later commits for dependency risk, writes a Type: Rollback spec to devflow/context/current-feature.md, and stops for review before /implement applies any code change. Use when the user runs /rollback, asks to remove or undo a completed feature, or wants to return the app to its pre-feature behavior without erasing Blueprint history."
3
+ description: "[devflow] Plan a safe reversal of a completed Blueprint feature using its archived spec and squashed git commit. Finds the exact feature commit, reviews later commits for dependency risk, writes a Type: Rollback spec to devflow/context/current-feature.md, and stops for review before /implement applies any code change. Use when the user runs /rollback, asks to remove or undo a completed feature, or wants to return the app to its pre-feature behavior without erasing Blueprint history."
4
4
  ---
5
5
 
6
6
  # rollback - safely reverse a completed feature
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: status
3
- description: "[devflow][B] Show where the project stands: build-plan progress, the current feature's checked and unchecked steps, git state, drift warnings, and the exact next action. Read-only. Use when the user runs /status, asks where things stand, what's next, what's in progress, or is picking work back up after a break or a context clear."
3
+ description: "[devflow] Show where the project stands: build-plan progress, the current feature's checked and unchecked steps, git state, drift warnings, and the exact next action. Read-only. Use when the user runs /status, asks where things stand, what's next, what's in progress, or is picking work back up after a break or a context clear."
4
4
  ---
5
5
 
6
6
  # status - where the project stands right now
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: test
3
- description: "[devflow][B] Test execution, missing test generation, and coverage analysis across unit, integration, and smoke test suites."
3
+ description: "[devflow] Test execution, missing test generation, and coverage analysis across unit, integration, and smoke test suites."
4
4
  ---
5
5
 
6
6
  # Test-Driven Development, Generation & Execution
@@ -81,14 +81,14 @@ For browser and UI features, unit tests alone are insufficient:
81
81
 
82
82
  ## 6. Test Generation & Persistent Execution Reports
83
83
 
84
- When generating or logging test runs during `40-execute` or `50-verify`:
84
+ When generating or logging test runs during `/implement` or `/check`:
85
85
  - Save summary reports to `devflow/reports/{date}-test-report-{slug}.md`
86
86
  - Include: Target, Test Cases (Happy Path, Error, Edge Cases), Pass/Fail statistics, and gaps/risks.
87
87
 
88
88
  ---
89
89
 
90
- ## Relationship To DevFlow 2.0
90
+ ## Relationship To DevFlow 2.6.x
91
91
 
92
92
  - **Classification**: Companion command & Engineering standard
93
- - **Mainline stages**: `30-plan` (TDD decisions), `40-execute` (TDD execution), `50-verify` (QA gate)
94
- - **Handoff**: `50-verify`, `Debug`, `autopilot`
93
+ - **Mainline stages**: `feature` / `fix` (TDD decisions), `implement` (TDD execution), `check` (QA gate)
94
+ - **Handoff**: `check`, `debug`, `autopilot`
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: tests
3
- description: "[devflow][B] Add or normalize unit testing for a Blueprint project. Detects the stack, reuses an existing test runner when present, or installs the stack-native unit test runner when missing, then adds one small example test, updates AGENTS.md commands, runs build and tests, and reports the diff. Use when the user runs /tests, invokes $tests, asks to add unit tests, set up unit testing, configure tests, or make tests part of the Blueprint workflow."
3
+ description: "[devflow] Add or normalize unit testing for a Blueprint project. Detects the stack, reuses an existing test runner when present, or installs the stack-native unit test runner when missing, then adds one small example test, updates AGENTS.md commands, runs build and tests, and reports the diff. Use when the user runs /tests, invokes $tests, asks to add unit tests, set up unit testing, configure tests, or make tests part of the Blueprint workflow."
4
4
  ---
5
5
 
6
6
  # tests - add unit testing to the project
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: try
3
- description: "[devflow][B] Generate a human manual try guide for the current or most recently completed Blueprint feature, fix, or rollback. Reads the spec, project commands, and available app context, then tells the user exactly what to start, where to go, what to click or run, what to expect, and what would count as wrong. Read-only. Use when the user runs /try, invokes $try, asks how to test manually, asks where to click, asks how to see the change, or wants a manual review path after /implement, /autopilot, /check, or /complete."
3
+ description: "[devflow] Generate a human manual try guide for the current or most recently completed Blueprint feature, fix, or rollback. Reads the spec, project commands, and available app context, then tells the user exactly what to start, where to go, what to click or run, what to expect, and what would count as wrong. Read-only. Use when the user runs /try, invokes $try, asks how to test manually, asks where to click, asks how to see the change, or wants a manual review path after /implement, /autopilot, /check, or /complete."
4
4
  ---
5
5
 
6
6
  # try - manual review guide
@@ -1,4 +1,4 @@
1
- # Nexus-DevFlow 2.6.0 (The 3-Pillars & Single Living Spec Model)
1
+ # Nexus-DevFlow 2.6.2 (The 3-Pillars & Single Living Spec Model)
2
2
 
3
3
  Instructions for AI coding agents working in this project. This is the cross-tool entry point: Codex, Google Antigravity, Cursor, GitHub Copilot, Gemini CLI, Aider, Zed, Windsurf, and others read `AGENTS.md`. Claude Code reads `CLAUDE.md`, which imports this file (`@AGENTS.md`), so there is a single source of truth.
4
4
 
@@ -33,7 +33,7 @@
33
33
 
34
34
  - [x] **4. Just-In-Time (JIT) Dynamic Context Slicing Engine** `[Size: M]`
35
35
  - *Dependencies*: Feature 3
36
- - *Scope*: สร้างตัวตัดตอนบริบท (Context Slicer) สำหรับสคิล `/implement`, `/check`, `/00-explore` เพื่อส่งเฉพาะข้อมูลที่จำเป็นและควบคุม Token Budget ลดการใช้ Token 60–70%
36
+ - *Scope*: สร้างตัวตัดตอนบริบท (Context Slicer) สำหรับสคิล `/implement`, `/check`, `/discovery` เพื่อส่งเฉพาะข้อมูลที่จำเป็นและควบคุม Token Budget ลดการใช้ Token 60–70%
37
37
 
38
38
  ---
39
39
 
@@ -84,6 +84,18 @@
84
84
  - *Dependencies*: ADR-001
85
85
  - *Scope*: รวมความสามารถเชิงสถาปัตยกรรมระดับลึกของ Deep-Track เข้าสู่ 4 ขั้นตอนหลักของ Fast-Track บนเอกสาร Single Living Spec (`current-feature.md`) จัดเก็บประวัติแบบ Single Archive (`.md`), ปลดระวาง stage skills 10-70 ที่ซ้ำซ้อน, และปรับปรุงเอกสาร & Schemas ทั้งหมด
86
86
 
87
+ ---
88
+
89
+ ## 🚀 Phase 11: Multi-Run Context Architecture & Spec Queue Engine
87
90
 
91
+ - [x] **11. Multi-Run Context Architecture & Spec Queue Engine (`IDEA-026`, `DISC-20260826-001`)** `[Size: M]`
92
+ - *Dependencies*: Feature 10, Feature 3
93
+ - *Scope*: แยกจัดเก็บ Task-Specific Context เป็นโฟลเดอร์ย่อยใน `devflow/context/{xxx-slug}/`, พัฒนา Context Resolver สำหรับสลับและเรียกใช้งาน `/implement <id>`, `/check <id>`, `/complete <id>` แบบระบุ Running ID หรือ Fuzzy Match, และอัปเกรด CLI/Dashboard/Skills ให้รองรับ Spec Queue หลายรันพร้อมกัน
94
+
95
+ ---
88
96
 
97
+ ## 🧹 Phase 12: Purge Legacy Deep-Track & Numbered Stage Artifacts
89
98
 
99
+ - [x] **12. Purge Legacy Deep-Track & Numbered Stage Artifacts (`DISC-20260826-002`)** `[Size: M]`
100
+ - *Dependencies*: Feature 10, Feature 11
101
+ - *Scope*: ล้างโค้ดตกค้างของ Deep-Track (สเตจ 00-70 เช่น `40-execute`, `50-verify`, `60-report`, `70-deliver`, `10-define`, `20-spec`, `30-plan`) ออกจาก package engine (`status.ts`, `current-work.ts`, `history.ts`), agent skills (`.agents/`, `.claude/`), automation scripts & tests ใน `scripts/`, และเอกสาร/mockup ให้เป็นปัจจุบันสมบูรณ์
@@ -139,7 +139,7 @@ Progress lives in persistent files, not in transient chat history:
139
139
 
140
140
  ## 9. Socratic Alignment & Grilling Discipline (`/grill`)
141
141
 
142
- - **Align Before You Build**: When plans, domain language, or architectural boundaries are fuzzy, invoke `/grill` (or use the Grilling Lens in `00-explore`) to conduct a structured interview before creating specifications.
142
+ - **Align Before You Build**: When plans, domain language, or architectural boundaries are fuzzy, invoke `/grill` (or use the Grilling Lens in `/discovery`) to conduct a structured interview before creating specifications.
143
143
  - **Codebase-Grounded Inquiry**: Inspect existing context and code before asking questions. Never ask questions the codebase already answers.
144
144
  - **Turn Discipline**: Ask only 1–2 high-leverage questions per turn with clear recommended defaults. Never dump a wall of questions.
145
145
  - **Lazy Inline Persistence**:
@@ -88,7 +88,7 @@ nexus-devflow/
88
88
  ├── devflow/ # Framework workspace context, history, and discoveries
89
89
  │ ├── context/ # Living source-of-truth context files
90
90
  │ ├── decisions/ # Architecture Decision Records (ADRs)
91
- │ ├── discoveries/ # Pre-delivery discovery records (00-explore.md)
91
+ │ ├── discoveries/ # Pre-delivery discovery records (discovery.md)
92
92
  │ ├── history/ # Master delivery archive (features/, fixes/, rollbacks/, HISTORY.md)
93
93
  │ └── ideas.md # Idea Inbox and backlog
94
94
  ├── packages/
@@ -104,7 +104,7 @@ nexus-devflow/
104
104
  ## 6. Naming Conventions
105
105
 
106
106
  - **Files & Directories**:
107
- - Skills and command directories: `kebab-case` (e.g. `00-explore`, `report-html`, `sync-upstream`).
107
+ - Skills and command directories: `kebab-case` (e.g. `discovery`, `report-html`, `convert-any-to-md`).
108
108
  - Source modules and scripts: `kebab-case.ts` / `kebab-case.mjs` (e.g. `current-work.ts`, `check-devflow.ts`).
109
109
  - Test files: `[module].test.ts` (e.g. `status.test.ts`, `uninstall.test.ts`).
110
110
  - **Identifiers**:
@@ -1,6 +1,6 @@
1
1
  # 🏛️ Architecture Decision Records (ADRs)
2
2
 
3
- This directory stores durable Architecture Decision Records (ADRs) produced during `/grill`, `00-explore`, or high-stakes architectural design sessions.
3
+ This directory stores durable Architecture Decision Records (ADRs) produced during `/grill`, `/discovery`, or high-stakes architectural design sessions.
4
4
 
5
5
  ---
6
6
 
@@ -1,5 +1,5 @@
1
1
  # Completed Features Archive
2
2
 
3
- Finished feature specs, enhancements, architecture migrations, and tooling runs are archived here as `xxx-name.md` (for Fast-Track single living specs) or `xxx-name/` (for Deep-Track stage runs).
3
+ Finished feature specs, enhancements, architecture migrations, and tooling runs are archived here as `{xxx-slug}.md`.
4
4
 
5
5
  Together they form the project's permanent feature build history, recording what was built, why, and how it was verified.
@@ -1,5 +1,5 @@
1
1
  # Completed Fixes Archive
2
2
 
3
- Finished bug fixes, hotfixes, regressions, security patches, and performance optimizations are archived here as `xxx-name.md` (for Fast-Track single living specs) or `xxx-name/` (for Deep-Track stage runs).
3
+ Finished bug fixes, hotfixes, regressions, security patches, and performance optimizations are archived here as `{xxx-slug}.md`.
4
4
 
5
5
  Together they form the project's permanent bug resolution history, recording root causes, TDD test decisions, and empirical proof.
@@ -1,5 +1,5 @@
1
1
  # Completed Rollbacks Archive
2
2
 
3
- Safely reversed features and rollback execution records are archived here as `YYYY-MM-DD-xxx-name.md` (or `YYYY-MM-DD-xxx-name/`).
3
+ Safely reversed features and rollback execution records are archived here as `YYYY-MM-DD-{xxx-slug}.md`.
4
4
 
5
5
  Together they form the project's safe feature reversal ledger, documenting target commits, dependency review, and post-reversal verification.
@@ -221,22 +221,21 @@ footer a{color:var(--cyan);text-decoration:none}
221
221
  <span class="badge violet">Track: Idle</span>
222
222
  </div>
223
223
  </div>
224
- <dl class="tb-table">
225
- <dt>Package</dt><dd>@jakkrichm/create-nexus-devflow</dd>
226
- <dt>Adapters</dt><dd>4 detected</dd>
227
- <dt>Branch</dt><dd>main</dd>
228
- <dt>Revision</dt><dd>2026-08-22</dd>
229
- </dl>
224
+ <div class="meta">
225
+ <div class="meta-item"><span class="meta-label">Package</span><span class="meta-val">@jakkrichm/create-nexus-devflow</span></div>
226
+ <div class="meta-item"><span class="meta-label">Adapters</span><span class="meta-val">antigravity, claude, codex, copilot, opencode</span></div>
227
+ <div class="meta-item"><span class="meta-label">Branch</span><span class="meta-val">main</span></div>
228
+ <div class="meta-item"><span class="meta-label">Snapshot</span><span class="meta-val">2026-08-26 10:45</span></div>
229
+ </div>
230
230
  </header>
231
231
  <div class="live-wrap"><span class="live-dot"></span><span class="muted" style="font:11px var(--font-mono)">Status snapshot · health OK · npx @jakkrichm/create-nexus-devflow status</span></div>
232
232
 
233
- <!-- Dual-Track Delivery Model -->
233
+ <!-- Unified Living Spec Model -->
234
234
  <section class="pipeline">
235
235
  <div class="pipeline-head">
236
- <span class="pipeline-title">Dual-Track Delivery Model</span>
236
+ <span class="pipeline-title">Unified Living Spec Model (Nexus-DevFlow 2.6.x)</span>
237
237
  <div class="track-tabs" id="track-tabs">
238
- <button class="tab on" data-t="fast">🏎️ Fast-Track · 4 steps</button>
239
- <button class="tab" data-t="deep">🏗️ Deep-Track · 8 stages</button>
238
+ <button class="tab on" data-t="fast">⚡ Living Spec · 4 steps</button>
240
239
  </div>
241
240
  </div>
242
241
 
@@ -245,23 +244,9 @@ footer a{color:var(--cyan);text-decoration:none}
245
244
  <div class="step"><span class="step-conn"></span><span class="step-dot">1</span><div class="step-name">feature / fix</div><div class="step-cmd">/feature · /fix</div></div>
246
245
  <div class="step"><span class="step-conn"></span><span class="step-dot">2</span><div class="step-name">implement</div><div class="step-cmd">/implement</div></div>
247
246
  <div class="step"><span class="step-conn"></span><span class="step-dot">3</span><div class="step-name">check</div><div class="step-cmd">/check</div></div>
248
- <div class="step"><span class="step-dot">4</span><div class="step-name">complete</div><div class="step-cmd">/complete</div></div>
249
- </div>
250
- <div class="track-note"><b>Idle:</b> no active Fast-Track run. Use <code>/feature</code> or <code>/fix</code> to create the Single Living Spec in <code>devflow/context/current-feature.md</code>. Recommended for about 85% of daily engineering work.</div>
251
- </div>
252
-
253
- <div class="track-view" id="view-deep">
254
- <div class="stepper">
255
- <div class="step"><span class="step-conn"></span><span class="step-dot">00</span><div class="step-name">00-explore</div></div>
256
- <div class="step"><span class="step-conn"></span><span class="step-dot">10</span><div class="step-name">10-define</div></div>
257
- <div class="step"><span class="step-conn"></span><span class="step-dot">20</span><div class="step-name">20-spec</div></div>
258
- <div class="step"><span class="step-conn"></span><span class="step-dot">30</span><div class="step-name">30-plan</div></div>
259
- <div class="step"><span class="step-conn"></span><span class="step-dot">40</span><div class="step-name">40-execute</div></div>
260
- <div class="step"><span class="step-conn"></span><span class="step-dot">50</span><div class="step-name">50-verify</div></div>
261
- <div class="step"><span class="step-conn"></span><span class="step-dot">60</span><div class="step-name">60-report</div></div>
262
- <div class="step"><span class="step-dot">70</span><div class="step-name">70-deliver</div></div>
247
+ <div class="step"><span class="step-conn"></span><span class="step-dot">4</span><div class="step-name">complete</div><div class="step-cmd">/complete</div></div>
263
248
  </div>
264
- <div class="track-note"><b>Reference model:</b> no active Deep-Track run. Recommended for architectural epics, database migrations, security audits, and multi-agent coordination. Progress lives in <code>devflow/context/current-run/</code> and is archived on <code>/70-deliver</code>.</div>
249
+ <div class="track-note"><b>Single Living Spec:</b> <code>/feature</code>, <code>/implement</code>, <code>/check</code>, <code>/complete</code> with TDD Discipline, Multi-Lane QA, and Durably Categorized History.</div>
265
250
  </div>
266
251
  </section>
267
252
 
@@ -274,7 +259,7 @@ footer a{color:var(--cyan);text-decoration:none}
274
259
  </button>
275
260
  </div>
276
261
  <div class="command" id="next-command">/feature</div>
277
- <div class="muted">Workspace is idle and ready for new work. Start a Fast-Track feature, or use <code>/00-explore</code> when the scope needs deeper discovery first.</div>
262
+ <div class="muted">Workspace is idle and ready for new work. Start a living feature, or use <code>/discovery</code> when the scope needs deeper exploration first.</div>
278
263
  </section>
279
264
 
280
265
  <section class="stats">
@@ -291,7 +276,7 @@ footer a{color:var(--cyan);text-decoration:none}
291
276
  <div class="facts">
292
277
  <div class="fact"><span>Installed / latest</span><span>v2.0.25 / v2.0.25</span></div>
293
278
  <div class="fact"><span>Adapters</span><span>antigravity, codex, claude, copilot</span></div>
294
- <div class="fact"><span>Architecture</span><span>3-Pillars + Dual-Track</span></div>
279
+ <div class="fact"><span>Architecture</span><span>3-Pillars + Living Spec</span></div>
295
280
  </div>
296
281
  </article>
297
282
 
@@ -350,7 +335,7 @@ footer a{color:var(--cyan);text-decoration:none}
350
335
  <div class="card-head"><span class="label">Discoveries</span><span class="value">0</span></div>
351
336
  <div class="disc-item">
352
337
  <div class="disc-id">NO ACTIVE DISCOVERY</div>
353
- <div class="disc-title">Use /00-explore to investigate a request before delivery commitment.</div>
338
+ <div class="disc-title">Use /discovery to investigate a request before delivery commitment.</div>
354
339
  <div class="disc-status" style="color:var(--mint)">workspace ready</div>
355
340
  </div>
356
341
  </article>
@@ -372,7 +357,7 @@ footer a{color:var(--cyan);text-decoration:none}
372
357
  <button class="cmdp" data-cmd="rollback" data-tip="Plan a safe reversal with dependency and regression risk analysis.">rollback</button>
373
358
  <button class="cmdp" data-cmd="ci" data-tip="Set up the GitHub Actions verification workflow for the project.">ci</button>
374
359
  <button class="cmdp" data-cmd="test" data-tip="Inspect test suites and verify the test runner configuration.">test</button>
375
- <button class="cmdp" data-cmd="autopilot" data-tip="Run a bounded Fast-Track or Deep-Track execution loop with quality gates.">autopilot</button>
360
+ <button class="cmdp" data-cmd="autopilot" data-tip="Run a bounded spec/build/check execution loop with quality gates.">autopilot</button>
376
361
  <button class="cmdp" data-cmd="prototype" data-tip="Create a throwaway static HTML/CSS mockup to settle UI direction before build.">prototype</button>
377
362
  <button class="cmdp" data-cmd="report-html" data-tip="Generate the optional standalone interactive HTML delivery report.">report-html</button>
378
363
  </div>
@@ -412,7 +397,7 @@ footer a{color:var(--cyan);text-decoration:none}
412
397
  <div class="hist-item"><span class="hist-bar feature"></span><span class="hist-type">feature 039</span><span class="hist-title">Dynamic Project Overview Compiler (/overview) พร้อม Living Context Sync</span></div>
413
398
  <div class="hist-item"><span class="hist-bar feature"></span><span class="hist-type">feature 038</span><span class="hist-title">Sub-Feature Automatic Splitting Engine และ Sub-Feature ID Contract</span></div>
414
399
  <div class="hist-item"><span class="hist-bar feature"></span><span class="hist-type">feature 037</span><span class="hist-title">Feature Briefing &amp; Deep Scope Assessment Skill (/brief)</span></div>
415
- <div class="hist-item"><span class="hist-bar feature"></span><span class="hist-type">feature 036</span><span class="hist-title">Cloud Deployment Readiness Skill (/release) และ 70-deliver</span></div>
400
+ <div class="hist-item"><span class="hist-bar feature"></span><span class="hist-type">feature 036</span><span class="hist-title">Cloud Deployment Readiness Skill (/release)</span></div>
416
401
  <div class="hist-item"><span class="hist-bar feature"></span><span class="hist-type">feature 035</span><span class="hist-title">Guided Project Discovery Interview Skill (/discovery)</span></div>
417
402
  <div class="hist-item"><span class="hist-bar feature"></span><span class="hist-type">feature 034</span><span class="hist-title">Dedicated Code &amp; Security Audit Skill (/audit)</span></div>
418
403
  <div class="hist-item"><span class="hist-bar feature"></span><span class="hist-type">feature 033</span><span class="hist-title">User-Owned Planning Documents (project-plan.md &amp; build-plan.md)</span></div>