@jakkrichm/create-nexus-devflow 2.7.0 → 2.9.0

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 (67) hide show
  1. package/README.md +2 -2
  2. package/dist/bin/create-nexus-devflow.d.ts +2 -2
  3. package/dist/bin/create-nexus-devflow.js +130 -0
  4. package/dist/bin/create-nexus-devflow.js.map +1 -1
  5. package/dist/lib/branch-context.d.ts +1 -0
  6. package/dist/lib/branch-context.js +14 -9
  7. package/dist/lib/branch-context.js.map +1 -1
  8. package/dist/lib/current-work.js +10 -22
  9. package/dist/lib/current-work.js.map +1 -1
  10. package/dist/lib/doctor.js +44 -6
  11. package/dist/lib/doctor.js.map +1 -1
  12. package/dist/lib/findings.js +14 -10
  13. package/dist/lib/findings.js.map +1 -1
  14. package/dist/lib/mcp.js +3 -3
  15. package/dist/lib/mcp.js.map +1 -1
  16. package/dist/lib/skill-manager.d.ts +50 -0
  17. package/dist/lib/skill-manager.js +372 -0
  18. package/dist/lib/skill-manager.js.map +1 -0
  19. package/dist/lib/swarm-orchestrator.js +14 -8
  20. package/dist/lib/swarm-orchestrator.js.map +1 -1
  21. package/dist/lib/workflow-state.js +3 -1
  22. package/dist/lib/workflow-state.js.map +1 -1
  23. package/dist/scripts/prepare-template.js +0 -19
  24. package/dist/scripts/prepare-template.js.map +1 -1
  25. package/package.json +2 -2
  26. package/template/.agents/skills/audit/SKILL.md +7 -7
  27. package/template/.agents/skills/autopilot/SKILL.md +34 -58
  28. package/template/.agents/skills/brief/SKILL.md +1 -1
  29. package/template/.agents/skills/check/SKILL.md +4 -4
  30. package/template/.agents/skills/complete/SKILL.md +13 -46
  31. package/template/.agents/skills/continuous/SKILL.md +8 -9
  32. package/template/.agents/skills/devflow/SKILL.md +18 -13
  33. package/template/.agents/skills/discovery/SKILL.md +8 -3
  34. package/template/.agents/skills/doctor/SKILL.md +7 -11
  35. package/template/.agents/skills/feature/SKILL.md +5 -6
  36. package/template/.agents/skills/fix/SKILL.md +2 -2
  37. package/template/.agents/skills/implement/SKILL.md +11 -12
  38. package/template/.agents/skills/release/SKILL.md +1 -1
  39. package/template/.agents/skills/report-html/SKILL.md +3 -3
  40. package/template/.agents/skills/rollback/SKILL.md +4 -6
  41. package/template/.agents/skills/status/SKILL.md +20 -27
  42. package/template/.agents/skills/try/SKILL.md +5 -6
  43. package/template/.claude/skills/audit/SKILL.md +7 -7
  44. package/template/.claude/skills/autopilot/SKILL.md +34 -58
  45. package/template/.claude/skills/brief/SKILL.md +1 -1
  46. package/template/.claude/skills/check/SKILL.md +4 -4
  47. package/template/.claude/skills/complete/SKILL.md +13 -46
  48. package/template/.claude/skills/continuous/SKILL.md +8 -9
  49. package/template/.claude/skills/devflow/SKILL.md +18 -13
  50. package/template/.claude/skills/discovery/SKILL.md +8 -3
  51. package/template/.claude/skills/doctor/SKILL.md +7 -11
  52. package/template/.claude/skills/feature/SKILL.md +5 -6
  53. package/template/.claude/skills/fix/SKILL.md +2 -2
  54. package/template/.claude/skills/implement/SKILL.md +11 -12
  55. package/template/.claude/skills/release/SKILL.md +1 -1
  56. package/template/.claude/skills/report-html/SKILL.md +3 -3
  57. package/template/.claude/skills/rollback/SKILL.md +4 -6
  58. package/template/.claude/skills/status/SKILL.md +20 -27
  59. package/template/.claude/skills/try/SKILL.md +5 -6
  60. package/template/AGENTS.md +18 -19
  61. package/template/devflow/build-plan.md +9 -0
  62. package/template/devflow/context/ai-interaction.md +55 -16
  63. package/template/devflow/reference/feature-spec-template.md +2 -2
  64. package/template/devflow/reference/running-id-contract.md +0 -3
  65. package/template/devflow/context/current-feature.md +0 -3
  66. package/template/devflow/context/current-stage.md +0 -11
  67. package/template/devflow/context/findings.md +0 -10
@@ -24,7 +24,7 @@ passes.
24
24
 
25
25
  ## Before you start
26
26
 
27
- Confirm the target work is actually finished: `devflow/context/{xxx-slug}/spec.md` (or `current-feature.md`)
27
+ Confirm the target work is actually finished: `devflow/context/{xxx-slug}/spec.md`
28
28
  holds a real spec, its steps are built on a branch, and `Verify`, or the fallback
29
29
  build and tests, passes. If any of the
30
30
  spec's done-whens are behavioral, `/check` should have proven them against the
@@ -36,9 +36,8 @@ the steps to be pre-committed.
36
36
 
37
37
  Before logging or committing, run a short safety pass and report blockers only:
38
38
 
39
- - active spec exists and the work is not being completed directly from `main` or `master`
40
- - changed files are tied to the active spec, with no unrelated dirty work mixed
41
- in (a dirty `devflow/context/findings.md` is expected, since `/audit` writes it)
39
+ - active spec exists in `devflow/context/{xxx-slug}/spec.md` and the work is not being completed directly from `main` or `master`
40
+ - changed files are tied to the active spec, with no unrelated dirty work mixed in
42
41
  - the exact `Verify` command from `AGENTS.md` passed in this session, when one is
43
42
  declared; otherwise the build passed, and tests passed when the project has a
44
43
  declared test command and the change touched logic
@@ -46,7 +45,7 @@ Before logging or committing, run a short safety pass and report blockers only:
46
45
  a clear manual try path
47
46
  - if workflow files changed, `.agents` and `.claude` stayed in sync where both
48
47
  adapters exist
