@jakkrichm/create-nexus-devflow 2.0.16 → 2.0.19

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/dist/bin/create-nexus-devflow.d.ts +2 -1
  2. package/dist/bin/create-nexus-devflow.js +85 -3
  3. package/dist/bin/create-nexus-devflow.js.map +1 -1
  4. package/dist/lib/current-work.d.ts +2 -3
  5. package/dist/lib/current-work.js +93 -66
  6. package/dist/lib/current-work.js.map +1 -1
  7. package/dist/lib/uninstall.d.ts +20 -0
  8. package/dist/lib/uninstall.js +129 -0
  9. package/dist/lib/uninstall.js.map +1 -0
  10. package/dist/scripts/prepare-template.js +120 -10
  11. package/dist/scripts/prepare-template.js.map +1 -1
  12. package/package.json +1 -1
  13. package/template/.agents/skills/00-discover/SKILL.md +2 -2
  14. package/template/.agents/skills/10-define/SKILL.md +24 -140
  15. package/template/.agents/skills/20-spec/SKILL.md +2 -2
  16. package/template/.agents/skills/30-plan/SKILL.md +2 -2
  17. package/template/.agents/skills/50-verify/SKILL.md +2 -2
  18. package/template/.agents/skills/60-report/SKILL.md +1 -1
  19. package/template/.agents/skills/70-release/SKILL.md +19 -143
  20. package/template/.agents/skills/check/SKILL.md +10 -10
  21. package/template/.agents/skills/ci/SKILL.md +1 -1
  22. package/template/.agents/skills/complete/SKILL.md +49 -28
  23. package/template/.agents/skills/deploy/SKILL.md +1 -1
  24. package/template/.agents/skills/devflow/SKILL.md +5 -5
  25. package/template/.agents/skills/feature/SKILL.md +25 -20
  26. package/template/.agents/skills/fix/SKILL.md +25 -19
  27. package/template/.agents/skills/implement/SKILL.md +10 -10
  28. package/template/.agents/skills/insight/SKILL.md +1 -1
  29. package/template/.agents/skills/overview/SKILL.md +3 -3
  30. package/template/.agents/skills/report-html/SKILL.md +3 -3
  31. package/template/.agents/skills/security-review/SKILL.md +1 -1
  32. package/template/.agents/skills/spec/SKILL.md +7 -6
  33. package/template/.agents/skills/spec-driven-development/SKILL.md +2 -2
  34. package/template/.agents/skills/test/SKILL.md +1 -1
  35. package/template/.claude/skills/00-discover/SKILL.md +2 -2
  36. package/template/.claude/skills/10-define/SKILL.md +24 -140
  37. package/template/.claude/skills/20-spec/SKILL.md +2 -2
  38. package/template/.claude/skills/30-plan/SKILL.md +2 -2
  39. package/template/.claude/skills/50-verify/SKILL.md +2 -2
  40. package/template/.claude/skills/60-report/SKILL.md +1 -1
  41. package/template/.claude/skills/70-release/SKILL.md +19 -143
  42. package/template/.claude/skills/check/SKILL.md +10 -10
  43. package/template/.claude/skills/ci/SKILL.md +1 -1
  44. package/template/.claude/skills/complete/SKILL.md +49 -28
  45. package/template/.claude/skills/deploy/SKILL.md +1 -1
  46. package/template/.claude/skills/devflow/SKILL.md +5 -5
  47. package/template/.claude/skills/feature/SKILL.md +25 -20
  48. package/template/.claude/skills/fix/SKILL.md +25 -19
  49. package/template/.claude/skills/implement/SKILL.md +10 -10
  50. package/template/.claude/skills/insight/SKILL.md +1 -1
  51. package/template/.claude/skills/overview/SKILL.md +3 -3
  52. package/template/.claude/skills/report-html/SKILL.md +3 -3
  53. package/template/.claude/skills/security-review/SKILL.md +1 -1
  54. package/template/.claude/skills/spec/SKILL.md +7 -6
  55. package/template/.claude/skills/spec-driven-development/SKILL.md +2 -2
  56. package/template/.claude/skills/test/SKILL.md +1 -1
  57. package/template/AGENTS.md +15 -59
  58. package/template/devflow/context/ai-interaction.md +110 -23
  59. package/template/devflow/context/coding-standards.md +123 -32
  60. package/template/devflow/context/current-feature.md +3 -0
  61. package/template/devflow/context/current-stage.md +6 -6
  62. package/template/devflow/context/findings.md +10 -10
  63. package/template/devflow/context/project-overview.md +18 -32
  64. package/template/devflow/history/HISTORY.md +10 -25
  65. package/template/devflow/ideas.md +9 -5
  66. package/template/devflow/reference/running-id-contract.md +39 -39
  67. package/template/devflow/runs/.gitkeep +0 -0
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: check
3
- description: "[Devflow] Fast-Track Check stage in DevFlow (Blueprint Mode) - perform senior QA review, run multi-lane verification, and record evidence in spec.md."
3
+ description: "[Devflow] Fast-Track Check stage in DevFlow (Blueprint Mode) - perform senior QA review, run multi-lane verification, and record evidence in current-feature.md in context."
4
4
  argument-hint: "{running-id or workspace path}"
5
5
  ---
6
6
 
@@ -8,18 +8,18 @@ argument-hint: "{running-id or workspace path}"
8
8
 
9
9
  $ARGUMENTS
10
10
 
