@jakkrichm/create-nexus-devflow 2.0.14 → 2.0.15

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 (68) hide show
  1. package/README.md +4 -4
  2. package/dist/lib/update.js +1 -1
  3. package/dist/lib/update.js.map +1 -1
  4. package/package.json +1 -1
  5. package/template/.agents/skills/30-plan/SKILL.md +6 -6
  6. package/template/.agents/skills/{40-implement → 40-execute}/SKILL.md +21 -26
  7. package/template/.agents/skills/50-verify/SKILL.md +10 -10
  8. package/template/.agents/skills/60-report/SKILL.md +1 -1
  9. package/template/.agents/skills/70-release/SKILL.md +6 -6
  10. package/template/.agents/skills/agent/SKILL.md +3 -3
  11. package/template/.agents/skills/autopilot/SKILL.md +6 -6
  12. package/template/.agents/skills/brainstorm/SKILL.md +1 -1
  13. package/template/.agents/skills/brief/SKILL.md +1 -1
  14. package/template/.agents/skills/codebase-design/SKILL.md +2 -2
  15. package/template/.agents/skills/commit/SKILL.md +1 -1
  16. package/template/.agents/skills/debug/SKILL.md +2 -2
  17. package/template/.agents/skills/devflow/SKILL.md +5 -5
  18. package/template/.agents/skills/doctor/SKILL.md +1 -1
  19. package/template/.agents/skills/feature/SKILL.md +103 -0
  20. package/template/.agents/skills/fix/SKILL.md +102 -0
  21. package/template/.agents/skills/followup/SKILL.md +5 -5
  22. package/template/.agents/skills/help/SKILL.md +4 -4
  23. package/template/.agents/skills/insight/SKILL.md +1 -1
  24. package/template/.agents/skills/pr/SKILL.md +1 -1
  25. package/template/.agents/skills/preview/SKILL.md +1 -1
  26. package/template/.agents/skills/review/SKILL.md +1 -1
  27. package/template/.agents/skills/rollback/SKILL.md +3 -3
  28. package/template/.agents/skills/security-review/SKILL.md +2 -2
  29. package/template/.agents/skills/simplify/SKILL.md +1 -1
  30. package/template/.agents/skills/spec/SKILL.md +17 -84
  31. package/template/.agents/skills/test/SKILL.md +2 -2
  32. package/template/.agents/skills/try/SKILL.md +2 -2
  33. package/template/.claude/skills/30-plan/SKILL.md +6 -6
  34. package/template/.claude/skills/{40-implement → 40-execute}/SKILL.md +21 -26
  35. package/template/.claude/skills/50-verify/SKILL.md +10 -10
  36. package/template/.claude/skills/60-report/SKILL.md +1 -1
  37. package/template/.claude/skills/70-release/SKILL.md +6 -6
  38. package/template/.claude/skills/agent/SKILL.md +3 -3
  39. package/template/.claude/skills/autopilot/SKILL.md +6 -6
  40. package/template/.claude/skills/brainstorm/SKILL.md +1 -1
  41. package/template/.claude/skills/brief/SKILL.md +1 -1
  42. package/template/.claude/skills/codebase-design/SKILL.md +2 -2
  43. package/template/.claude/skills/commit/SKILL.md +1 -1
  44. package/template/.claude/skills/debug/SKILL.md +2 -2
  45. package/template/.claude/skills/devflow/SKILL.md +5 -5
  46. package/template/.claude/skills/doctor/SKILL.md +1 -1
  47. package/template/.claude/skills/feature/SKILL.md +103 -0
  48. package/template/.claude/skills/fix/SKILL.md +102 -0
  49. package/template/.claude/skills/followup/SKILL.md +5 -5
  50. package/template/.claude/skills/help/SKILL.md +4 -4
  51. package/template/.claude/skills/insight/SKILL.md +1 -1
  52. package/template/.claude/skills/pr/SKILL.md +1 -1
  53. package/template/.claude/skills/preview/SKILL.md +1 -1
  54. package/template/.claude/skills/review/SKILL.md +1 -1
  55. package/template/.claude/skills/rollback/SKILL.md +3 -3
  56. package/template/.claude/skills/security-review/SKILL.md +2 -2
  57. package/template/.claude/skills/simplify/SKILL.md +1 -1
  58. package/template/.claude/skills/spec/SKILL.md +17 -84
  59. package/template/.claude/skills/test/SKILL.md +2 -2
  60. package/template/.claude/skills/try/SKILL.md +2 -2
  61. package/template/AGENTS.md +11 -10
  62. package/template/devflow/context/ai-interaction.md +2 -2
  63. package/template/devflow/context/coding-standards.md +1 -1
  64. package/template/devflow/context/current-stage.md +3 -2
  65. package/template/devflow/context/project-overview.md +10 -6
  66. package/template/devflow/history/HISTORY.md +2 -0
  67. package/template/devflow/ideas.md +1 -1
  68. package/template/devflow/reference/running-id-contract.md +2 -2