49
- - no P0 or P1 finding in `devflow/context/findings.md` is `open` or `fixed`.
48
+ - no P0 or P1 finding in `devflow/context/{xxx-slug}/findings.md` is `open` or `fixed`.
50
49
  `fixed` still blocks on purpose: the repair exists but no review has looked at
51
50
  it - run `/audit` to close it. The only waivers are `accepted` (the user's
52
51
  explicit decision in the current chat, reason recorded; never set it for
@@ -64,48 +63,16 @@ Check whether the spec is a feature, fix, or rollback. A fix is marked
64
63
  `Type: Fix` and has no build-plan number. A rollback is marked `Type: Rollback`
65
64
  and records the exact target feature, archive, commit, and parent.
66
65
 
67
- - **Feature** - archive `devflow/context/current-feature.md` to `devflow/history/features/NN-name.md`
68
- (NN is the build-plan number), and check it off in `devflow/build-plan.md`
69
- (and its parent item once all sub-items are checked).
70
- - **Fix** - archive it to `devflow/history/fixes/name.md`. A fix isn't a build-plan item, so
71
- there's nothing to check off.
72
- - **Rollback** - archive it to
73
- `devflow/history/rollbacks/YYYY-MM-DD-NN-name.md`, preserving the original
74
- completed feature archive. Create `devflow/history/rollbacks/` first if an
75
- older Blueprint installation does not have it yet. Uncheck the exact target item in
76
- `devflow/build-plan.md` and its parent when applicable, then append a concise
77
- note to the target line with the rollback date and archive path. Keep the
78
- feature number stable. If the user later decides the feature is permanently
79
- abandoned rather than pending rebuild, that roadmap decision is a separate
80
- plan edit.
81
-
82
- **Archive resolved findings.** If `devflow/context/findings.md` holds any
66
+ - **Feature** - archive `devflow/context/{xxx-slug}/spec.md` to `devflow/history/features/{xxx-slug}.md`, check it off in `devflow/build-plan.md` (and its parent item once all sub-items are checked), and record an entry into `devflow/history/HISTORY.md`.
67
+ - **Fix** - archive `devflow/context/{xxx-slug}/spec.md` to `devflow/history/fixes/{xxx-slug}.md`, and record an entry into `devflow/history/HISTORY.md`.
68
+ - **Rollback** - archive `devflow/context/{xxx-slug}/spec.md` to `devflow/history/rollbacks/YYYY-MM-DD-{xxx-slug}.md`, preserving the original completed feature archive. Uncheck the target item in `devflow/build-plan.md` and record in `devflow/history/HISTORY.md`.
69
+
70
+ **Archive resolved findings.** If `devflow/context/{xxx-slug}/findings.md` holds any
83
71
  findings, append a `## Findings` section to the archive file just written with
84
72
  every `closed`, `accepted`, or `invalid` entry at its final status (`accepted`
85
- entries keep their recorded reason). Prefix each ID with the archive name for
86
- global uniqueness: feature 12's `F-03` becomes `12/F-03`; fixes and rollbacks
87
- use their archive filename as the prefix. An entry carried forward from earlier
88
- work archives with the item that resolved it; its **Found** line preserves
89
- where it came from. Then remove the archived entries from the ledger. Unresolved entries (`open` or `fixed` P2/P3, and `unverified`
90
- leads) stay in the ledger with their IDs so they are never silently dropped.
91
- When nothing remains, reset the ledger to exactly this stub, and create it the
92
- same way if the file is missing (an older install):
93
-
94
- # Findings
95
-
96
- > **Generated file.** The findings ledger: review findings raised by `/audit`
97
- > against the work in progress, each with a durable ID, severity (P0-P3), and
98
- > status. `/implement` marks repaired findings `fixed`, a later `/audit` pass
99
- > moves them to `closed`, and `/complete` refuses to merge while any P0 or P1
100
- > finding is `open` or `fixed`, then archives resolved findings with the work
101
- > and resets this file.
102
-
103
- _No findings recorded. `/audit` appends findings here when it finds them._
104
-
105
- Then reset `devflow/context/current-feature.md` to its current stub ("nothing
106
- in progress"), including `/rollback` alongside `/feature` and `/fix`. Don't
107
- commit yet; the next step makes one work commit covering the code and these doc
108
- changes. The archive is the build history.
73
+ entries keep their recorded reason).
74
+
75
+ **Clean up run workspace.** Delete the task directory `devflow/context/{xxx-slug}/`. In Pure Multi-Run architecture, completed work leaves zero residual stubs in `devflow/context/`.
109
76
 
110
77
  **Discard consumed prototypes.** If this feature built the look from `prototypes/`
111
78
  - its Design reference pointed there and an early step ported `prototypes/theme.css`
@@ -159,7 +126,7 @@ Finish with a concise **How to try it** note for the completed work. For a
159
126
  rollback, explain how to confirm the removed behavior is gone and name one
160
127
  unaffected regression path. If the
161
128
  manual path is more than a couple of steps, tell the user to run `/try latest`;
162
- that command can read the archived feature after `current-feature.md` is reset.
129
+ that command can read the archived feature from history.
163
130
 
164
131
  ## Rules
165
132
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: continuous
3
- description: "[devflow] Autonomous multi-feature delivery loop in Nexus-DevFlow: completes planned features serially from devflow/build-plan.md without review pauses. Maintains safety boundaries, Single Living Spec (current-feature.md), branch isolation, TDD verification, quality gates, and local squash-merges into main. Use when running /continuous, $continuous, or executing Continuous Mode."
3
+ description: "[devflow] Autonomous multi-feature delivery loop in Nexus-DevFlow: completes planned features serially from devflow/build-plan.md without review pauses. Maintains safety boundaries, Task-Isolated Living Spec, branch isolation, TDD verification, quality gates, and local squash-merges into main. Use when running /continuous, $continuous, or executing Continuous Mode."
4
4
  argument-hint: "[{resume, max-features, or start-feature}]"
5
5
  ---
6
6
 
@@ -15,7 +15,7 @@ Where this sits in the workflow:
15
15
  Gates ➔ Merge)