11
- Quality assurance and multi-lane verification stage in Fast-Track. Validates the implementation against Acceptance Criteria, runs test suites, checks for regressions, and records evidence in the Single Living Spec (`spec.md`).
11
+ Quality assurance and multi-lane verification stage in Fast-Track. Validates the implementation against Acceptance Criteria, runs test suites, checks for regressions, and records evidence in the Single Living Spec (`devflow/context/current-feature.md`).
12
12
 
13
13
  ## Invocations & Aliases
14
14
 
15
15
  - `/check`: Run verification on current active run
16
- - `/check {running-id}`: Run verification on specified running ID
16
+ - `/check {id}`: Run verification on specified ID
17
17
  - `$check`: Codex CLI invocation
18
18
 
19
19
  ## Fast-Track Mainline Workflow
20
20
 
21
21
  ```text
22
- /spec ──▶ /implement ──▶ /check ──▶ /complete
22
+ /feature (หรือ /fix) ──▶ /implement ──▶ /check ──▶ /complete
23
23
  ```
24
24
 
25
25
  ## Behavior & Contract
@@ -27,8 +27,8 @@ Quality assurance and multi-lane verification stage in Fast-Track. Validates the
27
27
  When invoked:
28
28
 
29
29
  ### 1. Load Active Context
30
- 1. Identify active Running ID from `devflow/context/current-stage.md` or argument.
31
- 2. Read `devflow/runs/{RUNNING_ID}/spec.md`.
30
+ 1. Identify active Running ID from `devflow/context/current-stage.md` or `devflow/context/current-feature.md`.
31
+ 2. Read `devflow/context/current-feature.md`.
32
32
  3. Locate `## 1. Specification & Scope` (Acceptance Criteria) and `## 3. Implementation Checklist`.
33
33
 
34
34
  ### 2. Multi-lane Verification Execution
@@ -41,8 +41,8 @@ Execute the verification gates across all lanes:
41
41
  - Verify specific scenarios against Acceptance Criteria (`AC-1`, `AC-2`).
42
42
  - Summarize "Where to go", "What to click/call", and "What to expect".
43
43
 
44
- ### 3. Update Living Spec (`spec.md`)
45
- Append or update `## 5. Verification Evidence` in `spec.md` in **Thai (`th`)**:
44
+ ### 3. Update Living Spec (`current-feature.md`)
45
+ Append or update `## 5. Verification Evidence` in `devflow/context/current-feature.md` in **Thai (`th`)**:
46
46
 
47
47
  ```markdown
48
48
  ## 5. Verification Evidence
@@ -64,5 +64,5 @@ Update `devflow/context/current-stage.md`:
64
64
  ### 5. Output Summary & Next Step
65
65
  Report to the user:
66
66
  - Summary of verification results across all lanes
67
- - Evidence recorded in `spec.md`
68
- - **Next Command**: `/complete` (or `/complete {RUNNING_ID}`)
67
+ - Evidence recorded in `devflow/context/current-feature.md`
68
+ - **Next Command**: `/complete` (or `/complete {ID}`)
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: ci
3
- description: "[Devflow] CI/CD pipeline automation and GitHub Actions setup (.github/workflows/verify.yml). Automates quality gates, typechecks, tests, and build checks."
3
+ description: "[Devflow] Set up automated GitHub Actions CI workflow (.github/workflows/verify.yml) aligned with project verify command."
4
4
  ---
5
5
 
6
6
  # CI/CD Pipeline Automation & Quality Gates
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: complete
3
- description: "[Devflow] Fast-Track Complete stage in DevFlow (Blueprint Mode) - perform final safety pass, record release digest in spec.md, git merge, and close run without auto HTML generation."
3
+ description: "[Devflow] Fast-Track Complete stage in DevFlow (Blueprint Mode) - final safety pass, archive living spec into categorized history, reset stub, git merge, and close run."
4
4
  argument-hint: "{running-id or workspace path}"
5
5
  ---
6
6
 
@@ -8,18 +8,18 @@ argument-hint: "{running-id or workspace path}"
8
8
 
9
9
  $ARGUMENTS
10
10
 
11
- Final delivery, safety pass, and run closure stage in Fast-Track. Validates verification status, records the Release Digest into `spec.md`, performs git merge, and marks the run as completed **without auto-generating HTML reports**.
11
+ Final delivery, safety pass, archive, and run closure stage in Fast-Track. Validates verification status, archives `devflow/context/current-feature.md` to `devflow/history/{features|fixes|rollbacks}/{xxx-slug}.md`, resets the stub, performs git merge, and closes the run **without auto-generating HTML reports**.
12
12
 
13
13
  ## Invocations & Aliases
14
14
 
15
15
  - `/complete`: Complete current active run
16
- - `/complete {running-id}`: Complete specified running ID
16
+ - `/complete {id}`: Complete specified ID
17
17
  - `$complete`: Codex CLI invocation
18
18
 
19
19
  ## Fast-Track Mainline Workflow
20
20
 
21
21
  ```text
22
- /spec ──▶ /implement ──▶ /check ──▶ /complete
22
+ /feature (หรือ /fix) ──▶ /implement ──▶ /check ──▶ /complete
23
23
  ```
24
24
 
25
25
  ## Behavior & Contract
@@ -27,47 +27,68 @@ Final delivery, safety pass, and run closure stage in Fast-Track. Validates veri
27
27
  When invoked:
28
28
 
29
29
  ### 1. Validate Delivery Pre-conditions
30
- 1. Identify active Running ID from `devflow/context/current-stage.md` or argument.
31
- 2. Read `devflow/runs/{RUNNING_ID}/spec.md`.
30
+ 1. Identify active Running ID from `devflow/context/current-stage.md` or `devflow/context/current-feature.md`.
31
+ 2. Read `devflow/context/current-feature.md`.
32
32
  3. Confirm:
33
+ - File contains an active spec (not the idle stub `_Nothing in progress._`).
33
34
  - All checklist items in `## 3. Implementation Checklist` are marked `- [x]`.