@@ -0,0 +1,102 @@
1
+ ---
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."
4
+ argument-hint: "{bug description, issue ID, or IDEA-xxx}"
5
+ ---
6
+
7
+ # Fast-Track: Fix (Blueprint Mode)
8
+
9
+ $ARGUMENTS
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.
12
+
13
+ ## Invocations & Aliases
14
+
15
+ - `/fix <bug-description>` or `fix <bug-description>`: Fast-Track ad-hoc bugfix workflow
16
+ - `/fix IDEA-xxx`: Intake and fix a reported issue or idea from `devflow/ideas.md`
17
+ - `$fix`: Codex CLI invocation
18
+
19
+ ## Fast-Track Mainline Workflow
20
+
21
+ ```text
22
+ /feature (หรือ /fix) ──▶ /implement ──▶ /check ──▶ /complete
23
+ ```
24
+
25
+ ## Behavior & Contract
26
+
27
+ When invoked:
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`):
32
+ - 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}/`.
38
+
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`)**:
41
+
42
+ ```markdown
43
+ # 📐 [{RUNNING_ID}] {Bug/Fix Title} (Living Spec)
44
+
45
+ > **Status**: In-Progress
46
+ > **Track**: Fast-Track (Blueprint Mode - Fix)
47
+ > **Branch**: `{branch_name}`
48
+ > **Created Date**: {YYYY-MM-DD}
49
+ > **Owner**: {Contributor or Team}
50
+
51
+ ---
52
+
53
+ ## 1. Specification & Scope
54
+ - **Problem Statement & Reproduction**: {อาการบั๊กที่พบ ขั้นตอนที่ทำให้เกิดปัญหา หรือ Error Log}
55
+ - **Root Cause Analysis**: {สาเหตุที่แท้จริงของบั๊ก}
56
+ - **In-Scope**:
57
+ - {ขอบเขตการแก้ไขบั๊กและการป้องกัน regression}
58
+ - **Out-of-Scope**:
59
+ - {สิ่งที่ไม่แตะต้องหรืออยู่นอกเหนือการแก้จุดนี้}
60
+ - **Acceptance Criteria**:
61
+ - [ ] AC-1: {เงื่อนไขการแก้ปัญหาสำเร็จและพฤติกรรมที่ถูกต้อง}
62
+ - [ ] AC-2: {มี Regression Test ป้องกันไม่ให้เกิดซ้ำ}
63
+
64
+ ## 2. Plan & Test Strategy
65
+ - **Files to Modify / Create**:
66
+ - `{path/to/file1}`: {หน้าที่ที่ต้องแก้ไข}
67
+ - `{path/to/test_file}`: {เทสต์เคสจำลองและป้องกันบั๊ก}
68
+ - **Test Decision**: `Required (TDD / Regression Test)`
69
+ - *Rationale*: {การแก้บั๊กต้องมี Regression Test ยืนยันเสมอ}
70
+ - *Planned Cases*: {เคสทดสอบจำลองบั๊ก (Red) และทดสอบหลังแก้ (Green)}
71
+ - **Impact & Rollback Strategy**:
72
+ - *Impact*: {ผลกระทบต่อโมดูลข้างเคียง}
73
+ - *Rollback*: {วิธีย้อนคืนการทำงานกรณีเกิดปัญหา}
74
+
75
+ ## 3. Implementation Checklist
76
+ - [ ] Task 1.1: {เขียน Regression Test เพื่อ reproduce บั๊ก}
77
+ - [ ] Task 1.2: {แก้ไขโค้ดที่จุดเกิดเหตุ}
78
+ - [ ] Task 1.3: {รันชุดทดสอบเพื่อยืนยันว่าบั๊กหายและไม่กระทบจุดอื่น}
79
+
80
+ ## 4. Implementation Record
81
+ - *(จะถูกบันทึกเมื่อรัน /implement)*
82
+
83
+ ## 5. Verification Evidence
84
+ - *(จะถูกบันทึกเมื่อรัน /check)*
85
+
86
+ ## 6. Release & Handoff
87
+ - *(จะถูกบันทึกเมื่อรัน /complete)*
88
+ ```
89
+
90
+ ### 3. Update Workspace Status
91
+ Update `devflow/context/current-stage.md`:
92
+ - `Active Running ID`: `{RUNNING_ID}`
93
+ - `Current Stage`: `fix (Fast-Track -> Ready for /implement)`
94
+ - `Living Spec`: `devflow/runs/{RUNNING_ID}/spec.md`
95
+ - `Last Updated`: `{YYYY-MM-DD}`
96
+
97
+ ### 4. Output Summary & Next Step
98
+ Report to the user:
99
+ - Running ID and allocated branch
100
+ - 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}`)
@@ -36,7 +36,7 @@ Read:
36
36
  - `devflow/runs/{ID}-*10-define.md`
37
37
  - `devflow/runs/{ID}-*20-spec.md`
38
38
  - `devflow/runs/{ID}-*30-plan.md`
39
- - `devflow/runs/{ID}-*40-implement.md`
39
+ - `devflow/runs/{ID}-*40-execute.md`
40
40
  - `devflow/runs/{ID}-*50-verify.md` if present
41
41
 
42
42
  ### 2. Classify The Follow-Up
@@ -57,7 +57,7 @@ Append the follow-up scope directly to the relevant stage markdown files for the
57
57
 
58
58
  ### 4. Ask For Confirmation
59
59
 
60
- After adding or proposing follow-up subtasks, ask the user to confirm before `40-implement`.
60
+ After adding or proposing follow-up subtasks, ask the user to confirm before `40-execute`.
61
61
 
62
62
  ## Output
63
63
 
@@ -66,18 +66,18 @@ Return:
66
66
  - follow-up category
67
67
  - new phase/subtask plan
68
68
  - validation result
69
- - next command: `40-implement {ID}`
69
+ - next command: `40-execute {ID}`
70
70
 
71
71
  ## Relationship To DevFlow 2.0
72
72
 
73
73
  - Classification: Companion command
74
74
  - Mainline status: Not a numbered stage
75
75
  - Typical entry points: after review, triage, or release follow-up work is identified
76
- - Typical handoff targets: `10-define`, `20-spec`, `30-plan`, `40-implement`
76
+ - Typical handoff targets: `10-define`, `20-spec`, `30-plan`, `40-execute`
77
77
 
78
78
  ## Sources
79
79
 
80
80
  - `AGENTS.md`
81
- - Related commands: `PR-Followup`, `Issue-Triage`, `Human-Feedback`, `10-define`, `20-spec`, `40-implement`
81
+ - Related commands: `PR-Followup`, `Issue-Triage`, `Human-Feedback`, `10-define`, `20-spec`, `40-execute`
82
82
 