16
16
  ```
17
17
 
18
- `/continuous` (หรือ `$continuous`) คือโหมดการทำงานแบบ Autonomous Multi-Feature Delivery Loop สำหรับจัดส่งฟีเจอร์ที่อยู่ใน `devflow/build-plan.md` ต่อเนื่องทีละฟีเจอร์ในเครื่อง Local โดยไม่ต้องหยุดรอ Manual Review Prompts ในแต่ละขั้นตอนย่อย แต่ยังคงรักษาความเข้มงวดของ **The 3-Pillars Model & Single Living Spec (`current-feature.md`)**, การทำ TDD, การตรวจ Quality Gates, การบันทึก Findings Ledger, และการ Squash-merge ลง Local Main Commit ทีละฟีเจอร์อย่างปลอดภัย 100%
18
+ `/continuous` (หรือ `$continuous`) คือโหมดการทำงานแบบ Autonomous Multi-Feature Delivery Loop สำหรับจัดส่งฟีเจอร์ที่อยู่ใน `devflow/build-plan.md` ต่อเนื่องทีละฟีเจอร์ในเครื่อง Local โดยไม่ต้องหยุดรอ Manual Review Prompts ในแต่ละขั้นตอนย่อย แต่ยังคงรักษาความเข้มงวดของ **The 3-Pillars Model & Task-Isolated Living Spec (`devflow/context/{xxx-slug}/spec.md`)**, การทำ TDD, การตรวจ Quality Gates, การบันทึก Findings Ledger, และการ Squash-merge ลง Local Main Commit ทีละฟีเจอร์อย่างปลอดภัย 100%
19
19
 
20
20
  ### ขอบเขตสิทธิ์ที่ได้รับอนุญาตเฉพาะในเครื่อง Local:
21
21
  - สร้างและสลับ Feature Branch ในเครื่อง Local
@@ -36,7 +36,7 @@ Where this sits in the workflow:
36
36
  ## Input & Target Selection
37
37
 
38
38
  - **ไม่ระบุ Argument (`/continuous`)**:
39
- 1. หากมีฟีเจอร์ค้างอยู่ใน `devflow/context/current-feature.md` ให้ทำต่อจากขั้นตอนย่อยแรกที่ยังไม่ได้เช็ค (`- [ ]`)
39
+ 1. หากมีฟีเจอร์ค้างอยู่ใน `devflow/context/{xxx-slug}/` ให้ทำต่อจากขั้นตอนย่อยแรกที่ยังไม่ได้เช็ค (`- [ ]`)
40
40
  2. หากไม่มี ให้เลือกฟีเจอร์แรกที่ยังไม่ได้เช็ค (`- [ ]`) ใน `devflow/build-plan.md`
41
41
  3. วนลูปทำต่อเนื่องตามลำดับใน `build-plan.md` จนกว่าจะหมด หรือครบตามจำนวน `continuous.maxFeatures` ใน `devflow/config.json`
42
42
  - **ระบุ `resume` (`/continuous resume`)**: ทำงานต่อจากฟีเจอร์และขั้นตอนย่อยที่ค้างอยู่ทันที
@@ -51,8 +51,7 @@ Where this sits in the workflow:
51
51
  - `devflow/config.json` (หากไม่มี ให้ใช้ค่า Defaults อย่างปลอดภัย; หาก Invalid ให้หยุดและชี้ไปที่ `/doctor`)
52
52
  - `devflow/project-plan.md` และ `devflow/build-plan.md`
53
53
  - `devflow/context/project-overview.md`
54
- - `devflow/context/current-feature.md` และ `devflow/context/current-stage.md`
55
- - `devflow/context/findings.md`
54
+ - `devflow/context/{xxx-slug}/` (ถ้ามีงานค้างอยู่)
56
55
  - `devflow/context/coding-standards.md` และ `devflow/context/ai-interaction.md`
57
56
  - สถานะ Git (`git status`, `git branch`, recent log)
58
57
 
@@ -69,11 +68,11 @@ Where this sits in the workflow:
69
68
  ดำเนินงานวนลูปทีละ 1 ฟีเจอร์ตามลำดับ:
70
69
 
71
70
  ### 2.1 Select & Spec (เลือกและร่างสเปก)
72
- - หาก Resuming: ใช้ Spec เดิมใน `current-feature.md`
73
- - หากเป็นฟีเจอร์ใหม่: ถอดความต้องการจาก `build-plan.md` และสร้าง Single Living Spec ลงใน `devflow/context/current-feature.md` พร้อมวิเคราะห์ Red-team ก่อนเริ่มโค้ด
71
+ - หาก Resuming: ใช้ Spec เดิมใน `devflow/context/{xxx-slug}/spec.md`
72
+ - หากเป็นฟีเจอร์ใหม่: ถอดความต้องการจาก `build-plan.md` และสร้าง Task Workspace ที่ `devflow/context/{xxx-slug}/` พร้อมเขียน `spec.md`, `stage.md`, `findings.md` และวิเคราะห์ Red-team ก่อนเริ่มโค้ด
74
73
 
75
74
  ### 2.2 Create / Resume Feature Branch
76
- - สร้าง Branch ตาม Prefix ใน Config (เช่น `feature/060-slug`) จาก Default Branch
75
+ - สร้าง Branch ตาม Prefix ใน Config (เช่น `feature/061-slug`) จาก Default Branch
77
76
 
78
77
  ### 2.3 Implement Small Steps with Strict TDD
79
78
  - ดำเนินการสร้างฟังก์ชันทีละ Task ตาม Checklist ใน Spec:
@@ -96,7 +95,7 @@ Where this sits in the workflow:
96
95
  - รัน Verification ขั้นสุดท้าย
97
96
  - ย้ายและ Archive เอกสารไปที่ `devflow/history/features/{xxx-slug}.md`
98
97
  - อัปเดตเช็คบ็อกซ์ใน `devflow/build-plan.md`
99
- - รีเซ็ต `devflow/context/current-feature.md` กลับสู่ Stub
98
+ - ลบโฟลเดอร์รัน `devflow/context/{xxx-slug}/`
100
99
  - Squash-merge Feature Branch เข้าสู่ Local Main และลบ Feature Branch ใน Local
101
100
  - นับจำนวนฟีเจอร์ที่สำเร็จเพิ่มขึ้น 1
102
101
 
@@ -9,14 +9,14 @@ Use this skill to guide the user on what to do next, inspect current workspace s
9
9
 
10
10
  ## Input
11
11
 
12
- - **No argument (`devflow`, `/devflow`, `$devflow`, or `status`)**: Inspect current workspace state (active run in `devflow/context/current-stage.md`, active living spec in `devflow/context/current-feature.md`, active discovery in `devflow/discoveries/`, pending ideas in `devflow/ideas.md`, open findings in `devflow/context/findings.md`, and project overview in `devflow/context/project-overview.md`) and recommend the exact next action.
12
+ - **No argument (`devflow`, `/devflow`, `$devflow`, or `status`)**: Inspect current workspace state (active tasks in `devflow/context/{xxx-slug}/`, active discovery in `devflow/discoveries/`, pending ideas in `devflow/ideas.md`, and project overview in `devflow/context/project-overview.md`) and recommend the exact next action.
13
13
  - **With user request (`devflow "<request>"`)**: Classify the user's intent and guide them to the matching DevFlow workflow stage or companion command path.
14
14
 
15
- ## The Unified Living Spec Architecture (DevFlow 2.5.0)
15
+ ## The Task-Isolated Living Spec Architecture
16
16
 
17
- Nexus-DevFlow uses a **Single Unified Living Spec Model**:
17
+ Nexus-DevFlow uses a **Task-Isolated Living Spec Model**:
18
18
  - **The 4-Stage Lifecycle**: `/feature` (or `/fix`) ➔ `/implement` ➔ `/check` ➔ `/complete`
19
- - Driven by a **Single Living Spec (`devflow/context/current-feature.md`)** that integrates architectural depth (Define, Spec, Plan, Execution Log, Multi-Lane QA, and Release Digest) into one clear living document.
19
+ - Driven by a **Task-Isolated Living Spec (`devflow/context/{xxx-slug}/spec.md`)** that integrates architectural depth (Define, Spec, Plan, Execution Log, Multi-Lane QA, and Release Digest) into dedicated task workspaces without root bottleneck.
20
20
  - **Pre-Flight Inception Engine**: Companion skills (`/discovery`, `/idea`, `/grill`, `/brainstorm`) feed directly into `/feature`.
21
21
 
22
22
  ---
@@ -26,13 +26,13 @@ Nexus-DevFlow uses a **Single Unified Living Spec Model**:
26
26
  When invoked without an argument (or when determining the next step), inspect:
27
27
 
28
28
  1. **Project Setup Baseline**: Read `devflow/context/project-overview.md` and `devflow/context/coding-standards.md`. If empty or default placeholders, recommend `onboard` (for fresh projects) or `adopt` (for existing codebases).
29
- 2. **Active Delivery Run**: Read `devflow/context/current-stage.md` and `devflow/context/current-feature.md`.
30
- - If `current-feature.md` has incomplete checklist tasks (`- [ ]`) -> Recommend `/implement`.
31
- - If all tasks are completed (`- [x]`) but no passing verification evidence in Section 5 -> Recommend `/check`.
32
- - If verification evidence passed in Section 5 -> Recommend `/complete`.
29
+ 2. **Active Delivery Runs**: Scan `devflow/context/{xxx-slug}/` subdirectories.
30
+ - If active `spec.md` has incomplete checklist tasks (`- [ ]`) -> Recommend `/implement [id]`.
31
+ - If all tasks are completed (`- [x]`) but no passing verification evidence in Section 5 -> Recommend `/check [id]`.
32
+ - If verification evidence passed in Section 5 -> Recommend `/complete [id]`.
33
33
  3. **Active Discovery**: Check `devflow/discoveries/` for open discovery notes.
34
34
  4. **Pending Ideas Inbox**: Check `devflow/ideas.md`. If items exist under `## 📌 Pending Ideas`, summarize them in a **💡 Pending Ideas (Inbox)** list with their IDs (`[IDEA-xxx]`), feasibility, and mention that they can be started with `/feature IDEA-xxx` or `/discovery IDEA-xxx`.