34
- - `## 5. Verification Evidence` contains passing verification results.
35
+ - `## 5. Verification Evidence` contains passing verification results and empirical command outputs.
35
36
 
36
- ### 2. Final Safety Pass & Changelog
37
+ ### 2. Final Safety Pass & Findings Check
37
38
  1. Verify working directory hygiene (no accidental leftover test files or debug statements).
38
- 2. Update `CHANGELOG.md` with release summary under the current version if applicable.
39
-
40
- ### 3. Update Living Spec (`spec.md`)
41
- Append or update `## 6. Release & Handoff` in `spec.md` in **Thai (`th`)**:
42
-
39
+ 2. Inspect `devflow/context/findings.md`:
40
+ - No `P0` or `P1` finding is in `open` or `fixed` status (`fixed` requires re-audit).
41
+ - Only `closed`, `accepted` (user waived), or `invalid` findings are permitted for completion.
42
+
43
+ ### 3. Update Living Spec & Archive to Categorized History
44
+ 1. Append `## 6. Release & Handoff` in `current-feature.md` in **Thai (`th`)**:
45
+ ```markdown
46
+ ## 6. Release & Handoff
47
+ - **Release Digest**: สรุปสิ่งที่ส่งมอบในรอบนี้
48
+ - **Git Branch**: `{branch_name}`
49
+ - **Merge Status**: Merged into `main` (Commit `{commit_hash}`)
50
+ - **Archive Date**: {YYYY-MM-DD}
51
+ ```
52
+ 2. Determine Category:
53
+ - If spec has `Category: Fix` or `Type: Fix` ➔ `fixes`
54
+ - If spec has `Category: Rollback` or `Type: Rollback` ➔ `rollbacks`
55
+ - Otherwise ➔ `features`
56
+ 3. Archive `devflow/context/current-feature.md` ➔ `devflow/history/{category}/{xxx-slug}.md`.
57
+ 4. If `findings.md` contains resolved entries (`closed`, `accepted`, `invalid`), append a `## Resolved Findings` section to the archive file and clean those resolved entries from `findings.md`.
58
+ 5. **Reset Living Spec Stub**: Reset `devflow/context/current-feature.md` to:
59
+ ```markdown
60
+ # Current Feature
61
+
62
+ _Nothing in progress. Run /feature, /fix, or /rollback to start._
63
+ ```
64
+
65
+ ### 4. Update Master Ledger (`HISTORY.md`)
66
+ Append a new row to `devflow/history/HISTORY.md` under `## 📜 Master Release Log`:
43
67
  ```markdown
44
- ## 6. Release & Handoff
45
- - **Release Digest**: สรุปสิ่งที่ส่งมอบในรอบนี้
46
- - **Git Branch**: `{branch_name}`
47
- - **Merge Status**: Merged into `main` (Commit `{commit_hash}`)
48
- - **Artifact Contract**: Fast-Track Single Living Spec completed.
68
+ | {YYYY-MM-DD} | `{ID}` | {Category} | {Title} | `{commit_hash}` | `Released` | [`{xxx-slug}.md`]({category}/{xxx-slug}.md) |
49
69
  ```
50
- Update header status in `spec.md`: `> **Status**: Completed`.
51
70
 
52
- ### 4. Policy on HTML Reports (Strict Rule)
71
+ ### 5. Policy on HTML Reports (Strict Rule)
53
72
  > [!IMPORTANT]
54
73
  > **No Auto-Generated HTML**: ห้ามสร้างไฟล์ `report.html` หรือ `60-report.html` แบบอัตโนมัติในขั้นตอนนี้โดยเด็ดขาด!
55
74
  > หากผู้ใช้ต้องการดู HTML Dashboard สวยงาม ให้แจ้งผู้ใช้ว่าสามารถเรียกคำสั่งแยกได้: `/report:html`
56
75
 
57
- ### 5. Git Merge & Branch Cleanup
58
- 1. Commit all modified tracking files (including `spec.md` and `current-stage.md`).
59
- 2. Merge feature branch into target base branch (`main` / `master`).
76
+ ### 6. Git Merge & Branch Cleanup
77
+ 1. Commit all modified tracking files.
78
+ 2. Squash-merge feature branch into target base branch (`main` / `master`) with explicit user approval.
60
79
 
61
- ### 6. Close Active Run
80
+ ### 7. Close Active Run
62
81
  Update `devflow/context/current-stage.md`:
82
+ - `Active Discovery ID`: `None`
63
83
  - `Active Running ID`: `None (Idle)`
64
- - `Current Stage`: `Idle (Ready for new /spec, /feature, /fix, or /00-discover)`
65
- - `Last Completed Run`: `{RUNNING_ID} ({YYYY-MM-DD})`
84
+ - `Current Stage`: `Idle (Ready for new /feature, /fix, or /00-discover)`
85
+ - `Living Spec`: `None`
86
+ - `Last Completed Run`: `{ID} ({YYYY-MM-DD})`
66
87
  - `Last Updated`: `{YYYY-MM-DD}`
67
88
 
68
- ### 7. Output Completion Report
89
+ ### 8. Output Completion Report
69
90
  Report to the user:
70
91
  - Run successfully completed and merged
