@jakkrichm/create-nexus-devflow 2.6.0 → 2.6.1

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 (66) hide show
  1. package/dist/lib/branch-context.d.ts +61 -8
  2. package/dist/lib/branch-context.js +362 -125
  3. package/dist/lib/branch-context.js.map +1 -1
  4. package/dist/lib/status.d.ts +2 -0
  5. package/dist/lib/status.js +7 -2
  6. package/dist/lib/status.js.map +1 -1
  7. package/package.json +1 -1
  8. package/template/.agents/skills/adopt/SKILL.md +1 -1
  9. package/template/.agents/skills/audit/SKILL.md +1 -1
  10. package/template/.agents/skills/autopilot/SKILL.md +1 -1
  11. package/template/.agents/skills/brainstorm/SKILL.md +1 -1
  12. package/template/.agents/skills/brief/SKILL.md +1 -1
  13. package/template/.agents/skills/check/SKILL.md +5 -3
  14. package/template/.agents/skills/ci/SKILL.md +1 -1
  15. package/template/.agents/skills/complete/SKILL.md +9 -3
  16. package/template/.agents/skills/convert-any-to-md/SKILL.md +1 -1
  17. package/template/.agents/skills/debug/SKILL.md +1 -1
  18. package/template/.agents/skills/devflow/SKILL.md +1 -1
  19. package/template/.agents/skills/discovery/SKILL.md +1 -1
  20. package/template/.agents/skills/doctor/SKILL.md +1 -1
  21. package/template/.agents/skills/feature/SKILL.md +10 -5
  22. package/template/.agents/skills/fix/SKILL.md +6 -8
  23. package/template/.agents/skills/grill/SKILL.md +1 -1
  24. package/template/.agents/skills/idea/SKILL.md +1 -1
  25. package/template/.agents/skills/implement/SKILL.md +10 -4
  26. package/template/.agents/skills/onboard/SKILL.md +1 -1
  27. package/template/.agents/skills/overview/SKILL.md +1 -1
  28. package/template/.agents/skills/prototype/SKILL.md +1 -1
  29. package/template/.agents/skills/release/SKILL.md +1 -1
  30. package/template/.agents/skills/report-html/SKILL.md +1 -1
  31. package/template/.agents/skills/rollback/SKILL.md +1 -1
  32. package/template/.agents/skills/status/SKILL.md +1 -1
  33. package/template/.agents/skills/test/SKILL.md +1 -1
  34. package/template/.agents/skills/tests/SKILL.md +1 -1
  35. package/template/.agents/skills/try/SKILL.md +1 -1
  36. package/template/.claude/skills/adopt/SKILL.md +1 -1
  37. package/template/.claude/skills/audit/SKILL.md +1 -1
  38. package/template/.claude/skills/autopilot/SKILL.md +1 -1
  39. package/template/.claude/skills/brainstorm/SKILL.md +1 -1
  40. package/template/.claude/skills/brief/SKILL.md +1 -1
  41. package/template/.claude/skills/check/SKILL.md +5 -3
  42. package/template/.claude/skills/ci/SKILL.md +1 -1
  43. package/template/.claude/skills/complete/SKILL.md +9 -3
  44. package/template/.claude/skills/convert-any-to-md/SKILL.md +1 -1
  45. package/template/.claude/skills/debug/SKILL.md +1 -1
  46. package/template/.claude/skills/devflow/SKILL.md +1 -1
  47. package/template/.claude/skills/discovery/SKILL.md +1 -1
  48. package/template/.claude/skills/doctor/SKILL.md +1 -1
  49. package/template/.claude/skills/feature/SKILL.md +10 -5
  50. package/template/.claude/skills/fix/SKILL.md +6 -8
  51. package/template/.claude/skills/grill/SKILL.md +1 -1
  52. package/template/.claude/skills/idea/SKILL.md +1 -1
  53. package/template/.claude/skills/implement/SKILL.md +10 -4
  54. package/template/.claude/skills/onboard/SKILL.md +1 -1
  55. package/template/.claude/skills/overview/SKILL.md +1 -1
  56. package/template/.claude/skills/prototype/SKILL.md +1 -1
  57. package/template/.claude/skills/release/SKILL.md +1 -1
  58. package/template/.claude/skills/report-html/SKILL.md +1 -1
  59. package/template/.claude/skills/rollback/SKILL.md +1 -1
  60. package/template/.claude/skills/status/SKILL.md +1 -1
  61. package/template/.claude/skills/test/SKILL.md +1 -1
  62. package/template/.claude/skills/tests/SKILL.md +1 -1
  63. package/template/.claude/skills/try/SKILL.md +1 -1
  64. package/template/AGENTS.md +1 -1
  65. package/template/devflow/build-plan.md +10 -0
  66. package/template/devflow/reference/running-id-contract.md +24 -20
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: audit
3
- description: "[devflow][B] Read-only code audit for a Blueprint project, except for the findings ledger it maintains at devflow/context/findings.md. Reviews the active feature, changed files, a selected path, or the full project through all concerns or a focused quality, security, performance, or tests lens. Use when the user runs /audit, invokes $audit, asks for a code or quality audit, security review, performance review, test quality review, dead-code or duplication check, vibe-coded project cleanup, or standards review."
3
+ description: "[devflow] Read-only code audit for a Blueprint project, except for the findings ledger it maintains at devflow/context/findings.md. Reviews the active feature, changed files, a selected path, or the full project through all concerns or a focused quality, security, performance, or tests lens. Use when the user runs /audit, invokes $audit, asks for a code or quality audit, security review, performance review, test quality review, dead-code or duplication check, vibe-coded project cleanup, or standards review."
4
4
  ---