35
- 5. **Audit Findings Ledger**: Check `devflow/context/findings.md` for open high-severity findings.
35
+ 5. **Audit Findings Ledger**: Check `devflow/context/{xxx-slug}/findings.md` for open high-severity findings.
36
36
 
37
37
  ### Default State Recommendations
38
38
  - If no run is active and user wants to start a feature -> Recommend `/feature <name>`.
@@ -55,7 +55,8 @@ When invoked without an argument (or when determining the next step), inspect:
55
55
  | **"Execute implementation tasks"** | `implement` | `/implement` | **Core Loop**: `/implement` -> `/check` |
56
56
  | **"Run QA verification & check"** | `check` | `/check` | **Core Loop**: `/check` -> `/complete` |
57
57
  | **"Complete run & git merge"** | `complete` | `/complete` | **Core Loop**: `/complete` |
58
- | **"Generate HTML dashboard report"**| `report-html` | `/report:html` | **Standalone**: Converts `current-feature.md` or archive to HTML |
58
+ | **"Generate HTML dashboard report"**| `report-html` | `/report:html` | **Standalone**: Converts living spec or archive to HTML |
59
+ | **"Create editorial diagram / flowchart"**| `diagram-design`| `/diagram-design` | **Third-Party**: 39 visual diagrams (HTML/SVG) |
59
60
  | "Setup DevFlow on fresh/new project" | `onboard` | `onboard` / `setup` | `onboard` -> `/feature` |
60
61
  | "Adopt DevFlow on existing codebase" | `adopt` | `adopt` / `bootstrap` | `adopt` -> `/feature` |
61
62
  | "Check setup health & diagnostics" | `doctor` | `doctor` / `health` | `doctor` |
@@ -72,8 +73,8 @@ When invoked without an argument (or when determining the next step), inspect:
72
73
  ## Available Skills Sitemap
73
74
 
74
75
  ### 1. Mainline Living Spec Loop (4 Steps)
75
- - `feature` (`/feature`, `/spec`) - Define, spec, and plan in `current-feature.md`
76
- - `fix` (`/fix`) - Document an ad-hoc bug or change in `current-feature.md`
76
+ - `feature` (`/feature`, `/spec`) - Define, spec, and plan in `devflow/context/{xxx-slug}/spec.md`
77
+ - `fix` (`/fix`) - Document an ad-hoc bug or change in `devflow/context/{xxx-slug}/spec.md`
77
78
  - `implement` (`/implement`) - Execute planned checklist tasks with TDD
78
79
  - `check` (`/check`) - Senior QA review, multi-lane verification, record evidence
79
80
  - `complete` (`/complete`) - Safety pass, release digest, git merge, close run