71
- - Living Spec path: `devflow/runs/{RUNNING_ID}/spec.md`
92
+ - Archived path: `devflow/history/{category}/{xxx-slug}.md`
72
93
  - Standalone HTML command tip: `/report:html` (if HTML view is desired)
73
94
  - Workspace is now Idle and ready for the next task.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: deploy
3
- description: "[Devflow] Production deployment pre-flight checks, launch readiness, smoke validation, and deployment execution."
3
+ description: "[Devflow] Production deployment pre-flight checks, smoke validation, and deployment execution."
4
4
  ---
5
5
 
6
6
  # Production Deployment & Launch Readiness
@@ -16,7 +16,7 @@ Use this skill to guide the user on what to do next, inspect current workspace s
16
16
 
17
17
  Nexus-DevFlow supports two seamless workflow tracks:
18
18
  1. **🏎️ Fast-Track (Blueprint Mode - 4 Steps)**: `/spec` ➔ `/implement` ➔ `/check` ➔ `/complete`
19
- *Driven by a **Single Living Spec (`spec.md`)** for fast, high-velocity daily development and bugfixes (85% of tasks).*
19
+ *Driven by a **Single Living Spec (`current-feature.md`)** for fast, high-velocity daily development and bugfixes (85% of tasks).*
20
20
  2. **🏗️ Deep-Track (Architect Mode - 8 Steps)**: `00-discover` ➔ `10-define` ➔ `20-spec` ➔ `30-plan` ➔ `40-execute` ➔ `50-verify` ➔ `60-report` ➔ `70-release`
21
21
  *Driven by modular separate stage files for large, high-stakes architectural epics and multi-agent coordination.*
22
22
 
@@ -28,8 +28,8 @@ When invoked without an argument (or when determining the next step), inspect:
28
28
 
29
29
  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).
30
30
  2. **Active Delivery Run**: Read `devflow/context/current-stage.md` and check `devflow/runs/{RUNNING_ID}/`.
31
- - **If Fast-Track (`spec.md` or `blueprint.md` present)**:
32
- - If `spec.md` has incomplete checklist items -> Recommend `/implement` (or `implement {RUNNING_ID}`).
31
+ - **If Fast-Track (`current-feature.md`, `spec.md`, or `blueprint.md` present)**:
32
+ - If `current-feature.md` (or `spec.md`) has incomplete checklist items -> Recommend `/implement` (or `implement {RUNNING_ID}`).
33
33
  - If all tasks done but no passing verification evidence -> Recommend `/check` (or `check {RUNNING_ID}`).
34
34
  - If verification evidence passed -> Recommend `/complete` (or `complete {RUNNING_ID}`).
35
35
  - **If Deep-Track (numbered stage files present)**:
@@ -61,7 +61,7 @@ When invoked without an argument (or when determining the next step), inspect:
61
61
  | **"Execute implementation tasks"** | `implement` | `/implement` | **Fast-Track**: `/implement` -> `/check` |
62
62
  | **"Run QA verification & check"** | `check` | `/check` | **Fast-Track**: `/check` -> `/complete` |
63
63
  | **"Complete run & git merge"** | `complete` | `/complete` | **Fast-Track**: `/complete` |
64
- | **"Generate HTML dashboard report"**| `report-html` | `/report:html` | **Standalone**: Converts `spec.md` / `60-report.md` to HTML |
64
+ | **"Generate HTML dashboard report"**| `report-html` | `/report:html` | **Standalone**: Converts `current-feature.md` / `60-report.md` to HTML |
65
65
  | "Setup DevFlow on fresh/new project" | `onboard` | `onboard` / `setup` | `onboard` -> `/spec` or `10-define` |
66
66
  | "Adopt DevFlow on existing codebase" | `adopt` | `adopt` / `bootstrap` | `adopt` -> `/spec` or `10-define` |
67
67
  | "Check setup health & diagnostics" | `doctor` | `doctor` / `health` | `doctor` |
@@ -85,7 +85,7 @@ When invoked without an argument (or when determining the next step), inspect:
85
85
  ## Available Skills Sitemap
86
86
 
87
87
  ### 1. Fast-Track (Blueprint Mode - 4 Steps)
88
- - `spec` (`/spec`, `/feature`, `/fix`, `$spec`) - Define, spec, plan, and create `spec.md`
88
+ - `spec` (`/spec`, `/feature`, `/fix`, `$spec`) - Define, spec, plan, and create `current-feature.md`
89
89
  - `implement` (`/implement`, `$implement`) - Execute planned checklist tasks with TDD
90
90
  - `check` (`/check`, `$check`) - Senior QA review, multi-lane verification, record evidence
91
91
  - `complete` (`/complete`, `$complete`) - Safety pass, release digest, git merge, close run
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: feature
3
- description: "[Devflow] Fast-Track Feature stage in DevFlow (Blueprint Mode) - define, spec, plan, and create the living spec.md contract for new features."
3
+ description: "[Devflow] Fast-Track Feature stage in DevFlow (Blueprint Mode) - define, spec, plan, and create the living current-feature.md contract in context for new features."
4
4
  argument-hint: "{feature title, IDEA-xxx, or feature description}"
5
5
  ---
6
6
 
@@ -8,7 +8,7 @@ argument-hint: "{feature title, IDEA-xxx, or feature description}"
8
8
 
9
9
  $ARGUMENTS
10
10
 