5
5
 
6
6
  # audit - review code quality against the project standards
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: autopilot
3
- description: "[devflow][B] Optional explicit Blueprint mode for one bounded spec/build/check/audit pass. It can pick or resume the current feature, write the spec when needed, create or reuse the branch, implement small steps, run build/tests/checks, create checkpoint commits after passing steps, audit changed code, repair confirmed high-severity findings, and stop with a review packet. It never completes, merges, pushes, deploys, publishes, sends, or performs destructive actions without explicit approval. Use only when the user explicitly runs /autopilot, invokes $autopilot, or directly asks for Autopilot."
3
+ description: "[devflow] Optional explicit Blueprint mode for one bounded spec/build/check/audit pass. It can pick or resume the current feature, write the spec when needed, create or reuse the branch, implement small steps, run build/tests/checks, create checkpoint commits after passing steps, audit changed code, repair confirmed high-severity findings, and stop with a review packet. It never completes, merges, pushes, deploys, publishes, sends, or performs destructive actions without explicit approval. Use only when the user explicitly runs /autopilot, invokes $autopilot, or directly asks for Autopilot."
4
4
  ---
5
5
 
6
6
  # autopilot - optional Blueprint loop
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: brainstorm
3
- description: "[devflow][B] Companion skill for structured divergent and convergent ideation, generating 2-3 viable options with trade-off analysis before committing to delivery."
3
+ description: "[devflow] Companion skill for structured divergent and convergent ideation, generating 2-3 viable options with trade-off analysis before committing to delivery."
4
4
  argument-hint: "{topic, feature, or discovery-id}"
5
5
  ---
6
6
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: brief
3
- description: "[devflow][B] Read-only briefing on an upcoming build-plan feature before you spec it. With no argument, briefs the next unchecked item; given a number or name, briefs that one. Reads build-plan.md and project-overview.md and explains what the feature is, what it depends on, what it will touch, how big it is, and whether it will split - without writing anything. Use when the user runs /brief, asks what the next feature involves, wants to understand or preview a feature before /feature, or is deciding what to build or reorder next."
3
+ description: "[devflow] Read-only briefing on an upcoming build-plan feature before you spec it. With no argument, briefs the next unchecked item; given a number or name, briefs that one. Reads build-plan.md and project-overview.md and explains what the feature is, what it depends on, what it will touch, how big it is, and whether it will split - without writing anything. Use when the user runs /brief, asks what the next feature involves, wants to understand or preview a feature before /feature, or is deciding what to build or reorder next."
4
4
  ---
5
5
 
6
6
  # brief - understand a feature before you spec it
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: check
3
- description: "[devflow][F] Prove the current work actually does what its spec says and adheres to architectural standards through a Dual-Axis Independent Review (Spec Fidelity + Standards & Architecture). Drives the app (browser, CLI, or server), captures empirical evidence (screenshots, output, console/network errors), checks against 12 Fowler smells and deep-module standards, and reports pass/fail. Does not edit source or commit - it observes; fixing stays /implement's job. Use when the user runs /check, asks to confirm a step or feature works, wants proof before /complete, or wants to check a change in the running app rather than just the build."
3
+ description: "[devflow] Prove the current work actually does what its spec says and adheres to architectural standards through a Dual-Axis Independent Review. Supports Multi-Run: given an optional ID or name (/check 12), targets that spec and records proof to devflow/context/{xxx-slug}/findings.md. Drives the app, captures empirical evidence, checks Fowler smells, and reports pass/fail. Use when running /check, confirming work, or validating before /complete."
4
+ argument-hint: "[{run-id, number, or name}]"
4
5
  ---