83
83
 
@@ -77,14 +77,14 @@ Help Summary:
77
77
  Environment: All OK
78
78
 
79
79
  Active Runs:
80
- - 010-auth-refactor: stage=40-implement | approval=Pending | next=50-verify 010 | warnings: manual review open
80
+ - 010-auth-refactor: stage=40-execute | approval=Pending | next=50-verify 010 | warnings: manual review open
81
81
  - 011-billing-phase-1: stage=20-spec | approval=Approved | next=30-plan 011
82
82
  - 012-admin-console: stage=50-verify | approval=Approved | next=60-report 012 | warnings: not ready for release
83
83
 
84
84
  Recommended Next Action:
85
85
  - 010 -> 50-verify 010
86
86
  - 011 -> 20-spec 011
87
- - 012 -> 40-implement 012
87
+ - 012 -> 40-execute 012
88
88
  ```
89
89
 
90
90
  ### Phase C: Manual Review Soft Gate
@@ -114,7 +114,7 @@ Manual Review Warning:
114
114
  ## DevFlow 2.0 Mainline
115
115
 
116
116
  ```text
117
- 00-discover -> 10-define -> 20-spec -> 30-plan -> 40-implement -> 50-verify -> 60-report -> 70-release
117
+ 00-discover -> 10-define -> 20-spec -> 30-plan -> 40-execute -> 50-verify -> 60-report -> 70-release
118
118
  ```
119
119
 
120
120
  ## Public Companion Commands
@@ -182,7 +182,7 @@ Recommend `30-plan`.
182
182
 
183
183
  ### 5. If planning is done and work should begin
184
184
 
185
- Recommend `40-implement`.
185
+ Recommend `40-execute`.
186
186
 
187
187
  ### 6. If implementation exists and needs checking
188
188
 
@@ -27,7 +27,7 @@ What Broke ➔ Business Impact ➔ Root Cause ➔ Fix Evidence ➔ Prevention &
27
27
 
28
28
  ## 2. Process & Recording Destinations
29
29
 
30
- 1. **Load Evidence**: Review `git diff`, `40-implement.md`, `50-verify.md`, or test logs.
30
+ 1. **Load Evidence**: Review `git diff`, `40-execute.md`, `50-verify.md`, or test logs.
31
31
  2. **Distill Insights**: Formulate clear, actionable, non-generic takeaways.
32
32
  3. **Save to Persistent Memory**:
33
33
  - Save project-wide engineering lessons to `devflow/context/lessons.md` (or `knowledge/lessons.md`).
@@ -40,7 +40,7 @@ You are an orchestrator. Your goal is to call the specialized Git PR Maker agent
40
40
  - Prefer markdown-first stage artifacts as the source narrative:
41
41
  - `20-spec.md`
42
42
  - `30-plan.md`
43
- - `40-implement.md`
43
+ - `40-execute.md`
44
44
  - `50-verify.md`
45
45
  - `60-report.md` when the final summary already exists
46
46
  - `70-release.md` when release execution notes already exist
@@ -38,5 +38,5 @@ This is the preview master skill for Nexus-DevFlow. It manages local development
38
38
  ## Relationship To DevFlow 2.0
39
39
 
40
40
  - **Classification**: Companion command & Runtime support
41
- - **Mainline stages**: `40-implement` (interactive visual check), `50-verify` (smoke test check)
41
+ - **Mainline stages**: `40-execute` (interactive visual check), `50-verify` (smoke test check)
42
42
  - **Handoff**: `50-verify`
@@ -68,4 +68,4 @@ Categorize all findings into actionable severities:
68
68
 
69
69
  - **Classification**: Companion command & Verification support
70
70
  - **Mainline stages**: `50-verify` (QA & Code Review lane), `70-release` (Pre-merge review)
71
- - **Handoff**: `40-implement` (for fixes), `50-verify`, `70-release`
71
+ - **Handoff**: `40-execute` (for fixes), `50-verify`, `70-release`
@@ -8,7 +8,7 @@ description: "[Devflow] Plan safe feature or run reversal with dependency and co
8
8
  Where this sits in the workflow:
9
9
 
10
10
  ```text
11
- completed run + git history -> [rollback] -> 40-implement (or fix run) -> 50-verify -> 70-release
11
+ completed run + git history -> [rollback] -> 40-execute (or fix run) -> 50-verify -> 70-release
12
12
  (run archive + commits) (risk review (reverse product diff) (prove) (log & finalize)
13
13
  + plan)
14
14
  ```
@@ -51,7 +51,7 @@ Identify:
51
51
 
52
52
  - Exact commit SHA(s) introducing the feature.
53
53
  - Parent commit before the feature was introduced.
54
- - Associated stage artifacts (`20-spec.md`, `40-implement.md`, `70-release.md`).
54
+ - Associated stage artifacts (`20-spec.md`, `40-execute.md`, `70-release.md`).
55
55
 
56
56
  ## Step 2 - Separate Product Changes From DevFlow History
57
57
 
@@ -98,7 +98,7 @@ Draft the rollback plan containing:
98
98
  Present the rollback plan to the user:
99
99
 
100
100
  - Summarize affected files and dependency risks.
101
- - If approved, route to `40-implement` (or allocate a dedicated Fixrollback Run) to safely execute the reversal steps behind review gates.
101
+ - If approved, route to `40-execute` (or allocate a dedicated Fixrollback Run) to safely execute the reversal steps behind review gates.
102
102
 
103
103
  ## Rules
104
104
 
@@ -59,5 +59,5 @@ This is the comprehensive security master skill for Nexus-DevFlow. It combines s
59
59
  ## Relationship To DevFlow 2.0
60
60
 
61
61
  - **Classification**: Companion command & Safety gate
62
- - **Mainline integration**: Run during `40-implement` or `50-verify` before `70-release`.
63
- - **Handoff**: P0/P1 security findings block release and return to `40-implement` for immediate remediation.
62
+ - **Mainline integration**: Run during `40-execute` or `50-verify` before `70-release`.
63
+ - **Handoff**: P0/P1 security findings block release and return to `40-execute` for immediate remediation.
@@ -66,5 +66,5 @@ Delete commented-out code blocks, `// removed` notes, and unused variables (`_un
66
66
  ## Relationship To DevFlow 2.0