11
- Fast-Track entry point combining Discovery, Definition, Specification, and Implementation Planning into one streamlined, review-gated step for **new features or enhancements**. Creates and maintains the **Single Living Spec (`spec.md`)** for the feature run. Supports intake from Idea Inbox (`IDEA-xxx`).
11
+ Fast-Track entry point combining Discovery, Definition, Specification, and Implementation Planning into one streamlined, review-gated step for **new features or enhancements**. Creates and maintains the **Single Living Spec (`devflow/context/current-feature.md`)** for the feature run. Supports intake from Idea Inbox (`IDEA-xxx`).
12
12
 
13
13
  ## Invocations & Aliases
14
14
 
@@ -26,25 +26,31 @@ Fast-Track entry point combining Discovery, Definition, Specification, and Imple
26
26
 
27
27
  When invoked:
28
28
 
29
- ### 1. Work Identity & Idea Intake
30
- 1. Inspect `devflow/context/current-stage.md` and `devflow/runs/`.
31
- 2. **Idea Inbox Intake**: If the argument is an idea identifier (e.g. `IDEA-001`):
29
+ ### 1. Single Active Run Guardrail (One Thing at a Time)
30
+ 1. Inspect `devflow/context/current-stage.md` and `devflow/context/current-feature.md`.
31
+ 2. If `Active Running ID` is not `None` and `Current Stage` is not `Idle`, or if `current-feature.md` contains an active uncompleted spec:
32
+ - **HALT and reject opening a new feature**.
33
+ - Explain to the user that an active run is currently in progress:
34
+ > ⚠️ *"มีงาน `{active_id}` กำลังดำเนินการอยู่ กรุณาปิดงานเดิมด้วย `/complete` หรือ `70-release` (หรือสั่ง `/rollback`) ก่อนเริ่มงานใหม่"*
35
+
36
+ ### 2. Work Identity & Idea Intake
37
+ 1. **Idea Inbox Intake**: If the argument is an idea identifier (e.g. `IDEA-001`):
32
38
  - Read `devflow/ideas.md` and extract the idea's title, raw problem statement, AI Feasibility notes, and Quick Seed points.
33
39
  - Use these details as the primary input for Specification & Scope.
34
- - In `devflow/ideas.md`, update the item's status to `[x] Claimed ({RUNNING_ID})` and move it under `## 📦 Archived / Shipped Ideas`.
35
- 3. Determine or allocate the sequential Running ID (e.g. `RUN-018-{slug}`).
36
- 4. Identify Git branch naming:
37
- - `feature/{slug}-{RUNNING_ID}`
38
- 5. Create directory `devflow/runs/{RUNNING_ID}/`.
40
+ - In `devflow/ideas.md`, update the item's status to `[x] Claimed ({ID})` and move it under `## 📦 Archived / Shipped Ideas`.
41
+ 2. Inspect `devflow/history/HISTORY.md` and determine the next sequential ID without prefix (e.g. `022-{slug}`).
42
+ 3. Identify Git branch naming:
43
+ - `feature/{xxx-slug}`
39
44
 
40
- ### 2. Generate the Single Living Spec (`spec.md`)
41
- Write `devflow/runs/{RUNNING_ID}/spec.md` using the structured template below in **Thai (`th`)**:
45
+ ### 3. Generate the Living Spec (`devflow/context/current-feature.md`)
46
+ Write `devflow/context/current-feature.md` using the structured template below in **Thai (`th`)**:
42
47
 
43
48
  ```markdown
44
- # 📐 [{RUNNING_ID}] {Feature Title} (Living Spec)
49
+ # 📐 [{ID}] {Feature Title} (Living Spec)
45
50
 
46
51
  > **Status**: In-Progress
47
52
  > **Track**: Fast-Track (Blueprint Mode - Feature)
53
+ > **Category**: Feature
48
54
  > **Branch**: `{branch_name}`
49
55
  > **Created Date**: {YYYY-MM-DD}
50
56
  > **Owner**: {Contributor or Team}
@@ -87,17 +93,16 @@ Write `devflow/runs/{RUNNING_ID}/spec.md` using the structured template below in
87
93
  - *(จะถูกบันทึกเมื่อรัน /complete)*
88
94
  ```
89
95
 
90
- ### 3. Update Workspace Status
96
+ ### 4. Update Workspace Status
91
97
  Update `devflow/context/current-stage.md`:
92
- - `Active Running ID`: `{RUNNING_ID}`
98
+ - `Active Discovery ID`: `None`
99
+ - `Active Running ID`: `{ID}`
93
100
  - `Current Stage`: `feature (Fast-Track -> Ready for /implement)`
94
- - `Living Spec`: `devflow/runs/{RUNNING_ID}/spec.md`
101
+ - `Living Spec`: `devflow/context/current-feature.md`
95
102
  - `Last Updated`: `{YYYY-MM-DD}`
96
103
 
97
- ### 4. Output Summary & Next Step
104
+ ### 5. Output Summary & Next Step
98
105
  Report to the user:
99
106
  - Running ID and allocated branch
100
107
  - Summary of Scope and Acceptance Criteria
101
- - Living Spec path: `devflow/runs/{RUNNING_ID}/spec.md`
102
- - If promoted from `IDEA-xxx`, confirm status update in `devflow/ideas.md`
103
- - **Next Command**: `/implement` (or `/implement {RUNNING_ID}`)
108
+ - Explicit next step: `/implement`
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: fix
3
- description: "[Devflow] Fast-Track Fix stage in DevFlow (Blueprint Mode) - define, spec, plan, and create the living spec.md contract for bug fixes."
3
+ description: "[Devflow] Fast-Track Fix stage in DevFlow (Blueprint Mode) - define, spec, plan, and create the living current-feature.md contract in context for bug fixes."
4
4
  argument-hint: "{bug description, issue ID, or IDEA-xxx}"