5
6
 
6
7
  # check - Dual-Axis Independent Verification Engine
@@ -20,13 +21,14 @@ It changes no source and commits nothing — it executes, inspects, and reports
20
21
 
21
22
  ## Input
22
23
 
23
- Optional: a specific target to check (a step, a flow, a URL). With no argument, verify the whole current feature against `devflow/context/current-feature.md` and `devflow/context/coding-standards.md`.
24
+ - **Given an ID or name** (e.g. `/check 12`, `/check 012`) -> targets `devflow/context/{xxx-slug}/` and records audit ledger to `{xxx-slug}/findings.md`.
25
+ - **With no argument** (`/check`) -> verifies the active run matching current git branch or single active spec.
24
26
 
25
27
  ---
26
28
 
27
29
  ## Step 1 - Build the Dual-Axis Review Matrix
28
30
 
29
- Read `devflow/context/current-feature.md` and `devflow/context/coding-standards.md`. Prepare the inspection criteria across two independent axes:
31
+ Read the target spec from `devflow/context/{xxx-slug}/spec.md` (or `devflow/context/current-feature.md`) and `devflow/context/coding-standards.md`. Prepare the inspection criteria across two independent axes:
30
32
 
31
33
  1. **Axis 1 (Standards & Architecture Criteria)**:
32
34
  - Coding conventions in `coding-standards.md`
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: ci
3
- description: "[devflow][B] Set up or normalize automatic GitHub checks for a Blueprint project around one documented Verify command. Detects the real stack, package manager, existing checks, default branch, and workflows; preserves existing CI; combines only configured typecheck, test, and build commands; runs the command locally; and stops before push or remote ruleset changes. Use when the user runs /ci, invokes $ci, asks to add CI, set up GitHub Actions, add pull-request checks, or create automatic GitHub checks."
3
+ description: "[devflow] Set up or normalize automatic GitHub checks for a Blueprint project around one documented Verify command. Detects the real stack, package manager, existing checks, default branch, and workflows; preserves existing CI; combines only configured typecheck, test, and build commands; runs the command locally; and stops before push or remote ruleset changes. Use when the user runs /ci, invokes $ci, asks to add CI, set up GitHub Actions, add pull-request checks, or create automatic GitHub checks."
4
4
  ---
5
5
 
6
6
  # ci - set up automatic GitHub checks
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  name: complete
3
- description: "[devflow][F] Wrap up a finished feature, fix, or rollback. Runs a final safety pass, archives its spec to devflow/history/features/, devflow/history/fixes/, or devflow/history/rollbacks/, updates the build plan for features and rollbacks, resets devflow/context/current-feature.md to its stub, and makes the work commit. Enforces a mandatory user gate: asks whether to squash-merge to main/master OR pull latest main/master into the feature/dev branch and push to remote for Merge Request (MR / PR) creation. Never merges into main/master without explicit user instruction."
3
+ description: "[devflow] Wrap up a finished feature, fix, or rollback. Supports Multi-Run: given an optional ID (/complete 12), archives that run from devflow/context/{xxx-slug}/ to devflow/history/, cleans up the run workspace, updates build-plan and HISTORY.md, and makes the work commit. Enforces mandatory user gate (Squash-merge vs MR/PR)."
4
+ argument-hint: "[{run-id, number, or name}]"
4
5
  ---
5
6
 
6
7
  # complete - log the finished work, make the work commit, and deliver
@@ -12,13 +13,18 @@ Where this sits in the workflow:
12
13
 
13
14
  `/implement` built the feature, fix, or rollback on its branch, with optional per-step commit
14
15
  checkpoints. This skill closes it out: it logs the work, makes the single
15
- work-level commit, and guides the delivery through a **Mandatory User Delivery Gate**. Run it only when the work is done,
16
+ work-level commit, archives from `devflow/context/{xxx-slug}/`, cleans up the active run workspace, and guides the delivery through a **Mandatory User Delivery Gate**. Run it only when the work is done,
16
17
  reviewed, and the documented `Verify` command, or the fallback build and tests,
17
18
  passes.
18
19
 