@@ -94,4 +95,8 @@ When invoked without an argument (or when determining the next step), inspect:
94
95
  - `report-html` - Standalone interactive HTML report dashboard
95
96
  - `debug` - Root-cause investigation without editing code
96
97
  - `rollback` - Safe reversal of completed features
97
- - `release` - Deployment readiness check
98
+ - `release` - Deployment readiness check
99
+
100
+ ### 4. Installed Third-Party Skills & Extensions
101
+ - `diagram-design` (`/diagram-design`) - 39 editorial visual diagram types (HTML/SVG) for system architecture, sequence flows, ER models, data platform pipelines, and journeys.
102
+ - *Use `nexus-devflow skill add <url>` to install more third-party skills.*
@@ -57,7 +57,7 @@ devflow/discoveries/{DISCOVERY_ID}-{slug}/discovery.md
57
57
  ```
58
58
  *(A Discovery ID uses the namespace `DISC-YYYYMMDD-NNN`. It is not a Running ID and does not reserve a numeric delivery run.)*
59
59
 
60
- ### 5 Supporting Routes & Built-in Lenses:
60
+ ### 6 Supporting Routes & Built-in Lenses:
61
61
 
62
62
  1. **Brainstorming Lens (Divergent & Convergent)**:
63
63
  - Formulate 2-3 viable options with trade-offs.
@@ -72,11 +72,16 @@ devflow/discoveries/{DISCOVERY_ID}-{slug}/discovery.md
72
72
  5. **Socratic Grilling & Domain Alignment Lens (`grill`)**:
73
73
  - Codebase-grounded interactive inquiry to clarify entity boundaries, data flows, and edge cases.
74
74
  - Record agreed terminology in `devflow/context/glossary.md` and major architecture decisions in `devflow/decisions/ADR-xxx-{slug}.md`.
75
+ 6. **🎨 Visual Architecture & Diagram Design Lens (`diagram-design`)**:
76
+ - When exploring system topologies, legacy IT modernizations, sequence flows, data platform pipelines, or user journeys, check if the third-party skill `diagram-design` is installed in `.agents/skills/diagram-design/`.
77
+ - If available: Read `.agents/skills/diagram-design/SKILL.md` and load the matching type reference (e.g. `references/type-architecture.md`, `references/type-data-flow.md`, `references/type-sequence.md`, `references/type-journey.md`).
78
+ - Strictly follow the genuine design rules: editorial palette, style guide gate, target density 4/10, and self-contained HTML/SVG output.
79
+ - Save diagram artifacts to `devflow/discoveries/{DISCOVERY_ID}-{slug}/diagrams/{name}.html` and reference them directly in `discovery.md`.
75
80
 
76
81
  ### Decision & Approval Gate:
77
82
  Set one visible decision:
78
83
  - `Proceed`: Enough value and evidence exist to define delivery work:
79
- - Handoff to `/feature {discovery_id}` or `/fix {discovery_id}` to create the Single Living Spec in `devflow/context/current-feature.md`.
84
+ - Handoff to `/feature {discovery_id}` or `/fix {discovery_id}` to create the Task-Isolated Living Spec in `devflow/context/{xxx-slug}/spec.md`.
80
85
  - `Defer`: The idea remains relevant but timing or evidence is not ready.
81
86
  - `Reject`: The idea should not proceed under current framing.
82
87
 
@@ -85,5 +90,5 @@ Set one visible decision:
85
90
  ## Next Workflow Recommendations
86
91
 
87
92
  - **From Macro Project Mode**: Run `/overview` to compile context into `devflow/context/project-overview.md`.
88
- - **From Micro Pre-Flight (Approved Proceed)**: Run `/feature {discovery_id}` or `/fix {discovery_id}` to start the Single Living Spec lifecycle.
93
+ - **From Micro Pre-Flight (Approved Proceed)**: Run `/feature {discovery_id}` or `/fix {discovery_id}` to start the Task-Isolated Living Spec lifecycle.
89
94
  - **From Micro Pre-Flight (Defer / Reject)**: No next command needed.
@@ -30,10 +30,10 @@ Gather these, then summarize. Do not dump file contents.
30
30
  1. **Required DevFlow files**
31
31
  - Confirm `AGENTS.md`, `devflow/project-plan.md`,
32
32
  `devflow/build-plan.md`, and `devflow/context/` exist.
33
- - Confirm `devflow/context/coding-standards.md`,
34
- `devflow/context/ai-interaction.md`,
35
- `devflow/context/current-feature.md`, and
36
- `devflow/context/project-overview.md` exist.
33
+ - Confirm `devflow/context/project-overview.md`,
34
+ `devflow/context/coding-standards.md`,
35
+ `devflow/context/ai-interaction.md`, and
36
+ `devflow/context/glossary.md` exist.
37
37
  - Confirm `devflow/history/features/` and `devflow/history/fixes/` exist.
38
38
  When the rollback skill is installed, also check
39
39
  `devflow/history/rollbacks/`. A missing rollback folder on a legacy
@@ -129,16 +129,12 @@ Gather these, then summarize. Do not dump file contents.
129
129
  - If either planning file appears newer than the overview by filesystem time,
130
130
  call the overview possibly stale and suggest `/overview` before feature work.
131
131
  7. **Current workflow state**
132
- - Check whether `devflow/context/current-feature.md` is the reset stub or an
133
- active feature, fix, or rollback spec.
132
+ - Scan `devflow/context/{xxx-slug}/` for active task directories and specs.
134
133
  - If a spec is active, report checked and unchecked implementation steps.
135
- - If `current-feature.md` is the reset stub but git has source or workflow
134
+ - If no active task directory exists in `devflow/context/` but git has source or workflow
136
135
  changes, warn that work is happening without an active spec.
137
136
  - Flag active spec on `main`, all spec steps checked but no completion, or a
138
- branch that does not match `feature/`, `fix/`, or `rollback/` for the spec
139
- type. For a feature, also flag a mismatch with the next unchecked
140
- build-plan item. For a rollback, confirm its target is a checked item and do
141
- not compare it to the next unchecked item.
137
+ branch that does not match `feature/{xxx-slug}`, `fix/{xxx-slug}`, or `rollback/{xxx-slug}`.
142
138
  8. **Git**
143
139
  - Report current branch, clean vs dirty working tree, rough changed-file count,
144
140
  last commit subject, and whether the branch is ahead of upstream.
@@ -116,9 +116,8 @@ build plan starts high-level.
116
116
 
117
117
  ## Step 3 - write the spec
118
118
 
119
- For the one (sub-)feature being built now, write a full spec to
120
- `devflow/context/current-feature.md` (create `devflow/context/` if needed), following
121
- `reference/feature-spec-template.md`. Fill every section:
119
+ For the one (sub-)feature being built now, allocate sequential ID (`xxx-slug`) and create a dedicated workspace at `devflow/context/{xxx-slug}/`. Write the full living spec to
120
+ `devflow/context/{xxx-slug}/spec.md`, following `reference/feature-spec-template.md`. Also initialize `stage.md` and `findings.md` in that folder. Fill every section:
122
121
  - Goal, Problem Statement, and In/Out of scope
123
122
  - Acceptance Criteria (AC-1, AC-2, ...)
124
123
  - Small build steps as atomic 2-5 min checklist items (`- [ ]`, supporting `[TDD-Red]`, `[TDD-Green]`, `[TDD-Refactor]` triplets for functional logic)
@@ -178,7 +177,7 @@ code exists. Run the draft against these questions:
178
177
  test when a `test` command is declared in `AGENTS.md`, UI/integration rides on
179
178
  screenshot + build?
180
179
 
181
- Apply the fixes to `current-feature.md`. Then stop and present the spec, leading
180
+ Apply the fixes to `devflow/context/{xxx-slug}/spec.md`. Then stop and present the spec, leading
182
181
  with a short **"what the critique changed"** note - the splits, gaps, or scope
183
182
  cuts you made (or "nothing - the draft held up"). That note is the point: it shows
184
183
  the gate working before a line of code is written.
@@ -201,8 +200,8 @@ Tell the user to review and adjust. This skill plans; it never starts building.
201
200
  ## When a (sub-)feature is done
202
201
 
203
202
  Check its box in `build-plan.md` (and the parent item once all its sub-items are
204
- checked), archive the finished `devflow/context/current-feature.md` to
205
- `devflow/history/features/NN-name.md`, then run `/feature` again for the next one.
203
+ checked), archive the finished `devflow/context/{xxx-slug}/spec.md` to
204
+ `devflow/history/features/{xxx-slug}.md`, delete the run workspace `devflow/context/{xxx-slug}/`, then run `/feature` again for the next one.
206
205
 
207
206
  ## Formatting
208
207
 
@@ -21,14 +21,14 @@ it creates a dedicated run folder at `devflow/context/{xxx-slug}/` (e.g. `059-fi
21
21
  A description of the bug or change, for example `/fix "password reset email never
22
22
  sends"`. If the user just reported the problem in chat, use that.