67
67
 
68
68
  - **Classification**: Companion command & Refactoring support
69
- - **Mainline integration**: Used during `40-implement` (Refactor step of TDD) or `50-verify`.
69
+ - **Mainline integration**: Used during `40-execute` (Refactor step of TDD) or `50-verify`.
70
70
  - **Handoff**: `50-verify` (proves zero regressions).
@@ -1,105 +1,38 @@
1
1
  ---
2
2
  name: spec
3
- description: "[Devflow] Fast-Track Spec stage in DevFlow (Blueprint Mode) - define, spec, plan, and 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 single living spec.md contract."
4
4
  argument-hint: "{feature title, bug description, IDEA-xxx, or running-id}"
5
5
  ---
6
6
 
7
- # Fast-Track: Spec (Blueprint Mode)
7
+ # Fast-Track: Spec Router (Blueprint Mode)
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. Creates and maintains the **Single Living Spec (`spec.md`)** for the run. Supports intake from Idea Inbox (`IDEA-xxx`).
11
+ Unified Fast-Track entry point that routes to `/feature` or `/fix` to create and maintain the **Single Living Spec (`spec.md`)**.
12
+
13
+ > [!TIP]
14
+ > **Preferred Commands**:
15
+ > - ใช้ **`/feature <title>`** สำหรับฟีเจอร์ใหม่หรืองานพัฒนาทั่วไป
16
+ > - ใช้ **`/fix <bug-description>`** สำหรับแก้บั๊กหรือ hotfix
12
17
 
13
18
  ## Invocations & Aliases
14
19
 
15
- - `/spec <title>` or `spec <title>`: Standard Fast-Track specification
16
- - `/spec IDEA-xxx`: Intake and promote a pending idea from `devflow/ideas.md`
17
- - `/feature <title>` or `feature <title>`: Fast-Track feature workflow
18
- - `/fix <bug-description>` or `fix <bug-description>`: Fast-Track ad-hoc bugfix workflow
19
- - `$spec`, `$feature`, `$fix`: Codex CLI invocation
20
+ - `/feature <title>`: Fast-Track feature workflow (แนะนำ)
21
+ - `/fix <bug-description>`: Fast-Track ad-hoc bugfix workflow (แนะนำ)
22
+ - `/spec <title>` or `/spec IDEA-xxx`: Generic Fast-Track specification
23
+ - `$feature`, `$fix`, `$spec`: Codex CLI invocation
20
24
 
21
25
  ## Fast-Track Mainline Workflow
22
26
 
23
27
  ```text
24
- /spec ──▶ /implement ──▶ /check ──▶ /complete
28
+ /feature (หรือ /fix) ──▶ /implement ──▶ /check ──▶ /complete
25
29
  ```
26
30
 
27
31
  ## Behavior & Contract
28
32
 
29
33
  When invoked:
30
34
 