5
5
  ---
6
6
 
@@ -8,7 +8,7 @@ argument-hint: "{bug description, issue ID, or IDEA-xxx}"
8
8
 
9
9
  $ARGUMENTS
10
10
 
11
- Fast-Track entry point combining Bug Triage, Root Cause Isolation, Specification, and Implementation Planning into one streamlined, review-gated step for **bug fixes and hotfixes**. Creates and maintains the **Single Living Spec (`spec.md`)** for the fix run.
11
+ Fast-Track entry point combining Bug Triage, Root Cause Isolation, Specification, and Implementation Planning into one streamlined, review-gated step for **bug fixes and hotfixes**. Creates and maintains the **Single Living Spec (`devflow/context/current-feature.md`)** for the fix run.
12
12
 
13
13
  ## Invocations & Aliases
14
14
 
@@ -26,24 +26,30 @@ Fast-Track entry point combining Bug Triage, Root Cause Isolation, Specification
26
26
 
27
27
  When invoked:
28
28
 
29
- ### 1. Work Identity & Issue Intake
30
- 1. Inspect `devflow/context/current-stage.md` and `devflow/runs/`.
31
- 2. **Idea / Issue Inbox Intake**: If the argument is an identifier (e.g. `IDEA-001`):
29
+ ### 1. Single Active Run Guardrail (One Thing at a Time)
30
+ 1. Inspect `devflow/context/current-stage.md` and `devflow/context/current-feature.md`.
31
+ 2. If `Active Running ID` is not `None` and `Current Stage` is not `Idle`, or if `current-feature.md` contains an active uncompleted spec:
32
+ - **HALT and reject opening a new fix**.
33
+ - Explain to the user that an active run is currently in progress:
34
+ > ⚠️ *"มีงาน `{active_id}` กำลังดำเนินการอยู่ กรุณาปิดงานเดิมด้วย `/complete` หรือ `70-release` (หรือสั่ง `/rollback`) ก่อนเริ่มงานใหม่"*
35
+
36
+ ### 2. Work Identity & Issue Intake
37
+ 1. **Idea / Issue Inbox Intake**: If the argument is an identifier (e.g. `IDEA-001`):
32
38
  - Read `devflow/ideas.md` or issue notes and extract problem statement and root cause hints.
33
- - In `devflow/ideas.md`, update status to `[x] Claimed ({RUNNING_ID})` and move under `## 📦 Archived / Shipped Ideas`.
34
- 3. Determine or allocate the sequential Running ID (e.g. `RUN-018-{slug}`).
35
- 4. Identify Git branch naming:
36
- - `fix/{slug}-{RUNNING_ID}`
37
- 5. Create directory `devflow/runs/{RUNNING_ID}/`.
39
+ - In `devflow/ideas.md`, update status to `[x] Claimed ({ID})` and move under `## 📦 Archived / Shipped Ideas`.
40
+ 2. Inspect `devflow/history/HISTORY.md` and determine the next sequential ID without prefix (e.g. `022-{slug}`).
41
+ 3. Identify Git branch naming:
42
+ - `fix/{xxx-slug}`
38
43
 
39
- ### 2. Generate the Single Living Spec (`spec.md`)
40
- Write `devflow/runs/{RUNNING_ID}/spec.md` using the structured template below in **Thai (`th`)**:
44
+ ### 3. Generate the Living Spec (`devflow/context/current-feature.md`)
45
+ Write `devflow/context/current-feature.md` using the structured template below in **Thai (`th`)**:
41
46
 
42
47
  ```markdown
43
- # 📐 [{RUNNING_ID}] {Bug/Fix Title} (Living Spec)
48
+ # 📐 [{ID}] {Bug/Fix Title} (Living Spec)
44
49
 
45
50
  > **Status**: In-Progress
46
51
  > **Track**: Fast-Track (Blueprint Mode - Fix)
52
+ > **Category**: Fix
47
53
  > **Branch**: `{branch_name}`
48
54
  > **Created Date**: {YYYY-MM-DD}
49
55
  > **Owner**: {Contributor or Team}
@@ -87,16 +93,16 @@ Write `devflow/runs/{RUNNING_ID}/spec.md` using the structured template below in
87
93
  - *(จะถูกบันทึกเมื่อรัน /complete)*
88
94
  ```
89
95
 
90
- ### 3. Update Workspace Status
96
+ ### 4. Update Workspace Status
91
97
  Update `devflow/context/current-stage.md`:
92
- - `Active Running ID`: `{RUNNING_ID}`
98
+ - `Active Discovery ID`: `None`
99
+ - `Active Running ID`: `{ID}`
93
100
  - `Current Stage`: `fix (Fast-Track -> Ready for /implement)`
94
- - `Living Spec`: `devflow/runs/{RUNNING_ID}/spec.md`
101
+ - `Living Spec`: `devflow/context/current-feature.md`
95
102
  - `Last Updated`: `{YYYY-MM-DD}`
96
103
 
97
- ### 4. Output Summary & Next Step
104
+ ### 5. Output Summary & Next Step
98
105
  Report to the user:
99
106
  - Running ID and allocated branch
100
107
  - Summary of Scope, Reproduction, and Acceptance Criteria