23
23
 
24
- The input may also be a finding ID from `devflow/context/findings.md`, alone
24
+ The input may also be a finding ID from `devflow/context/{xxx-slug}/findings.md` (or previous findings), alone
25
25
  or with a description, for example `/fix F-03`.
26
26
 
27
27
  ## Step 1 - write the fix spec
28
28
 
29
29
  Pull context from `devflow/context/project-overview.md` and `devflow/context/coding-standards.md`,
30
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:
31
+ then write a short spec to `devflow/context/{xxx-slug}/spec.md`. Also initialize `stage.md` and `findings.md` in that folder. Keep it lighter than a feature spec:
32
32
 
33
33
  - **Title** - the bug or change in a few words.
34
34
  - **Type:** Fix (so `/complete` logs it to `devflow/history/fixes/`, not `devflow/history/features/`).
@@ -13,7 +13,7 @@ Where this sits in the workflow:
13
13
  reviewed) merge + log)
14
14
 
15
15
  `/feature`, `/fix`, or `/rollback` wrote the spec to
16
- `devflow/context/{xxx-slug}/spec.md` (or `devflow/context/current-feature.md`) and stopped.
16
+ `devflow/context/{xxx-slug}/spec.md` and stopped.
17
17
  This skill turns that spec into code, following the build loop in
18
18
  `devflow/context/ai-interaction.md`, without vibe coding: small steps, a visible diff plus
19
19
  a plain-English explanation for each, testing, and iteration until it works, all
@@ -24,11 +24,11 @@ checkpoint after each step; the work-level commit, merging, and logging are
24
24
  ## Multi-Run Target Resolution
25
25
 
26
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.
27
+ - **With no argument** (`/implement`) -> checks current git branch matching `feature/{xxx-slug}`, or auto-picks if only 1 spec is active in `devflow/context/`, or prompts the user if multiple specs are queued.
28
28
 
29
29
  ## Before you start
30
30
 
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
31
+ Read the target spec from `devflow/context/{xxx-slug}/spec.md`. If it has no real spec (missing or its
32
32
  status is already complete), stop and tell the user to run `/feature` (for a
33
33
  planned feature), `/fix` (for an ad-hoc bug or change), or `/rollback` (for a
34
34
  completed feature reversal) first. Pull the
@@ -45,13 +45,12 @@ feature was started earlier and interrupted (often a cleared context). The spec
45
45
  its ticked steps are files, so pick up where it left off: read which steps are done,
46
46
  check the git branch and `git status`/log to see what is committed and what is still
47
47
  in the working tree, then continue from the **first unchecked step** instead of
48
- starting over. No separate save/load is needed - the project instructions load
49
- `current-feature.md` every session.
48
+ starting over.
50
49
 
51
50
  ## Step 1 - branch
52
51
 
53
- Create and check out a branch named from the spec: `feature/<name>` for a feature,
54
- `fix/<name>` for a fix, or `rollback/<name>` for a Type: Rollback spec. If the
52
+ Create and check out a branch named from the spec: `feature/{xxx-slug}` for a feature,
53
+ `fix/{xxx-slug}` for a fix, or `rollback/{xxx-slug}` for a Type: Rollback spec. If the
55
54
  project isn't a git repo yet, say so and ask the user to run `git init` first;
56
55
  the loop needs branches. On resume, the branch already exists - check it out
57
56
  instead of creating a new one.
@@ -60,7 +59,7 @@ instead of creating a new one.
60
59
 
61
60
  For a rollback spec, do not hand-delete the old feature and do not run a whole
62
61
  commit `git revert`. Completed feature commits also contain Blueprint history and