31
- ### 1. Work Identity & Idea Intake
32
- 1. Inspect `devflow/context/current-stage.md` and `devflow/runs/`.
33
- 2. **Idea Inbox Intake**: If the argument is an idea identifier (e.g. `IDEA-001`):
34
- - Read `devflow/ideas.md` and extract the idea's title, raw problem statement, AI Feasibility notes, and Quick Seed points.
35
- - Use these details as the primary input for Specification & Scope.
36
- - In `devflow/ideas.md`, update the item's status to `[x] Claimed ({RUNNING_ID})` and move it under `## 📦 Archived / Shipped Ideas`.
37
- 3. Determine or allocate the sequential Running ID (e.g. `RUN-016-{slug}`).
38
- 4. Identify Git branch naming:
39
- - For features: `feature/{slug}-{RUNNING_ID}`
40
- - For bug fixes: `fix/{slug}-{RUNNING_ID}`
41
- 5. Create directory `devflow/runs/{RUNNING_ID}/`.
42
-
43
- ### 2. Generate the Single Living Spec (`spec.md`)
44
- Write `devflow/runs/{RUNNING_ID}/spec.md` using the structured template below in **Thai (`th`)**:
45
-
46
- ```markdown
47
- # 📐 [{RUNNING_ID}] {Title} (Living Spec)
48
-
49
- > **Status**: In-Progress
50
- > **Track**: Fast-Track (Blueprint Mode)
51
- > **Branch**: `{branch_name}`
52
- > **Created Date**: {YYYY-MM-DD}
53
- > **Owner**: {Contributor or Team}
54
-
55
- ---
56
-
57
- ## 1. Specification & Scope
58
- - **Problem Statement**: {ปัญหาหรือที่มาที่ต้องทำ}
59
- - **In-Scope**:
60
- - {ขอบเขตสิ่งที่ต้องทำ}
61
- - **Out-of-Scope**:
62
- - {สิ่งที่ไม่ทำในรอบนี้}
63
- - **Acceptance Criteria**:
64
- - [ ] AC-1: {เงื่อนไขการตรวจรับข้อที่ 1}
65
- - [ ] AC-2: {เงื่อนไขการตรวจรับข้อที่ 2}
66
-
67
- ## 2. Plan & Test Strategy
68
- - **Files to Modify / Create**:
69
- - `{path/to/file1}`: {หน้าที่ที่ต้องแก้ไข}
70
- - `{path/to/file2}`: {หน้าที่ที่ต้องแก้ไข}
71
- - **Test Decision**: `Required (TDD)` | `Manual/Command Only` | `Not Required`
72
- - *Rationale*: {เหตุผลความจำเป็นในการเขียนเทสต์}
73
- - *Planned Cases*: {กรณีทดสอบหลักตาม AAA Pattern}
74
- - **Impact & Rollback Strategy**:
75
- - *Impact*: {ผลกระทบต่อโมดูลอื่น}
76
- - *Rollback*: {วิธีย้อนคืนการทำงานกรณีเกิดปัญหา}
77
-
78
- ## 3. Implementation Checklist
79
- - [ ] Task 1.1: {งานย่อยข้อที่ 1}
80
- - [ ] Task 1.2: {งานย่อยข้อที่ 2}
81
- - [ ] Task 1.3: {งานย่อยข้อที่ 3}
82
-
83
- ## 4. Implementation Record
84
- - *(จะถูกบันทึกเมื่อรัน /implement)*
85
-
86
- ## 5. Verification Evidence
87
- - *(จะถูกบันทึกเมื่อรัน /check)*
88
-
89
- ## 6. Release & Handoff
90
- - *(จะถูกบันทึกเมื่อรัน /complete)*
91
- ```
92
-
93
- ### 3. Update Workspace Status
94
- Update `devflow/context/current-stage.md`:
95
- - `Active Running ID`: `{RUNNING_ID}`
96
- - `Current Stage`: `spec (Fast-Track -> Ready for /implement)`
97
- - `Last Updated`: `{YYYY-MM-DD}`
98
-
99
- ### 4. Output Summary & Next Step
100
- Report to the user:
101
- - Running ID and allocated branch
102
- - Summary of Scope and Acceptance Criteria
103
- - Living Spec path: `devflow/runs/{RUNNING_ID}/spec.md`
104
- - If promoted from `IDEA-xxx`, confirm status update in `devflow/ideas.md`
105
- - **Next Command**: `/implement` (or `/implement {RUNNING_ID}`)
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`.
@@ -81,7 +81,7 @@ For browser and UI features, unit tests alone are insufficient:
81
81
 
82
82
  ## 6. Test Generation & Persistent Execution Reports
83
83
 
84
- When generating or logging test runs during `40-implement` or `50-verify`:
84
+ When generating or logging test runs during `40-execute` or `50-verify`:
85
85
  - Save summary reports to `devflow/reports/{date}-test-report-{slug}.md`
86
86
  - Include: Target, Test Cases (Happy Path, Error, Edge Cases), Pass/Fail statistics, and gaps/risks.
87
87
 
@@ -90,5 +90,5 @@ When generating or logging test runs during `40-implement` or `50-verify`:
90
90
  ## Relationship To DevFlow 2.0
91
91
 
92
92
  - **Classification**: Companion command & Engineering standard
93
- - **Mainline stages**: `30-plan` (TDD decisions), `40-implement` (TDD execution), `50-verify` (QA gate)
93
+ - **Mainline stages**: `30-plan` (TDD decisions), `40-execute` (TDD execution), `50-verify` (QA gate)
94
94
  - **Handoff**: `50-verify`, `Debug`, `autopilot`
@@ -8,7 +8,7 @@ description: "[Devflow] Generate human manual QA review walkthrough guide (where
8
8
  Where this sits in the workflow:
9
9
 
10
10
  ```text
11
- 40-implement or 50-verify or 60-report -> [try] -> human review & verification
11
+ 40-execute or 50-verify or 60-report -> [try] -> human review & verification
12
12
  (work implemented / verified) (manual (where to go,
13
13
  steps) what to click)
14
14
  ```
@@ -36,7 +36,7 @@ Read:
36
36
  - `devflow/context/current-stage.md`
37
37
  - `devflow/context/project-overview.md`
38
38
  - `devflow/context/coding-standards.md`
39
- - Active run artifacts: `20-spec.md`, `30-plan.md`, `40-implement.md`, `50-verify.md` (or archived run artifacts)
39
+ - Active run artifacts: `20-spec.md`, `30-plan.md`, `40-execute.md`, `50-verify.md` (or archived run artifacts)
40
40
  - Current git branch and status
41
41
 
42
42
  Do not dump the full spec. Extract only the concrete routes, screens, CLI commands, API endpoints, test data, and expected outcomes that a human needs to verify the feature.
@@ -29,10 +29,10 @@ Unused adapter families can be removed. Codex and Antigravity projects keep `.ag
29
29
 
30
30
  ### Universal Invocation & Agent Directives:
31
31
 