101
- - Living Spec path: `devflow/runs/{RUNNING_ID}/spec.md`
102
- - **Next Command**: `/implement` (or `/implement {RUNNING_ID}`)
108
+ - Explicit next step: `/implement`
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: implement
3
- description: "[Devflow] Fast-Track Implement stage in DevFlow (Blueprint Mode) - execute checklist tasks incrementally with TDD and update spec.md."
3
+ description: "[Devflow] Fast-Track Implement stage in DevFlow (Blueprint Mode) - execute checklist tasks incrementally with TDD and update current-feature.md in context."
4
4
  argument-hint: "{running-id or workspace path}"
5
5
  ---
6
6
 
@@ -8,18 +8,18 @@ argument-hint: "{running-id or workspace path}"
8
8
 
9
9
  $ARGUMENTS
10
10
 
11
- Incremental code execution stage in Fast-Track. Reads the Single Living Spec (`spec.md`), executes checklist tasks, implements tests (TDD), and updates the implementation record.
11
+ Incremental code execution stage in Fast-Track. Reads the Single Living Spec (`devflow/context/current-feature.md`), executes checklist tasks, implements tests (TDD), and updates the implementation record.
12
12
 
13
13
  ## Invocations & Aliases
14
14
 
15
15
  - `/implement`: Run implementation on current active run
16
- - `/implement {running-id}`: Run implementation on specified running ID
16
+ - `/implement {id}`: Run implementation on specified ID
17
17
  - `$implement`: Codex CLI invocation
18
18
 
19
19
  ## Fast-Track Mainline Workflow
20
20
 
21
21
  ```text
22
- /spec ──▶ /implement ──▶ /check ──▶ /complete
22
+ /feature (หรือ /fix) ──▶ /implement ──▶ /check ──▶ /complete
23
23
  ```
24
24
 
25
25
  ## Behavior & Contract
@@ -27,8 +27,8 @@ Incremental code execution stage in Fast-Track. Reads the Single Living Spec (`s
27
27
  When invoked:
28
28
 
29
29
  ### 1. Load Active Context
30
- 1. Identify active Running ID from `devflow/context/current-stage.md` or argument.
31
- 2. Read `devflow/runs/{RUNNING_ID}/spec.md`.
30
+ 1. Identify active Running ID from `devflow/context/current-stage.md` or `devflow/context/current-feature.md`.
31
+ 2. Read `devflow/context/current-feature.md`.
32
32
  3. Locate `## 2. Plan & Test Strategy` and `## 3. Implementation Checklist`.
33
33
 
34
34
  ### 2. Incremental Execution with TDD
@@ -37,10 +37,10 @@ When invoked:
37
37
  - **TDD (Red-Green-Refactor)**: When `Test Decision: Required`, create or update unit tests first.
38
38
  - Implement the minimal, clean code change satisfying the task.
39
39
  - Run localized verification (e.g. `npm test`, linter).
40
- - Mark the item as `- [x]` in `spec.md`.
40
+ - Mark the item as `- [x]` in `current-feature.md`.
41
41
 
42
- ### 3. Update Living Spec (`spec.md`)
43
- Append or update `## 4. Implementation Record` in `spec.md` with:
42
+ ### 3. Update Living Spec (`current-feature.md`)
43
+ Append or update `## 4. Implementation Record` in `devflow/context/current-feature.md` with:
44
44
  - Summary of completed tasks and modified files
45
45
  - Key architectural observations or notes
46
46
  - Status of checklist items
@@ -61,4 +61,4 @@ Update `devflow/context/current-stage.md`:
61
61
  Report to the user:
62
62
  - Completed checklist items and modified files
63
63
  - Local verification results
64
- - **Next Command**: `/check` (or `/check {RUNNING_ID}`)
64
+ - **Next Command**: `/check` (or `/check {ID}`)
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: insight
3
- description: "[Devflow] Extract reusable lessons, architectural patterns, post-mortem incident learning, and token optimizations from completed work."
3
+ description: "[Devflow] Extract reusable lessons, patterns, file insights, and post-mortem learning from completed work."
4
4
  ---
5
5
 
6
6
  # Insight Extraction & Post-Mortem Learning
@@ -13,7 +13,7 @@ codebase + devflow/history/HISTORY.md -> [overview] -> devflow/context/proje
13
13
  synthesize)
14
14
  ```
15
15
 
16
- `overview` is the context synchronization and synthesis engine for Nexus-DevFlow. It inspects the actual codebase (manifest, dependencies, directory layout, models/schemas, entry points) along with the completed delivery history (`devflow/history/HISTORY.md` and `devflow/runs/`) to build or refresh `devflow/context/project-overview.md`.
16
+ `overview` is the context synchronization and synthesis engine for Nexus-DevFlow. It inspects the actual codebase (manifest, dependencies, directory layout, models/schemas, entry points) along with the completed delivery history (`devflow/history/HISTORY.md` and `devflow/history/`) to build or refresh `devflow/context/project-overview.md`.
17
17
 
18
18
  It ensures that `project-overview.md` remains a **Living Source of Truth** that evolves alongside your software, rather than a stale artifact left behind after onboarding.
19
19
 
@@ -26,7 +26,7 @@ overview
26
26
  ```
27
27
 
28
28
  Use this when:
29
- - Multiple delivery runs (`RUN-xxx`) have shipped and `project-overview.md` needs to reflect newly added capabilities.
29
+ - Multiple delivery runs (`xxx-slug`) have shipped and `project-overview.md` needs to reflect newly added capabilities.
30
30
  - New database schemas, ORM models, or API boundaries were introduced.
31
31
  - Major dependencies or architectural patterns were added or modified.
32
32
  - After completing `70-release` to keep project context perfectly aligned.