20
+ ## Multi-Run Target Resolution
21
+
22
+ - **Given an ID or name** (e.g. `/complete 12`, `/complete 058`) -> targets `devflow/context/{xxx-slug}/` for archiving and cleanup.
23
+ - **With no argument** (`/complete`) -> targets the run matching the active branch or single active spec.
24
+
19
25
  ## Before you start
20
26
 
21
- Confirm the work is actually finished: `devflow/context/current-feature.md`
27
+ Confirm the target work is actually finished: `devflow/context/{xxx-slug}/spec.md` (or `current-feature.md`)
22
28
  holds a real spec, its steps are built on a branch, and `Verify`, or the fallback
23
29
  build and tests, passes. If any of the
24
30
  spec's done-whens are behavioral, `/check` should have proven them against the
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: convert-any-to-md
3
- description: "[devflow][B] Converts any document (.xlsx, .pdf, .docx, .txt, .csv, .log, .json, .yaml, etc.) or mixed folders into clean Markdown in devflow/reference. Use whenever documents need to be analyzed, summarized, searched, or extracted from."
3
+ description: "[devflow] Converts any document (.xlsx, .pdf, .docx, .txt, .csv, .log, .json, .yaml, etc.) or mixed folders into clean Markdown in devflow/reference. Use whenever documents need to be analyzed, summarized, searched, or extracted from."
4
4
  ---
5
5
 
6
6
  # Convert Any Document to Markdown
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: debug
3
- description: "[devflow][B] Diagnose a failing test, broken build, crash, error, regression, or unexpected behavior without editing source or DevFlow state. Follows a strict 6-Phase Scientific Debugging Loop: builds a red-capable tight feedback loop, reproduces & minimises, tests 3-5 falsifiable hypotheses, localizes the failure to a root cause, and reports a repair handoff to /fix or /implement. Use when the user runs /debug, invokes $debug, asks why something is failing or broken, wants a root-cause investigation, or asks to diagnose before fixing."
3
+ description: "[devflow] Diagnose a failing test, broken build, crash, error, regression, or unexpected behavior without editing source or DevFlow state. Follows a strict 6-Phase Scientific Debugging Loop: builds a red-capable tight feedback loop, reproduces & minimises, tests 3-5 falsifiable hypotheses, localizes the failure to a root cause, and reports a repair handoff to /fix or /implement. Use when the user runs /debug, invokes $debug, asks why something is failing or broken, wants a root-cause investigation, or asks to diagnose before fixing."
4
4
  ---
5
5
 
6
6
  # debug - 6-Phase Scientific Debugging Protocol
@@ -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
 
@@ -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
 
@@ -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,6 +1,6 @@
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."
3
+ description: "[devflow] Standalone HTML Report Generator - render an interactive standalone HTML dashboard from current-feature.md or 60-report.md on demand."
4
4
  argument-hint: "{running-id or workspace path}"
5
5
  ---
6
6
 