63
- plan bookkeeping, while `current-feature.md` now contains the active rollback
62
+ plan bookkeeping, while `devflow/context/{xxx-slug}/spec.md` now contains the active rollback
64
63
  spec. Reversing the whole commit would damage that state.
65
64
 
66
65
  Before the first rollback build step:
@@ -133,9 +132,9 @@ Work through the spec's build steps in order, one at a time. For each step:
133
132
  Repeat until it works and the user approves. Nothing is committed until the
134
133
  user is happy with the step.
135
134
  6. **Mark it done, then prompt to move on.** Once the step is approved, check that
136
- step off (`- [x]`) in `devflow/context/current-feature.md` so progress survives a context
135
+ step off (`- [x]`) in `devflow/context/{xxx-slug}/spec.md` so progress survives a context
137
136
  clear. If the step repaired a finding tracked in
138
- `devflow/context/findings.md`, set that finding's status to `fixed` now too
137
+ `devflow/context/{xxx-slug}/findings.md`, set that finding's status to `fixed` now too
139
138
  and note the repair in its **Resolution** line. Never set `closed`: a repair
140
139
  is re-reviewed by `/audit` before it clears, because a fix can introduce a
141
140
  worse defect than the one it removed. Then offer a short choice, noting that checkpoints are optional since
@@ -164,12 +163,12 @@ pass before any commit.
164
163
 
165
164
  ## Step 3 - hand off to /complete
166
165
 
167
- Before handing off, check `devflow/context/findings.md`. A P0 or P1 finding
166
+ Before handing off, check `devflow/context/{xxx-slug}/findings.md`. A P0 or P1 finding
168
167
  still `open` or `fixed` there means `/complete` will refuse the merge, so close
169
168
  the loop now:
170
169
 
171
170
  - Repair each `open` P0 or P1 as an extra reviewed step. First append it to the
172
- spec's build steps in `current-feature.md` (`- [ ] Repair F-03 - <title>`) so
171
+ spec's build steps in `devflow/context/{xxx-slug}/spec.md` (`- [ ] Repair F-03 - <title>`) so
173
172
  the repair is on the record and survives a context clear, then run the same
174
173
  loop as Step 2: smallest change, diff, plain-English explanation, evidence.
175
174
  Check the step off and mark the finding `fixed` together.
@@ -46,7 +46,7 @@ Read:
46
46
  - `devflow/project-plan.md`
47
47
  - `devflow/build-plan.md`
48
48
  - `devflow/context/project-overview.md`
49
- - `devflow/context/current-feature.md`
49
+ - `devflow/context/{xxx-slug}/spec.md` (when a task is active)
50
50
  - package or build files such as `package.json`, lockfiles, framework config,
51
51
  Dockerfile, `render.yaml`, `vercel.json`, `.env.example`, and README files
52
52
  - git branch and working tree status
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: report-html
3
- description: "[devflow] Standalone HTML Report Generator - render an interactive standalone HTML dashboard from current-feature.md or history archives on demand."
3
+ description: "[devflow] Standalone HTML Report Generator - render an interactive standalone HTML dashboard from devflow/context/{xxx-slug}/spec.md or history archives on demand."
4
4
  argument-hint: "[{running-id or workspace path}]"
5
5
  ---
6
6
 
@@ -8,7 +8,7 @@ argument-hint: "[{running-id or workspace path}]"
8
8
 
9
9
  $ARGUMENTS