@@ -59,7 +59,7 @@ Inspect the actual codebase to establish hard facts:
59
59
  Inspect DevFlow history records:
60
60
 
61
61
  1. Read `devflow/history/HISTORY.md` for completed and released milestones.
62
- 2. Scan completed delivery runs in `devflow/runs/` to extract shipped user-visible capabilities and core system features.
62
+ 2. Scan completed delivery runs in `devflow/history/features/`, `devflow/history/fixes/`, and `devflow/history/rollbacks/` to extract shipped user-visible capabilities and core system features.
63
63
 
64
64
  ---
65
65
 
@@ -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 spec.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
 
@@ -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 either a Fast-Track `spec.md` or a Deep-Track `60-report.md`.
11
+ Standalone companion command to generate an interactive, self-contained HTML report dashboard on demand from either a Fast-Track `current-feature.md` or a Deep-Track `60-report.md`.
12
12
 
13
13
  > [!NOTE]
14
14
  > HTML reports are **never automatically generated** during normal mainline stages (`/complete` or `60-report`). Use this command whenever you or stakeholders wish to view or share an interactive web report.
@@ -27,7 +27,7 @@ When invoked:
27
27
  ### 1. Identify Target Run
28
28
  1. Locate target run directory in `devflow/runs/{running-id}` from argument or `devflow/context/current-stage.md`.
29
29
  2. Check for either:
30
- - Fast-Track Living Spec: `devflow/runs/{RUNNING_ID}/spec.md` (or `blueprint.md`)
30
+ - Fast-Track Living Spec: `devflow/runs/{RUNNING_ID}/current-feature.md` (or `spec.md` / `blueprint.md`)
31
31
  - Deep-Track Report Digest: `devflow/runs/{RUNNING_ID}/60-report.md`
32
32
 
33
33
  ### 2. Render Interactive HTML Dashboard
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: security-review
3
- description: "[Devflow] Security review, vulnerability scanner, and code hardening. Audits for OWASP vulnerabilities, secrets, injections, and auth flaws."
3
+ description: "[Devflow] High-severity security code review and vulnerability audit for folders, projects, files, or diffs."
4
4
  ---
5
5
 
6
6
  # Security Review, Hardening & Vulnerability Audit
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: spec
3
- description: "[Devflow] Fast-Track Spec router in DevFlow (Blueprint Mode) - aliases and routes to /feature or /fix to create the single living spec.md contract."
3
+ description: "[Devflow] Fast-Track Spec router in DevFlow (Blueprint Mode) - aliases and routes to /feature or /fix to create the living current-feature.md contract in context."
4
4
  argument-hint: "{feature title, bug description, IDEA-xxx, or running-id}"
5
5
  ---
6
6
 
@@ -8,7 +8,7 @@ argument-hint: "{feature title, bug description, IDEA-xxx, or running-id}"
8
8
 
9
9
  $ARGUMENTS
10
10
 
11
- Unified Fast-Track entry point that routes to `/feature` or `/fix` to create and maintain the **Single Living Spec (`spec.md`)**.
11
+ Unified Fast-Track entry point that routes to `/feature` or `/fix` to create and maintain the **Single Living Spec (`devflow/context/current-feature.md`)**.
12
12
 
13
13
  > [!TIP]
14
14
  > **Preferred Commands**:
@@ -32,7 +32,8 @@ Unified Fast-Track entry point that routes to `/feature` or `/fix` to create and
32
32
 
33
33
  When invoked:
34
34
 
35
- 1. If the input describes a bug or hotfix, routes to `/fix` behavior.
36
- 2. Otherwise, routes to `/feature` behavior.
37
- 3. Allocates sequential Running ID (`RUN-xxx`), creates directory `devflow/runs/{RUNNING_ID}/`, and generates `spec.md` in **Thai (`th`)**.
38
- 4. Updates `devflow/context/current-stage.md` and reports next step: `/implement`.
35
+ 1. Checks Single Active Run Guardrail: rejects if an uncompleted active run already exists in `devflow/context/current-stage.md` or `devflow/context/current-feature.md`.
36
+ 2. If the input describes a bug or hotfix, routes to `/fix` behavior.
37
+ 3. Otherwise, routes to `/feature` behavior.
38
+ 4. Allocates sequential ID without prefix (`xxx-slug`), generates `devflow/context/current-feature.md` in **Thai (`th`)**.
39
+ 5. Updates `devflow/context/current-stage.md` and reports next step: `/implement`.
@@ -83,8 +83,8 @@ Don't silently fill in ambiguous requirements. The spec's entire purpose is to s
83
83
 
84
84
  Every specification must stand on its own in markdown under `devflow/runs/{ID}-*/`:
85
85
 
86
- 1. **`define.md`**: Decision and scope framing when the problem still needs clarification.
87
- 2. **`spec.md`**: The delivery contract following the template below.
86
+ 1. **`current-feature.md`**: Fast-Track Single Living Spec delivery contract.
87
+ 2. **`20-spec.md`**: Deep-Track formal specification delivery contract.
88
88
 
89
89
  **Spec template:**
90
90
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: test
3
- description: "[Devflow] Test-driven development, test generation, test execution, 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,5 +1,5 @@
1
- ---name: 00-discover
2
-
1
+ ---
2
+ name: 00-discover
3
3
  description: "[Devflow] Discover stage in DevFlow 2.0 - explore a request, route supporting inquiry, and decide whether delivery work should begin without allocating a running ID."
4
4
  argument-hint: "{title, request, or discovery-id}"
5
5
  ---