32
- 1. **Canonical Command Names & AI Provider Invocation**: Each workflow stage and companion tool has exactly **one Canonical Name** (e.g. `spec`, `implement`, `check`, `complete`, `00-discover`, `10-define`, `20-spec`, `30-plan`, `40-implement`, `50-verify`, `60-report`, `70-release`, `report-html`, `devflow`, `onboard`, `adopt`, `doctor`, `try`, `rollback`, `ci`, `brief`, `autopilot`). The way you invoke commands depends on your AI Provider / Tool:
33
- - **Canonical Name (Plain text)**: Directly invoke or prompt the command by its standard name (e.g., `spec`, `devflow`).
34
- - **Slash Prefix (`/`)**: For tools supporting slash commands (Claude Code, Google Antigravity, Gemini CLI), e.g., `/spec`, `/feature`, `/fix`, `/devflow`.
35
- - **Dollar Prefix (`$`)**: For OpenAI Codex CLI or skill-invocation tools, e.g., `$spec`, `$devflow`.
32
+ 1. **Canonical Command Names & AI Provider Invocation**: Each workflow stage and companion tool has exactly **one Canonical Name** (e.g. `feature`, `fix`, `implement`, `check`, `complete`, `00-discover`, `10-define`, `20-spec`, `30-plan`, `40-execute`, `50-verify`, `60-report`, `70-release`, `report-html`, `devflow`, `onboard`, `adopt`, `doctor`, `try`, `rollback`, `ci`, `brief`, `autopilot`, `idea`, `spec`). The way you invoke commands depends on your AI Provider / Tool:
33
+ - **Canonical Name (Plain text)**: Directly invoke or prompt the command by its standard name (e.g., `feature`, `40-execute`, `devflow`).
34
+ - **Slash Prefix (`/`)**: For tools supporting slash commands (Claude Code, Google Antigravity, Gemini CLI), e.g., `/feature`, `/fix`, `/implement`, `/40-execute`, `/devflow`.
35
+ - **Dollar Prefix (`$`)**: For OpenAI Codex CLI or skill-invocation tools, e.g., `$feature`, `$fix`, `$40-execute`, `$devflow`.
36
36
  2. **OpenAI Codex & Non-Native CLI Tools**: In environments without automatic background skill discovery (such as OpenAI Codex CLI, Aider, or generic terminals), **you MUST use your file reading tool to inspect `.agents/skills/<skill>/SKILL.md` before executing the stage** to strictly follow its schema, artifact contract, and quality gates.
37
37
  3. **Google Antigravity & Claude Code**: Native skill engines automatically discover and surface `.agents/skills/` and `.claude/skills/`.
38
38
  4. **State-Aware Inspection**: When unsure what to do next, invoke `devflow` to automatically inspect `devflow/context/current-stage.md` and active runs in `devflow/runs/`.
@@ -45,10 +45,10 @@ Unused adapter families can be removed. Codex and Antigravity projects keep `.ag
45
45
  Recommended for 85% of daily work (features, bug fixes, UI improvements, iterative tasks):
46
46
 
47
47
  ```text
48
- /spec (or /feature, /fix) ──▶ /implement ──▶ /check ──▶ /complete
48
+ /feature (หรือ /fix) ──▶ /implement ──▶ /check ──▶ /complete
49
49
  ```
50
50
 
51
- 1. **`spec` (`/spec`, `/feature`, `/fix`)**:
51
+ 1. **`feature` / `fix` (`/feature`, `/fix`, `/spec`)**:
52
52
  - **Purpose**: Combines Discover, Define, Spec, and Plan into one unified step. Allocates sequential Running ID (`RUN-xxx`) and creates the **Single Living Spec (`spec.md`)**.
53
53
  - **Artifact**: `devflow/runs/{running-id}-{slug}/spec.md`
54
54
  2. **`implement` (`/implement`)**:
@@ -65,14 +65,14 @@ Recommended for 85% of daily work (features, bug fixes, UI improvements, iterati
65
65
  Recommended for large architectural epics, database migrations, and multi-agent coordination:
66
66
 
67
67
  ```text
68
- 00-discover ──▶ 10-define ──▶ 20-spec ──▶ 30-plan ──▶ 40-implement ──▶ 50-verify ──▶ 60-report ──▶ 70-release
68
+ 00-discover ──▶ 10-define ──▶ 20-spec ──▶ 30-plan ──▶ 40-execute ──▶ 50-verify ──▶ 60-report ──▶ 70-release
69
69
  ```
70
70
 
71
71
  1. `00-discover`: Explore request before delivery commitment without allocating running ID (`00-discover.md`).
72
72
  2. `10-define`: Turn approved discovery into bounded delivery run(s) with sequential Running IDs (`10-define.md`).
73
73
  3. `20-spec`: Formalize markdown-first delivery contract & acceptance criteria (`20-spec.md`).
74
74
  4. `30-plan`: Breakdown spec into executable tasks with test decisions (`30-plan.md` + checklists).
75
- 5. `40-implement`: Incremental task implementation behind review gates (`40-implement.md`).
75
+ 5. `40-execute`: Incremental task execution behind review gates (`40-execute.md`).
76
76
  6. `50-verify`: Senior QA review & multi-lane verification checks (`50-verify.md`).
77
77
  7. `60-report`: Standardized markdown delivery digest (`60-report.md`).
78
78
  8. `70-release`: Release packaging, release notes, git merge, and deployment (`70-release.md`).
@@ -116,7 +116,8 @@ Recommended for large architectural epics, database migrations, and multi-agent
116
116
 
117
117
  | Track / Category | Canonical Name | Claude / Antigravity (`/`) | OpenAI Codex (`$`) | Purpose / Action |
118
118
  | :--- | :--- | :--- | :--- | :--- |
119
- | **Fast: Spec** | `spec` | `/spec` / `/feature` / `/fix` | `$spec` / `$feature` / `$fix` | 4-step Fast-Track spec & living spec creation (supports `IDEA-xxx`) |
119
+ | **Fast: Feature** | `feature` | `/feature` | `$feature` | 4-step Fast-Track spec & living spec creation for new features (supports `IDEA-xxx`) |
120
+ | **Fast: Fix** | `fix` | `/fix` | `$fix` | 4-step Fast-Track spec & living spec creation for bug fixes (supports `IDEA-xxx`) |
120
121
  | **Fast: Implement** | `implement` | `/implement` | `$implement` | Fast-Track incremental execution with TDD |
121
122
  | **Fast: Check** | `check` | `/check` | `$check` | Fast-Track QA review & multi-lane verification |
122
123
  | **Fast: Complete** | `complete` | `/complete` | `$complete` | Fast-Track safety pass, release digest & git merge |
@@ -126,7 +127,7 @@ Recommended for large architectural epics, database migrations, and multi-agent
126
127
  | **Deep: 10** | `10-define` | `/10-define` | `$10-define` | Turn approved discovery into bounded delivery run(s) |
127
128
  | **Deep: 20** | `20-spec` | `/20-spec` | `$20-spec` | Formal markdown delivery contract & acceptance criteria |
128
129
  | **Deep: 30** | `30-plan` | `/30-plan` | `$30-plan` | Breakdown spec into executable tasks with test decisions |
129
- | **Deep: 40** | `40-implement` | `/40-implement` | `$40-implement` | Implement tasks in small reviewable increments |
130
+ | **Deep: 40** | `40-execute` | `/40-execute` | `$40-execute` | Execute planned tasks in small reviewable increments (`40-execute.md`) |
130
131
  | **Deep: 50** | `50-verify` | `/50-verify` | `$50-verify` | Senior QA review & multi-lane verification checks |
131
132
  | **Deep: 60** | `60-report` | `/60-report` | `$60-report` | Standalone markdown summary report |
132
133
  | **Deep: 70** | `70-release` | `/70-release` | `$70-release` | Package for delivery, git merge, PR, or deployment |
@@ -24,12 +24,12 @@
24
24
  ## DevFlow Timeline Lifecycle
25
25
 
26
26
  ```text
