@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,103 @@
1
+ ---
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."
4
+ argument-hint: "{feature title, IDEA-xxx, or feature description}"
5
+ ---
6
+
7
+ # Fast-Track: Feature (Blueprint Mode)
8
+
9
+ $ARGUMENTS
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`).
12
+
13
+ ## Invocations & Aliases
14
+
15
+ - `/feature <title>` or `feature <title>`: Fast-Track feature specification
16
+ - `/feature IDEA-xxx`: Intake and promote a pending idea from `devflow/ideas.md`
17
+ - `$feature`: 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 & 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`):
32
+ - Read `devflow/ideas.md` and extract the idea's title, raw problem statement, AI Feasibility notes, and Quick Seed points.
33
+ - 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}/`.
39
+
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`)**:
42
+
43
+ ```markdown
44
+ # 📐 [{RUNNING_ID}] {Feature Title} (Living Spec)
45
+
46
+ > **Status**: In-Progress
47
+ > **Track**: Fast-Track (Blueprint Mode - Feature)
48
+ > **Branch**: `{branch_name}`
49
+ > **Created Date**: {YYYY-MM-DD}
50
+ > **Owner**: {Contributor or Team}
51
+
52
+ ---
53
+
54
+ ## 1. Specification & Scope
55
+ - **Problem Statement**: {ปัญหาหรือที่มาของฟีเจอร์นี้}
56
+ - **In-Scope**:
57
+ - {ขอบเขตสิ่งที่ต้องทำสำหรับฟีเจอร์นี้}
58
+ - **Out-of-Scope**:
59
+ - {สิ่งที่ไม่ทำในรอบนี้}
60
+ - **Acceptance Criteria**:
61
+ - [ ] AC-1: {เงื่อนไขการตรวจรับข้อที่ 1}
62
+ - [ ] AC-2: {เงื่อนไขการตรวจรับข้อที่ 2}
63
+
64
+ ## 2. Plan & Test Strategy
65
+ - **Files to Modify / Create**:
66
+ - `{path/to/file1}`: {หน้าที่ที่ต้องสร้าง/แก้ไข}
67
+ - `{path/to/file2}`: {หน้าที่ที่ต้องสร้าง/แก้ไข}
68
+ - **Test Decision**: `Required (TDD)` | `Manual/Command Only` | `Not Required`
69
+ - *Rationale*: {เหตุผลความจำเป็นในการเขียนเทสต์}
70
+ - *Planned Cases*: {กรณีทดสอบหลักตาม AAA Pattern}
71
+ - **Impact & Rollback Strategy**:
72
+ - *Impact*: {ผลกระทบต่อโมดูลอื่น}
73
+ - *Rollback*: {วิธีย้อนคืนการทำงานกรณีเกิดปัญหา}
74
+
75
+ ## 3. Implementation Checklist
76
+ - [ ] Task 1.1: {งานย่อยข้อที่ 1}
77
+ - [ ] Task 1.2: {งานย่อยข้อที่ 2}
78
+ - [ ] Task 1.3: {งานย่อยข้อที่ 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`: `feature (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 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}`)
@@ -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.
@@ -48,7 +48,7 @@ Run planning as an evidence loop, not as a one-shot outline.
48
48
  - **Observation**: use concrete evidence such as file paths, existing patterns, package scripts, validation commands, and unresolved assumptions.
49
49
  - **Adjustment**: if evidence is missing, search/read more, recommend `Research` or `Agent codebase-explorer`, split the work, or route back to `20-spec` when the contract is not plan-ready.
50
50
  - **Stop Condition**: stop only when phases are ordered, subtasks are scoped, verification is explicit, test decisions are recorded, and any blockers are visible.
51
- - **Handoff**: `30-plan.md` must give `40-implement` enough context to select one scoped unit and execute it without inventing intent.
51
+ - **Handoff**: `30-plan.md` must give `40-execute` enough context to select one scoped unit and execute it without inventing intent.
52
52
 
53
53
  ### 1. Read Task Artifacts
54
54
 
@@ -161,12 +161,12 @@ If validation fails, repair only what is necessary and keep `30-plan.md` aligned
161
161
 
162
162
  ### 7. Manual Review Soft Gate
163
163
 
164
- Before recommending `40-implement`, check whether the plan still shows pending review.
164
+ Before recommending `40-execute`, check whether the plan still shows pending review.
165
165
  If `Approval Status` is still pending or major dependencies remain unresolved:
166
166
 
167
167
  - warn that implementation should wait for review
168
168
  - recommend human confirmation of sequencing, scope, and verification strategy
169
- - keep `40-implement` as a soft recommendation only
169
+ - keep `40-execute` as a soft recommendation only
170
170
 
171
171
  ## Output Checklist
172
172
 
@@ -184,7 +184,7 @@ If `Approval Status` is still pending or major dependencies remain unresolved:
184
184
 
185
185
  - Classification: Mainline workflow
186
186
  - Previous state: `20-spec`
187
- - Next state: `40-implement` when execution steps and verification are clear
187
+ - Next state: `40-execute` when execution steps and verification are clear
188
188
  - Common companion commands: `Research` or `Agent` when architecture, data flow, or external constraints still need investigation; support skills: `grill-with-docs`, `domain-modeling`, `codebase-design`, `tdd`, and `to-issues` for final design stress-testing, durable terminology capture, test planning, and issue packaging
189
189
 
190
190
  ## Sources
@@ -192,11 +192,11 @@ If `Approval Status` is still pending or major dependencies remain unresolved:
192
192
  - `AGENTS.md`
193
193
  - `docs/workspace-artifacts.md`
194
194
  - `.agent/resources/schemas/plan.template.md`
195
- - Related commands: `20-spec`, `Research`, `Agent`, `40-implement`
195
+ - Related commands: `20-spec`, `Research`, `Agent`, `40-execute`
196
196
 
197
197
  ## Next Workflow Recommendation
198
198
 
199
- - **Primary**: `40-implement {ID}`
199
+ - **Primary**: `40-execute {ID}`
200
200
  - **Why**: Approved planning is the gate before implementation in DevFlow 2.0.
201
201
  - **Alternatives**:
202
202
  - `Research` - choose this when the plan still depends on missing evidence.