@@ -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
@@ -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.1 (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
 
@@ -84,6 +84,16 @@
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
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
+
96
+
87
97
 
88
98
 
89
99
 
@@ -1,4 +1,4 @@
1
- # DevFlow 2.5.0 Running ID & 3-Pillars Workspace Contract
1
+ # DevFlow 2.6.0 Running ID & 3-Pillars Multi-Run Context Contract
2
2
 
3
3
  ## The 3-Pillars Workspace Architecture
4
4
 
@@ -7,15 +7,23 @@ All DevFlow framework assets are organized into three clean pillars representing
7
7
  ```text
8
8
  devflow/
9
9
  ├── 🔮 ideas.md # [1. Future / Backlog] Centralized Idea Inbox with AI scoring
10
+ ├── 🗺️ project-plan.md # [1. Future] Master product roadmap and system vision
11
+ ├── 📋 build-plan.md # [1. Future] User-owned feature queue and sizing
10
12
 
11
- ├── ⚡ context/ # [2. Present / Active] Living Source of Truth & Active Work
13
+ ├── ⚡ context/ # [2. Present / Active] Living Source of Truth & Multi-Run Contexts
12
14
  │ ├── project-overview.md # Primary source of truth for project architecture and tech stack
13
15
  │ ├── coding-standards.md # Engineering, code quality, TDD, and testing standards
14
16
  │ ├── ai-interaction.md # AI agent interaction rules, unified living spec flow, and Thai defaults
15
- │ ├── findings.md # Open and resolved audit findings ledger (P0-P3)
16
17
  │ ├── glossary.md # Domain glossary and architecture vocabulary
18
+ │ ├── current-feature.md # Active Living Spec pointer / legacy fallback
17
19
  │ ├── current-stage.md # Active state pointer and run tracker
18
- └── current-feature.md # Single Living Spec (Active work / stub when idle)
20
+ ├── findings.md # Shared/default audit findings ledger (P0-P3)
21
+ │ │
22
+ │ ├── {xxx-slug}/ # Active Run Workspace & Spec Queue (Multi-Run Active Task)
23
+ │ │ ├── spec.md # Living Spec + Checklist for this run
24
+ │ │ ├── stage.md # Runtime stage, track, and branch pointer
25
+ │ │ └── findings.md # Dedicated audit findings ledger for this run
26
+ │ └── ...
19
27
 
20
28
  ├── 📦 history/ # [3. Past / Completed] Permanent Delivery & Release Archives
21
29
  │ ├── features/ # Completed features, architecture migrations, tooling (xxx-slug.md)
@@ -32,9 +40,9 @@ devflow/
32
40
  ## Running ID Naming Convention
33
41
 
34
42
  ### 1. Standard Running IDs
35
- - **Format**: `xxx-slug` (e.g. `001-setup-auth`, `053-unify-deep-and-fast-track-model`)
43
+ - **Format**: `xxx-slug` (e.g. `001-setup-auth`, `058-multi-run-context-architecture`)
36
44
  - **Prefix Removal**: The legacy `RUN-` prefix is discontinued in favor of clean 3-digit sequential numbering.
37
- - **Git Branch Standard**: `feature/{xxx-slug}` or `fix/{xxx-slug}` (or specific release branches such as `2.5.0`).
45
+ - **Git Branch Standard**: `feature/{xxx-slug}` or `fix/{xxx-slug}` (or specific release branches such as `2.6.0`).
38
46
 
39
47
  ### 2. Sub-Feature Running IDs (`xxx[a-z]-slug`)
40
48
  - **Format**: `xxx[a-z]-slug` (e.g. `038a-backend-schema-and-api`, `038b-frontend-ui-and-state`)
@@ -44,19 +52,15 @@ devflow/
44
52
 
45
53
  ---
46
54
 
47
- ## Multi-Factor Sizing Heuristic & Splitting Engine
55
+ ## Multi-Run Spec Queue & Selective Execution Rule
48
56
 
49
- A feature is considered **Oversized (`L` or `XL`)** and recommended for sub-feature splitting when any of the following conditions are met:
50
- 1. **Files Touched**: Predicted to modify or create $\ge 6$ files.
51
- 2. **Architectural Layers**: Crosses $\ge 3$ distinct layers (e.g. Database Migrations + Backend APIs + Frontend UI + State Store).
52
- 3. **Task Complexity**: Contains $\ge 6$ checklist tasks or involves heavy multi-service integrations.
57
+ 1. **Spec-Ahead & Non-blocking Drafting**:
58
+ - `/feature [id / title]` and `/fix [title]` create dedicated run folders at `devflow/context/{xxx-slug}/`.
59
+ - Creating a spec does **not block** drafting additional specs. Multiple specs can reside in `devflow/context/` simultaneously.
60
+ 2. **Selective Execution (`/implement [id]`)**:
61
+ - Spec execution can be invoked targeting a specific ID (e.g. `/implement 12`, `/implement 012`, or `/implement kanban`).
62
+ - The AI checks out the matching git branch `feature/{xxx-slug}`, loads only that run's `spec.md` and global context, and executes tasks with Strict TDD.
63
+ 3. **Dedicated Quality Ledger & Safe Archival (`/complete [id]`)**:
64
+ - Each run maintains its own `findings.md` within `devflow/context/{xxx-slug}/`.
65
+ - `/complete` compiles the living spec, archives it to `devflow/history/{features|fixes|rollbacks}/{xxx-slug}.md`, removes `devflow/context/{xxx-slug}/`, updates `HISTORY.md` and `build-plan.md`, and prompts for squash-merge/PR.
53
66
 
54
- When detected during `/feature` or `/brief`, the AI triggers the **Interactive Split Gate**, proposing a clean `4a`, `4b` sub-feature breakdown before opening the first spec.
55
-
56
- ---
57
-
58
- ## Single Active Run Rule (One Thing at a Time)
59
-
60
- 1. Only **one active run** is permitted at any given time in `current-feature.md`.
61
- 2. Before opening a new run (`/feature` or `/fix`), the AI checks `current-stage.md` and `current-feature.md`.
62
- 3. If an active run is in progress, the AI **blocks** starting a new task and requires closing the active run via `/complete` (or explicitly cancelling/rolling back).