27
- /00-Discover -> /10-Define -> /20-Spec -> /30-Plan -> /40-Implement -> /50-Verify -> /60-Report -> /70-Release
27
+ /00-Discover -> /10-Define -> /20-Spec -> /30-Plan -> /40-Execute -> /50-Verify -> /60-Report -> /70-Release
28
28
  ```
29
29
 
30
30
  - Run `/00-Discover` to explore requests under a Discovery ID.
31
31
  - Run `/10-Define` to set delivery boundaries and allocate Running IDs.
32
32
  - Run `/20-Spec` and `/30-Plan` to establish formal delivery specifications and execution plans.
33
- - Run `/40-Implement` for step-by-step code implementation with evidence.
33
+ - Run `/40-Execute` for step-by-step code implementation with evidence.
34
34
  - Run `/50-Verify`, `/60-Report`, and `/70-Release` for quality verification, reporting, and release packaging.
35
35
  - Use **Fast-Track / Quick-Fix mode** for minor hotfixes to skip heavy ceremony while keeping test evidence.
@@ -36,5 +36,5 @@ General engineering standards for code, tests, and documentation in Nexus-DevFlo
36
36
 
37
37
  - For trivial bug fixes, typo corrections, or single-file non-architectural changes, developers and agents may use the **Quick-Fix Fast-Track**:
38
38
  - Consolidate Discovery, Define, and Spec into an inline fix brief (`devflow/runs/{fix-id}/fix-brief.md`).
39
- - Jump directly to `40-implement` (with reproduction unit test) ➔ `50-verify` ➔ `70-release`.
39
+ - Jump directly to `40-execute` (with reproduction unit test) ➔ `50-verify` ➔ `70-release`.
40
40
  - Avoid creating heavy redundant documentation for changes under 20 lines of code while preserving Empirical Proof and Unit Test requirements.
@@ -2,6 +2,7 @@
2
2
 
3
3
  - **Active Discovery ID**: None
4
4
  - **Active Running ID**: None
5
- - **Current Stage**: Ready for new work (Fast-Track: `/spec`, `/feature`, `/fix`, or Deep-Track: `00-discover`, Idea: `/idea`)
6
- - **Last Completed Run**: RUN-016-idea-capture-inbox-and-status-integration (2026-08-20)
5
+ - **Current Stage**: Idle (Ready for next run)
6
+ - **Living Spec**: None
7
+ - **Last Completed Run**: RUN-018-update-documentation-and-guides (2026-08-20)
7
8
  - **Last Updated**: 2026-08-20
@@ -19,19 +19,23 @@ Primary source of truth for the project context, architecture, tech stack, and a
19
19
 
20
20
  ## Architecture & Key Modules
21
21
 
22
+ - **Dual-Track Delivery Engine**:
23
+ - **Fast-Track (Blueprint Mode — 4 Steps)**: High-velocity spec loop (`/feature` or `/fix` ➔ `/implement` ➔ `/check` ➔ `/complete`) with Single Living Spec (`spec.md`).
24
+ - **Deep-Track (Architect Mode — 8 Steps)**: Full-lifecycle delivery pipeline (`00-discover` ➔ `10-define` ➔ `20-spec` ➔ `30-plan` ➔ `40-execute` ➔ `50-verify` ➔ `60-report` ➔ `70-release`).
22
25
  - **`packages/create-nexus-devflow/`**: Distribution CLI package with TypeScript compilation (`dist/bin/create-nexus-devflow.js`), atomic update engine (`lib/update.ts`), and prepack template bundler (`scripts/prepare-template.ts`).
23
- - **`.agents/skills/` & `.claude/skills/`**: 72 synchronized AI agent skills covering Mainline stages (00-70) and companion tools (`devflow`, `try`, `doctor`, `overview`, `sync-upstream`, `ci`, `rollback`).
26
+ - **`.agents/skills/` & `.claude/skills/`**: 80 synchronized AI agent skills covering Dual-Track workflows and companion tools (`devflow`, `idea`, `report-html`, `try`, `doctor`, `overview`, `sync-upstream`, `ci`, `rollback`).
24
27
  - **`scripts/`**: Maintainer infrastructure (`check-devflow.ts`, `validate-framework.ts`, `smoke-package.ts`, `upstream-monitor.ts`, `evals/routing.ts`).
25
- - **`devflow/`**: Workspace state, discoveries, runs, context, reference contracts, and master release history ledger.
28
+ - **`devflow/`**: Workspace state, discoveries, runs, ideas, context, reference contracts, and master release history ledger.
26
29
 
27
30
  ## Shipped Capabilities (Recent Milestones)
28
31
 
32
+ - **`RUN-017` (2026-08-20)**: Separate Fast-Track skills (`/feature`, `/fix`) and rename Deep-Track stage 40 to `40-execute` to eliminate command collisions.
33
+ - **`RUN-016` (2026-08-20)**: Quick Idea Capture and AI Feasibility Assessment (`/idea`) with centralized Idea Inbox (`devflow/ideas.md`).
34
+ - **`RUN-015` (2026-08-20)**: Dual-Track Architecture (Fast-Track 4 Steps & Deep-Track 8 Steps) + Living Spec (`spec.md`) + Standalone HTML Reporting Policy.
29
35
  - **`RUN-014` (2026-08-20)**: Upgraded DevFlow to full TypeScript architecture (`tsconfig.json`, `tsx`, `tsc`, `dist/`), migrated AI Blueprint Upstream Monitor workflow to DevFlow, and established multi-lane verification matrix.
30
- - **`RUN-013` (2026-08-20)**: Added `/overview` skill for living context scanning and synchronization.
31
- - **`RUN-008` (2026-08-18)**: Lean & Clean DevFlow optimization, consolidated skill taxonomy, and safe rollback mechanisms.
32
36
 
33
37
  ## DevFlow Workspace Status
34
38
 
35
39
  - **Active Discovery ID**: None (Idle)
36
- - **Active Running ID**: None (Idle)
37
- - **Last Completed Run**: `RUN-014-typescript-migration-and-upstream-monitor-for-devflow`
40
+ - **Active Running ID**: `RUN-018-update-documentation-and-guides`
41
+ - **Last Completed Run**: `RUN-017-split-spec-and-rename-40-execute`
@@ -8,6 +8,8 @@ This master ledger tracks all released delivery runs, milestones, and rollbacks
8
8
 
9
9
  | Release Date | Running ID | Title | Git Tag / Commit | Release Status | Report Link |
10
10
  | :--- | :--- | :--- | :--- | :--- | :--- |
11
+ | 2026-08-20 | `RUN-018` | อัปเดตคู่มือ เอกสาร และ Website Documentation ให้เป็นปัจจุบันและครอบคลุม Dual-Track Model ล่าสุด | `HEAD` | `Released` | [`spec.md`](../runs/RUN-018-update-documentation-and-guides/spec.md) |
12
+ | 2026-08-20 | `RUN-017` | แยกคำสั่ง Fast-Track เป็น `/feature`, `/fix` และเปลี่ยน Deep-Track สเตจ 40 เป็น `40-execute` | `HEAD` | `Released` | [`spec.md`](../runs/RUN-017-split-spec-and-rename-40-execute/spec.md) |
11
13
  | 2026-08-20 | `RUN-016` | ระบบบันทึกไอเดียพร้อม AI วิเคราะห์ความเป็นไปได้ (`/idea`) และเชื่อมต่อกับ Status Backlog | `HEAD` | `Released` | [`spec.md`](../runs/RUN-016-idea-capture-inbox-and-status-integration/spec.md) |
12
14
  | 2026-08-20 | `RUN-015` | Dual-Track Architecture (Fast-Track 4 Steps & Deep-Track 8 Steps) + Living Spec (`spec.md`) + Standalone HTML Report Policy | `HEAD` | `Released` | [`spec.md`](../runs/RUN-015-fast-track-and-living-blueprint/spec.md) |
13
15
  | 2026-08-20 | `RUN-014` | ยกระดับสถาปัตยกรรม DevFlow สู่ TypeScript และย้ายระบบ Check AI Blueprint Upstream Monitor | `HEAD` | `Released` | [`60-report.md`](../runs/RUN-014-typescript-migration-and-upstream-monitor-for-devflow/60-report.md) |
@@ -12,4 +12,4 @@
12
12
 
13
13
  ## 📦 Archived / Shipped Ideas
14
14
 
15
- *(ไอเดียที่ถูกหยิบไปทำด้วย `/spec IDEA-xxx` หรือ `/00-discover IDEA-xxx` จะถูกย้ายมาบันทึกที่นี่)*
15
+ *(ไอเดียที่ถูกหยิบไปทำด้วย `/feature IDEA-xxx`, `/fix IDEA-xxx` หรือ `/00-discover IDEA-xxx` จะถูกย้ายมาบันทึกที่นี่)*
@@ -15,7 +15,7 @@ All DevFlow framework context, active runs, templates, and history are consolida
15
15
  - `10-define.md`
16
16
  - `20-spec.md`
17
17
  - `30-plan.md`
18
- - `40-implement.md`
18
+ - `40-execute.md`
19
19
  - `50-verify.md`
20
20
  - `60-report.md` (and `60-report.html`)
21
21
  - `70-release.md`
@@ -34,6 +34,6 @@ All DevFlow framework context, active runs, templates, and history are consolida
34
34
 
35
35
  ## Mainline Lifecycle Rules
36
36
 
37
- 1. Mainline stages move linearly: `/00-Discover` ➔ `/10-Define` ➔ `/20-Spec` ➔ `/30-Plan` ➔ `/40-Implement` ➔ `/50-Verify` ➔ `/60-Report` ➔ `/70-Release`.
37
+ 1. Mainline stages move linearly: `/00-Discover` ➔ `/10-Define` ➔ `/20-Spec` ➔ `/30-Plan` ➔ `/40-Execute` ➔ `/50-Verify` ➔ `/60-Report` ➔ `/70-Release`.
38
38
  2. Companion commands (`Goal`, `Brainstorm`, `Research`, `Debug`, `PRD`, `Issue-Triage`, `Security-Review`, `Check-For-Updates`, `Help`) provide supporting context without replacing mainline stage numbers.
39
39
  3. Every stage produces markdown-first evidence in `devflow/runs/` before passing verification gates.