10
10
 
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/`.
11
+ Standalone companion command to generate an interactive, self-contained HTML report dashboard on demand from task-specific context `devflow/context/{xxx-slug}/spec.md`, or archived history files in `devflow/history/`.
12
12
 
13
13
  > [!NOTE]
14
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.
@@ -26,7 +26,7 @@ When invoked:
26
26
 
27
27
  ### 1. Identify Target Run
28
28
  1. Locate target markdown document:
29
- - Active Living Spec: `devflow/context/current-feature.md` or `devflow/context/{xxx-slug}/spec.md`
29
+ - Active Living Spec: `devflow/context/{xxx-slug}/spec.md`
30
30
  - Archived History: `devflow/history/{features|fixes|rollbacks}/{xxx-slug}.md`
31
31
  2. Parse spec sections, checklist steps, QA evidence, and verification logs.
32
32
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: rollback
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."
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/{xxx-slug}/spec.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
@@ -33,14 +33,12 @@ the feature was removed.
33
33
 
34
34
  ## Step 0 - preflight
35
35
 
36
- Read `AGENTS.md`, `devflow/build-plan.md`,
37
- `devflow/context/current-feature.md`, the completed feature archives, and git
36
+ Read `AGENTS.md`, `devflow/build-plan.md`, the completed feature archives, and git
38
37
  state.
39
38
 
40
39
  Stop before writing when:
41
40
 
42
41
  - the directory is not a git repository
43
- - `current-feature.md` already holds active work
44
42
  - the working tree is dirty, including unrelated untracked work
45
43
  - the current branch is not the local main or default branch
46
44
  - the target is not a checked build-plan feature with a matching archive
@@ -107,8 +105,8 @@ remediation or explicitly plan the dependent rollbacks.
107
105
 
108
106
  ## Step 4 - write the rollback spec
109
107
 
110
- Write `devflow/context/current-feature.md` using
111
- `reference/rollback-spec-template.md`. Fill in:
108
+ Allocate sequential ID (`xxx-slug`) and create `devflow/context/{xxx-slug}/`. Write `devflow/context/{xxx-slug}/spec.md` using
109
+ `reference/rollback-spec-template.md`. Also initialize `stage.md` and `findings.md` in that folder. Fill in:
112
110
 
113
111
  - target feature, archive, exact commit, and parent commit
114
112
  - user's reason
@@ -34,14 +34,13 @@ state.
34
34
  1. **Build plan** - `devflow/build-plan.md`. Count checked vs unchecked leaf
35
35
  items. Name the next unchecked leaf, the same target `/feature` would pick,
36
36
  and note if a parent item was split into sub-items (`4a`, `4b`, ...).
37
- 2. **Current work** - `devflow/context/current-feature.md`. Is something in
38
- progress, or is it the reset stub? If a feature, fix, or rollback spec is
39
- present, report its type and name, which build steps are checked, and the
40
- first unchecked step where `/implement` resumes.
41
- 3. **Findings** - `devflow/context/findings.md`. Count findings by status and
37
+ 2. **Current work & Spec Queue** - scan `devflow/context/{xxx-slug}/`. Is something in
38
+ progress? If a feature, fix, or rollback spec is
39
+ present, report its type, name, running ID, which build steps are checked, and the
40
+ first unchecked step where `/implement` resumes. If multiple tasks are queued, list the active spec queue.
41
+ 3. **Findings** - `devflow/context/{xxx-slug}/findings.md`. Count findings by status and
42
42
  report open and fixed counts next to build-plan progress. Call out any P0 or
43
- P1 still `open` or `fixed` by ID, since those block `/complete`. A missing
44
- file means no findings.
43
+ P1 still `open` or `fixed` by ID, since those block `/complete`.
45
44
  4. **Overview freshness** - if `devflow/context/project-overview.md` is missing,
46
45
  or if `project-plan.md` or `build-plan.md` appears newer than it by filesystem
47
46
  time, mention that `/overview` should run before new feature work.
@@ -49,38 +48,32 @@ state.
49
48
  changes, roughly how many files changed, last commit subject, and whether the
50
49
  branch is ahead of its remote. If the directory is not a git repo, say so and
51
50
  skip this part rather than failing.
52
- 6. **Progress drift** - flag active spec on `main`, a spec in progress but no
53
- matching `feature/`, `fix/`, or `rollback/` branch, all spec steps checked but
54
- not completed, or disagreement between `build-plan.md` and
55
- `current-feature.md`. A rollback legitimately targets a checked build-plan
56
- item until `/complete` unchecks it, so do not compare it to the next unchecked
57
- feature.
51
+ 6. **Progress drift** - flag active task on `main`, a spec in progress but no
52
+ matching `feature/{xxx-slug}`, `fix/{xxx-slug}`, or `rollback/{xxx-slug}` branch, all spec steps checked but
53
+ not completed, or disagreement between `build-plan.md` and active specs.
58
54
 
59
55
  ## Output
60
56
 
61
57
  A short, scannable summary, not a wall of text. Aim for something like:
62
58
 
63
- Status: Building feature 4 - PDF export
64
- Plans: Overview current. Build plan 3 of 9 complete.
65
- Current work: Step 2 of 3 done. Next step: Download PDF button.
66
- Findings: 1 open P2 (F-04), 1 fixed P1 awaiting re-review (F-02).
67
- Git: branch feature/pdf-export, 3 uncommitted files, last commit "feat: widen export helper".
68
- Watch: F-02 is fixed but not re-reviewed; it blocks /complete until /audit closes it.
59
+ Status: Building feature 061 - Pure Multi-Run Architecture
60
+ Plans: Overview current. Build plan 13 of 14 complete.
61
+ Current work: Step 2 of 4 done. Next step: Update Directives & Documentation.
62
+ Findings: 0 blockers in 061-pure-multi-run-task-isolated-architecture/findings.md.
63
+ Git: branch feature/061-pure-multi-run-task-isolated-architecture, 3 uncommitted files.
69
64
 
70
- Next action: run /implement for Step 3.
65
+ Next action: run /implement 061 for Task 2.
71
66
 
72
67
  End with a single suggested next action, chosen in this order:
73
68
 
74
69
  - The overview is missing or stale and no feature is in progress -> `/overview`.
75
- - A spec is in progress with unchecked steps -> `/implement` and name the step.
76
- - A spec is in progress and all implementation steps are checked -> `/check` if
70
+ - A spec is in progress with unchecked steps -> `/implement [id]` and name the step.
71
+ - A spec is in progress and all implementation steps are checked -> `/check [id]` if
77
72
  proof is not recorded, `/try` if the user wants a manual review path,
78
- `/implement` when a P0 or P1 finding is still `open` (the repair is an extra
73
+ `/implement [id]` when a P0 or P1 finding is still `open` (the repair is an extra
79
74
  reviewed step), `/audit` when one is `fixed` and awaiting re-review (both
80
- block `/complete`), otherwise `/complete`.
81
- - `current-feature.md` is the reset stub and a P0 or P1 finding is `open` ->
82
- `/fix <finding id>`; when one is `fixed`, `/audit` to re-review and close it.
83
- - `current-feature.md` is the reset stub and unchecked build-plan items remain ->
75
+ block `/complete`), otherwise `/complete [id]`.
76
+ - No active tasks in `devflow/context/` and unchecked build-plan items remain ->
84
77
  `/feature` and name the next build-plan item.
85
78
  - All build-plan items are checked -> say the current milestone is complete;
86
79
  suggest hardening, release, or docs when appropriate, or
@@ -23,10 +23,10 @@ merge, push, or run destructive commands.
23
23
  Optional scope:
24
24
 
25
25
  - no argument: use the active feature, fix, or rollback in
26
- `devflow/context/current-feature.md`
26
+ `devflow/context/{xxx-slug}/spec.md`
27
27
  - `latest`: use the most recent archive under `devflow/history/features/`,
28
28
  `devflow/history/fixes/`, or `devflow/history/rollbacks/`
29
- - a step name or number: focus the guide on that current-feature step
29
+ - a step name or number: focus the guide on that active step
30
30
  - a path, route, or command: include it as the main thing to try
31
31
 
32
32
  If there is no active feature and no useful archive, ask what change the user
@@ -37,16 +37,15 @@ wants to try instead of guessing.
37
37
  Read:
38
38
 
39
39
  - `AGENTS.md`
40
- - `devflow/context/current-feature.md`
40
+ - `devflow/context/{xxx-slug}/spec.md` (or active task workspace)
41
41
  - `devflow/context/project-overview.md`
42
42
  - `devflow/context/coding-standards.md`
43
43
  - `devflow/build-plan.md`
44
44
  - latest files under `devflow/history/features/`,
45
- `devflow/history/fixes/`, and `devflow/history/rollbacks/`, if the current
46
- feature is reset
45
+ `devflow/history/fixes/`, and `devflow/history/rollbacks/`, if no task is active
47
46
  - git branch and working tree status
48
47
 
49
- Prefer the active spec. If `current-feature.md` is the reset stub, use the most
48
+ Prefer the active task spec. If no active task directory exists, use the most
50
49
  recent archived feature, fix, or rollback by filename or modification time and
51
50
  say that is what you used.
52
51