@jakkrichm/create-nexus-devflow 2.0.13 → 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 (102) hide show
  1. package/README.md +4 -4
  2. package/dist/bin/create-nexus-devflow.d.ts +2 -0
  3. package/dist/bin/create-nexus-devflow.js +233 -0
  4. package/dist/bin/create-nexus-devflow.js.map +1 -0
  5. package/dist/lib/starter-templates.d.ts +6 -0
  6. package/dist/lib/starter-templates.js +8 -0
  7. package/dist/lib/starter-templates.js.map +1 -0
  8. package/dist/lib/update.d.ts +68 -0
  9. package/dist/lib/update.js +325 -0
  10. package/dist/lib/update.js.map +1 -0
  11. package/dist/scripts/clean-template.d.ts +1 -0
  12. package/dist/scripts/clean-template.js +14 -0
  13. package/dist/scripts/clean-template.js.map +1 -0
  14. package/dist/scripts/prepare-template.d.ts +1 -0
  15. package/dist/scripts/prepare-template.js +89 -0
  16. package/dist/scripts/prepare-template.js.map +1 -0
  17. package/package.json +11 -9
  18. package/template/.agents/skills/00-discover/SKILL.md +2 -0
  19. package/template/.agents/skills/30-plan/SKILL.md +6 -6
  20. package/template/{.claude/skills/40-implement → .agents/skills/40-execute}/SKILL.md +21 -26
  21. package/template/.agents/skills/50-verify/SKILL.md +10 -10
  22. package/template/.agents/skills/60-report/SKILL.md +22 -76
  23. package/template/.agents/skills/70-release/SKILL.md +11 -10
  24. package/template/.agents/skills/agent/SKILL.md +3 -3
  25. package/template/.agents/skills/autopilot/SKILL.md +6 -6
  26. package/template/.agents/skills/brainstorm/SKILL.md +1 -1
  27. package/template/.agents/skills/brief/SKILL.md +1 -1
  28. package/template/.agents/skills/check/SKILL.md +68 -0
  29. package/template/.agents/skills/codebase-design/SKILL.md +2 -2
  30. package/template/.agents/skills/commit/SKILL.md +1 -1
  31. package/template/.agents/skills/complete/SKILL.md +73 -0
  32. package/template/.agents/skills/debug/SKILL.md +2 -2
  33. package/template/.agents/skills/devflow/SKILL.md +89 -80
  34. package/template/.agents/skills/doctor/SKILL.md +1 -1
  35. package/template/.agents/skills/feature/SKILL.md +103 -0
  36. package/template/.agents/skills/fix/SKILL.md +102 -0
  37. package/template/.agents/skills/followup/SKILL.md +5 -5
  38. package/template/.agents/skills/help/SKILL.md +4 -4
  39. package/template/.agents/skills/idea/SKILL.md +57 -0
  40. package/template/.agents/skills/implement/SKILL.md +64 -0
  41. package/template/.agents/skills/insight/SKILL.md +1 -1
  42. package/template/.agents/skills/overview/SKILL.md +114 -0
  43. package/template/.agents/skills/pr/SKILL.md +1 -1
  44. package/template/.agents/skills/preview/SKILL.md +1 -1
  45. package/template/.agents/skills/report-html/SKILL.md +45 -0
  46. package/template/.agents/skills/review/SKILL.md +1 -1
  47. package/template/.agents/skills/rollback/SKILL.md +3 -3
  48. package/template/.agents/skills/security-review/SKILL.md +2 -2
  49. package/template/.agents/skills/simplify/SKILL.md +1 -1
  50. package/template/.agents/skills/spec/SKILL.md +38 -0
  51. package/template/.agents/skills/test/SKILL.md +2 -2
  52. package/template/.agents/skills/try/SKILL.md +2 -2
  53. package/template/.claude/skills/00-discover/SKILL.md +2 -0
  54. package/template/.claude/skills/30-plan/SKILL.md +6 -6
  55. package/template/{.agents/skills/40-implement → .claude/skills/40-execute}/SKILL.md +21 -26
  56. package/template/.claude/skills/50-verify/SKILL.md +10 -10
  57. package/template/.claude/skills/60-report/SKILL.md +22 -76
  58. package/template/.claude/skills/70-release/SKILL.md +11 -10
  59. package/template/.claude/skills/agent/SKILL.md +3 -3
  60. package/template/.claude/skills/autopilot/SKILL.md +6 -6
  61. package/template/.claude/skills/brainstorm/SKILL.md +1 -1
  62. package/template/.claude/skills/brief/SKILL.md +1 -1
  63. package/template/.claude/skills/check/SKILL.md +68 -0
  64. package/template/.claude/skills/codebase-design/SKILL.md +2 -2
  65. package/template/.claude/skills/commit/SKILL.md +1 -1
  66. package/template/.claude/skills/complete/SKILL.md +73 -0
  67. package/template/.claude/skills/debug/SKILL.md +2 -2
  68. package/template/.claude/skills/devflow/SKILL.md +89 -80
  69. package/template/.claude/skills/doctor/SKILL.md +1 -1
  70. package/template/.claude/skills/feature/SKILL.md +103 -0
  71. package/template/.claude/skills/fix/SKILL.md +102 -0
  72. package/template/.claude/skills/followup/SKILL.md +5 -5
  73. package/template/.claude/skills/help/SKILL.md +4 -4
  74. package/template/.claude/skills/idea/SKILL.md +57 -0
  75. package/template/.claude/skills/implement/SKILL.md +64 -0
  76. package/template/.claude/skills/insight/SKILL.md +1 -1
  77. package/template/.claude/skills/overview/SKILL.md +114 -0
  78. package/template/.claude/skills/pr/SKILL.md +1 -1
  79. package/template/.claude/skills/preview/SKILL.md +1 -1
  80. package/template/.claude/skills/report-html/SKILL.md +45 -0
  81. package/template/.claude/skills/review/SKILL.md +1 -1
  82. package/template/.claude/skills/rollback/SKILL.md +3 -3
  83. package/template/.claude/skills/security-review/SKILL.md +2 -2
  84. package/template/.claude/skills/simplify/SKILL.md +1 -1
  85. package/template/.claude/skills/spec/SKILL.md +38 -0
  86. package/template/.claude/skills/test/SKILL.md +2 -2
  87. package/template/.claude/skills/try/SKILL.md +2 -2
  88. package/template/AGENTS.md +72 -74
  89. package/template/devflow/context/ai-interaction.md +3 -2
  90. package/template/devflow/context/coding-standards.md +31 -18
  91. package/template/devflow/context/current-stage.md +4 -3
  92. package/template/devflow/context/findings.md +10 -6
  93. package/template/devflow/context/project-overview.md +33 -11
  94. package/template/devflow/discoveries/.gitkeep +0 -0
  95. package/template/devflow/history/HISTORY.md +6 -0
  96. package/template/devflow/ideas.md +15 -0
  97. package/template/devflow/reference/running-id-contract.md +2 -2
  98. package/template/devflow/runs/.gitkeep +0 -0
  99. package/bin/create-nexus-devflow.js +0 -287
  100. package/lib/starter-templates.js +0 -111
  101. package/lib/update.js +0 -393
  102. package/template/.nexus/nexus-devflow.json +0 -44
@@ -1,6 +1,6 @@
1
- ---name: 60-report
2
-
3
- description: "[Devflow] Report stage in DevFlow 2.0 - produce standardized markdown and HTML summary report for the completed run."
1
+ ---
2
+ name: 60-report
3
+ description: "[Devflow] Report stage in DevFlow 2.0 - produce standardized markdown summary report for the completed run."
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
- Produce the final human-friendly summary of the full running flow in both Markdown and HTML so the outcome is easy to communicate every time.
11
+ Produce the final human-friendly summary of the full running flow in Markdown (`60-report.md`) so the outcome is easy to communicate every time.
12
12
 
13
13
  ## Usage
14
14
 
@@ -16,19 +16,12 @@ Produce the final human-friendly summary of the full running flow in both Markdo
16
16
  60-report {running-id or workspace path}
17
17
  ```
18
18
 
19
- Use this when:
20
-
21
- - verification is complete and the run is ready for a final standardized summary before release
22
- - the team needs a standardized summary for communication
23
- - non-technical readers should be able to understand what happened
24
-
25
19
  ## Markdown-First Contract
26
20
 
27
- Write the primary stage artifacts to:
21
+ Write the primary stage artifact to:
28
22
 
29
23
  ```text
30
- devflow/runs/{ID}-{slug}60-report.md
31
- devflow/runs/{ID}-{slug}60-report.html
24
+ devflow/runs/{ID}-{slug}/60-report.md
32
25
  ```
33
26
 
34
27
  using:
@@ -39,6 +32,9 @@ using:
39
32
 
40
33
  Before writing `60-report.md`, read `artifact_language` from `report.template.md` and produce the markdown artifact in that language.
41
34
 
35
+ > [!IMPORTANT]
36
+ > **No Auto-Generated HTML**: ยกเลิกการสร้างไฟล์ `60-report.html` แบบอัตโนมัติในขั้นตอนนี้! ระบบจะสร้างเฉพาะ `60-report.md` เท่านั้น หากผู้ใช้หรือทีมต้องการสร้าง HTML Report สวยงาม ให้เรียกคำสั่งแยกต่างหาก: `/report:html` หรือ `npm run report:html`
37
+
42
38
  ## Required Section Content
43
39
 
44
40
  Before completing any generated artifact:
@@ -57,13 +53,13 @@ Before completing any generated artifact:
57
53
 
58
54
  Run reporting as an outcome-evidence loop, not as a dump of prior artifacts.
59
55
 
60
- - **Intent**: produce a final markdown and HTML summary that lets a reader understand the outcome, evidence, decisions, risks, and next actions without replaying the whole run.
56
+ - **Intent**: produce a final markdown summary that lets a reader understand the outcome, evidence, decisions, risks, and next actions without replaying the whole run.
61
57
  - **Context**: read all relevant stage artifacts, checklist files, verify impact notes, release notes, validation output, and supporting artifacts that materially explain the result.
62
- - **Action**: summarize the problem, direction, completed work, validation outcome, checklist progress, final decision, open risks, and next actions, then render the HTML report.
58
+ - **Action**: summarize the problem, direction, completed work, validation outcome, checklist progress, final decision, open risks, and next actions.
63
59
  - **Observation**: use concrete evidence such as checklist completion, blocked or skipped items, validation results, release state, impact notes, and unresolved follow-ups.
64
60
  - **Adjustment**: if evidence is missing, return to the owning stage; if the report must support continuation, use `handoff`; if the run produced reusable lessons, use `insight-capture` or `Wiki`.
65
- - **Stop Condition**: stop when `70-report.md` and `70-report.html` both exist, summarize the outcome accurately, include checklist and evidence snapshots, and name any remaining follow-up work.
66
- - **Handoff**: `70-report.md` must close the mainline run or tell the next reader exactly where follow-up work should continue.
61
+ - **Stop Condition**: stop when `60-report.md` exists, summarizes the outcome accurately, includes checklist and evidence snapshots, and names any remaining follow-up work.
62
+ - **Handoff**: `60-report.md` must close the mainline run or tell the next reader exactly where follow-up work should continue.
67
63
 
68
64
  ### 1. Gather Full Run Context
69
65
 
@@ -73,7 +69,7 @@ Read all relevant stage artifacts:
73
69
  - `10-define.md`
74
70
  - `20-spec.md`
75
71
  - `30-plan.md`
76
- - `40-implement.md`
72
+ - `40-execute.md`
77
73
  - `50-verify.md`
78
74
  - `checklists/implementation-checklist.md` when present
79
75
  - `checklists/verification-checklist.md` when present
@@ -98,19 +94,9 @@ Explain:
98
94
 
99
95
  Write:
100
96
 
101
- - a readable Markdown report for contributors
102
- - a consistent HTML report for stakeholder sharing
103
-
104
- In phase 1, `artifact_language` governs the markdown report text. HTML output is derived directly from `60-report.md` through the shared markdown-to-html renderer.
97
+ - a readable Markdown report (`60-report.md`) for contributors
105
98
 
106
- To render the HTML consistently from the markdown report, use one of:
107
-
108
- ```text
109
- npm run report:html -- <workspace-path-or-running-id>
110
- npm run render:html -- --stage 60-report <workspace-path-or-running-id>
111
- ```
112
-
113
- Keep checklist summaries and follow-up status inside `60-report.md` so they carry through into the rendered HTML.
99
+ Keep checklist summaries and follow-up status inside `60-report.md`.
114
100
 
115
101
  Both outputs should summarize checklist state when checklist artifacts exist, including:
116
102
 
@@ -120,27 +106,6 @@ Both outputs should summarize checklist state when checklist artifacts exist, in
120
106
  - approval status, review blockers, and next allowed command when they still matter
121
107
  - remaining follow-up work
122
108
 
123
- The HTML should stay visually consistent across runs while preserving the report markdown as the source of truth.
124
-
125
- ### 4. Keep The Audience In Mind
126
-
127
- Prefer clarity over internal detail.
128
-
129
- Do not bury the outcome inside implementation trivia. The report should help a reader understand the run without replaying the whole workflow.
130
-
131
- When checklists exist, use them as the most human-readable operational record of what actually happened.
132
- Use `handoff` when the report must support continued work, and `insight-capture` when the run produced lessons that should become reusable knowledge.
133
-
134
- ### 5. Manual Review Soft Gate
135
-
136
- Use the report as the final visibility checkpoint before release.
137
- If any stage still shows unresolved approval, blockers, or deferred work:
138
-
139
- - surface that state clearly in `60-report.md`
140
- - pull the relevant signal forward from checklist approval sections when they exist
141
- - do not imply the phase is fully closed when review is still open
142
- - recommend the real next action, even if that means returning to an earlier stage
143
-
144
109
  ## Output
145
110
 
146
111
  Report:
@@ -148,37 +113,18 @@ Report:
148
113
  - what the run accomplished
149
114
  - checklist completion status and remaining items
150
115
  - important remaining follow-ups
151
- - where `60-report.md` and `60-report.html` were written
152
- - render command used or recommended:
153
-
154
- ```text
155
- npm run report:html -- <workspace-path-or-running-id>
156
- ```
116
+ - where `60-report.md` was written
117
+ - standalone HTML command tip: `/report:html` (if HTML view is desired)
157
118
 
158
119
  ## Relationship To DevFlow 2.0
159
120
 
160
121
  - Classification: Mainline workflow
161
122
  - Previous state: `50-verify`
162
123
  - Next state: `70-release` when the summary is aligned and release can proceed
163
- - Common companion commands: `Wiki` for durable knowledge capture, `Help` for routing or explanation
164
- - Support skills: `handoff`, `insight-capture`, and writing skills when final reporting must support continuation or reusable learning
165
-
166
- ## Sources
167
-
168
- - `AGENTS.md`
169
- - `docs/workspace-artifacts.md`
170
- - `.agent/resources/schemas/report.template.md`
171
- - Related commands: `50-verify`, `70-release`, `Wiki`, `Help`
124
+ - Common companion commands: `/report:html` for standalone HTML dashboard, `Wiki` for durable knowledge capture, `Help` for routing or explanation
172
125
 
173
126
  ## Next Workflow Recommendation
174
127
 
175
- - **Primary**: `70-release {ID}` after `60-report.md` and `60-report.html` reflect the verified state clearly.
176
- - **Render HTML**: `npm run report:html -- {ID}` after `60-report.md` is finalized so the standardized stakeholder HTML stays in sync
177
- - **Alternative**: `Wiki` when the completed run should be promoted into durable reusable knowledge before release packaging continues
178
- - **Additional Alternative**: `handoff` when another session or agent must continue from the completed run.
179
-
180
- ## Nexus Event
181
-
182
- - Use `Wiki` when the final summary should become durable project or framework knowledge.
183
- - Use `Help` when approval signals, ownership, or route timing still feel ambiguous.
184
- - Return to `50-verify` when unresolved evidence, blockers, or review state mean the report should not advance yet.
128
+ - **Primary**: `70-release {ID}` after `60-report.md` reflects the verified state clearly.
129
+ - **Optional Standalone HTML**: `/report:html` (or `npm run report:html -- {ID}`) if an interactive HTML report is desired for stakeholder presentation.
130
+ - **Alternative**: `Wiki` when the completed run should be promoted into durable reusable knowledge before release packaging continues.
@@ -57,10 +57,10 @@ Before completing any generated artifact:
57
57
  Run release as a readiness-packaging loop, not as a celebratory summary.
58
58
 
59
59
  - **Intent**: convert verified work into a clear release, PR, merge, deploy, or handoff packet without hiding unresolved risk.
60
- - **Context**: read `50-verify.md`, `50-verify-impact.md` when present, `40-implement.md`, `20-spec.md`, checklist state, and any PR, deploy, merge, or handoff notes.
60
+ - **Context**: read `50-verify.md`, `50-verify-impact.md` when present, `40-execute.md`, `20-spec.md`, checklist state, and any PR, deploy, merge, or handoff notes.
61
61
  - **Action**: summarize delivered scope, user/system impact, readiness state, validation evidence, rollback or mitigation notes, and follow-up items.
62
62
  - **Observation**: use concrete evidence such as verify verdict, failed or skipped checks, impact notes, residual risks, merge/deploy constraints, and checklist status.
63
- - **Adjustment**: if release readiness becomes uncertain, return to `50-verify`; if fixes are required, return to `40-implement`; if context must transfer, use `handoff`.
63
+ - **Adjustment**: if release readiness becomes uncertain, return to `50-verify`; if fixes are required, return to `40-execute`; if context must transfer, use `handoff`.
64
64
  - **Stop Condition**: stop when the release state is explicit, evidence supports readiness, residual risks and follow-ups are named, and the next delivery or reporting route is clear.
65
65
  - **Handoff**: `70-release.md` must close the mainline run or tell the next reader what shipped, what did not ship, what evidence supports readiness, and what follow-ups remain.
66
66
 
@@ -86,7 +86,7 @@ Read:
86
86
 
87
87
  - `60-report.md`
88
88
  - `50-verify.md`
89
- - `40-implement.md`
89
+ - `40-execute.md`
90
90
  - `20-spec.md`
91
91
  - `devflow/context/findings.md`
92
92
  - any PR, deploy, merge, or handoff notes already captured
@@ -118,7 +118,7 @@ Prefer clear release-note style wording:
118
118
 
119
119
  If release readiness changes because unresolved issues are found:
120
120
 
121
- - route back to `50-verify` or `40-implement`
121
+ - route back to `50-verify` or `40-execute`
122
122
 
123
123
  Do not package unfinished work as release-ready through wording tricks.
124
124
  When executing git operations:
@@ -148,7 +148,7 @@ Report:
148
148
  - Classification: Mainline workflow
149
149
  - Previous state: `60-report`
150
150
  - Next state: End of the mainline run when release packaging or handoff is complete
151
- - Common companion commands: `Commit`, `PR`, `Deploy`, `Changelog`, `Merge`, `Wiki`
151
+ - Common companion commands: `Commit`, `PR`, `Deploy`, `Changelog`, `Merge`, `Wiki`, `overview`
152
152
  - Support skills: `resolving-merge-conflicts`, `handoff`, and `setup-pre-commit` when release packaging needs conflict resolution, transfer notes, or local quality gates
153
153
 
154
154
  ## Sources
@@ -156,21 +156,22 @@ Report:
156
156
  - `AGENTS.md`
157
157
  - `docs/workspace-artifacts.md`
158
158
  - `.agent/resources/schemas/release.template.md`
159
- - Related commands: `60-report`, `Commit`, `PR`, `Deploy`, `Changelog`, `Merge`, `Wiki`
159
+ - Related commands: `60-report`, `Commit`, `PR`, `Deploy`, `Changelog`, `Merge`, `Wiki`, `overview`
160
160
 
161
161
  ## Next Workflow Recommendation
162
162
 
163
- - **Primary**: End of Timeline flow
163
+ - **Primary**: End of Timeline flow (or run `/overview` to sync living project context)
164
164
  - **Why**: The report is already complete, and this phase is the final release-facing execution step.
165
165
  - **Alternatives**:
166
+ - `overview` - choose this to immediately sync newly shipped capabilities into `devflow/context/project-overview.md`.
166
167
  - `60-report` - choose this when the release package diverges from the approved report and the summary must be refreshed first.
167
168
  - `50-verify` - choose this when release readiness becomes uncertain.
168
- - `40-implement` - choose this when additional fixes are needed before release can proceed.
169
+ - `40-execute` - choose this when additional fixes are needed before release can proceed.
169
170
  - `handoff` - choose this when release-ready context must move to another session, agent, or stakeholder packet.
170
171
 
171
172
  ## Nexus Event
172
173
 
173
- - Use `Commit`, `PR`, `Deploy`, `Merge`, or `Changelog` when release execution still needs a concrete lane.
174
+ - Use `Commit`, `PR`, `Deploy`, `Merge`, `Changelog`, or `overview` when release execution still needs a concrete lane.
174
175
  - Return to `60-report` when release notes, scope, or handoff wording diverge from the approved summary.
175
- - Return to `50-verify` or `40-implement` when release readiness changes because unresolved issues are discovered.
176
+ - Return to `50-verify` or `40-execute` when release readiness changes because unresolved issues are discovered.
176
177
 
@@ -92,7 +92,7 @@ The following former narrow agents are now skills. Invoke them through the respo
92
92
 
93
93
  Specialist agents must use the DevFlow 2.0 stage-first contract:
94
94
 
95
- - Prefer `00-discover.md`, `10-define.md`, `20-spec.md`, `30-plan.md`, `40-implement.md`, `50-verify.md`, `70-release.md`, and `60-report.md` as the primary artifacts.
95
+ - Prefer `00-discover.md`, `10-define.md`, `20-spec.md`, `30-plan.md`, `40-execute.md`, `50-verify.md`, `70-release.md`, and `60-report.md` as the primary artifacts.
96
96
  - Do not silently rewrite legacy JSON artifacts.
97
97
  - If migration work still requires JSON, prefer CLI-backed minimal updates instead of full-file rewrites.
98
98
  - If the specialist is only reviewing, recommend exact commands instead of mutating artifacts.
@@ -145,7 +145,7 @@ Short reports can be returned directly in chat.
145
145
  - Classification: Companion command
146
146
  - Mainline status: Specialist invocation command, not a numbered stage
147
147
  - Typical entry points: any stage that needs focused specialist judgment
148
- - Typical handoff targets: return to the owning workflow such as `10-define`, `20-spec`, `30-plan`, `40-implement`, `50-verify`, `60-report`, `70-release`
148
+ - Typical handoff targets: return to the owning workflow such as `10-define`, `20-spec`, `30-plan`, `40-execute`, `50-verify`, `60-report`, `70-release`
149
149
 
150
150
  ## Sources
151
151
 
@@ -156,7 +156,7 @@ Short reports can be returned directly in chat.
156
156
 
157
157
  ## Next Workflow Recommendation
158
158
 
159
- - **Primary**: the workflow that owns the target's lifecycle, such as `10-define`, `20-spec`, `30-plan`, `40-implement`, `50-verify`, `60-report`, `70-release`, or `PR-Review`.
159
+ - **Primary**: the workflow that owns the target's lifecycle, such as `10-define`, `20-spec`, `30-plan`, `40-execute`, `50-verify`, `60-report`, `70-release`, or `PR-Review`.
160
160
  - **Why**: `Agent` supplies specialist judgment; the owning workflow should execute the next lifecycle step.
161
161
  - **Alternatives**:
162
162
  - `Research` when the specialist work uncovered unresolved external uncertainty
@@ -14,9 +14,9 @@ devflow -> [autopilot] -> review packet -> 70-release
14
14
  report)
15
15
  ```
16
16
 
17
- Autopilot is an explicit opt-in execution skill for Nexus-DevFlow 2.0. It runs a single bounded loop across the delivery lifecycle (**`20-spec` -> `30-plan` -> `40-implement` -> `50-verify` -> `60-report`**) without requiring human confirmation between every sub-step.
17
+ Autopilot is an explicit opt-in execution skill for Nexus-DevFlow 2.0. It runs a single bounded loop across the delivery lifecycle (**`20-spec` -> `30-plan` -> `40-execute` -> `50-verify` -> `60-report`**) without requiring human confirmation between every sub-step.
18
18
 
19
- It does **not** replace the normal step-by-step workflow. Mainline commands (`20-spec`, `30-plan`, `40-implement`, `50-verify`, `60-report`, `70-release`) remain the conservative default.
19
+ It does **not** replace the normal step-by-step workflow. Mainline commands (`20-spec`, `30-plan`, `40-execute`, `50-verify`, `60-report`, `70-release`) remain the conservative default.
20
20
 
21
21
  Do not suggest Autopilot as the default next action. Use it only when the user explicitly asks for it.
22
22
 
@@ -34,7 +34,7 @@ Common forms:
34
34
  If the requested target conflicts with a run already in progress, stop and ask which one should win. Do not overwrite active stage artifacts silently.
35
35
 
36
36
  > [!IMPORTANT]
37
- > Rollback is intentionally excluded from Autopilot. If the request is a rollback or the stage is marked Rollback, stop and direct the user to `rollback` and reviewed `40-implement`. Reversing completed work requires explicit dependency and human review gates.
37
+ > Rollback is intentionally excluded from Autopilot. If the request is a rollback or the stage is marked Rollback, stop and direct the user to `rollback` and reviewed `40-execute`. Reversing completed work requires explicit dependency and human review gates.
38
38
 
39
39
  ---
40
40
 
@@ -82,7 +82,7 @@ Stop before changing files when:
82
82
 
83
83
  ---
84
84
 
85
- ## Step 4 - Implement in Small Increments (`40-implement`)
85
+ ## Step 4 - Implement in Small Increments (`40-execute`)
86
86
 
87
87
  Work through the implementation checklist in order. Each step must remain reviewable.
88
88
 
@@ -99,7 +99,7 @@ For every subtask:
99
99
  git add <modified-files> devflow/runs/{running-id}-{slug}/checklists/implementation-checklist.md
100
100
  git commit -m "feat({running-id}): checkpoint <concise step description>"
101
101
  ```
102
- 8. Write `devflow/runs/{running-id}-{slug}40-implement.md`.
102
+ 8. Write `devflow/runs/{running-id}-{slug}40-execute.md`.
103
103
 
104
104
  ---
105
105
 
@@ -161,7 +161,7 @@ When Autopilot finishes successfully, output a scannable review packet:
161
161
  - **Artifacts Generated**:
162
162
  - Spec: `devflow/runs/{id}20-spec.md`
163
163
  - Plan: `devflow/runs/{id}30-plan.md`
164
- - Implement Evidence: `devflow/runs/{id}40-implement.md`
164
+ - Implement Evidence: `devflow/runs/{id}40-execute.md`
165
165
  - QA Verify Report: `devflow/runs/{id}50-verify.md`
166
166
  - Digest Report: `devflow/runs/{id}60-report.md`
167
167
  - HTML Dashboard: `devflow/runs/{id}60-report.html`
@@ -145,7 +145,7 @@ Brainstorm caching strategy
145
145
  - Honest tradeoffs over fake confidence
146
146
  - Multiple viable paths before recommending one
147
147
  - Persistent output saved to disk
148
- - Mainline remains: `00-discover -> 10-define -> 20-spec -> 30-plan -> 40-implement -> 50-verify -> 60-report -> 70-release`
148
+ - Mainline remains: `00-discover -> 10-define -> 20-spec -> 30-plan -> 40-execute -> 50-verify -> 60-report -> 70-release`
149
149
 
150
150
  ## Relationship To DevFlow 2.0
151
151
 
@@ -8,7 +8,7 @@ description: "[Devflow] Read-only scope, dependency, and risk pre-briefing befor
8
8
  Where this sits in the workflow:
9
9
 
10
10
  ```text
11
- 10-define or project-overview.md -> [brief] -> 20-spec -> 30-plan -> 40-implement
11
+ 10-define or project-overview.md -> [brief] -> 20-spec -> 30-plan -> 40-execute
12
12
  (proposed scope & context) (read-only (write (break down) (build it)
13
13
  explainer) contract)
14
14
  ```
@@ -0,0 +1,68 @@
1
+ ---
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."
4
+ argument-hint: "{running-id or workspace path}"
5
+ ---
6
+
7
+ # Fast-Track: Check (Blueprint Mode)
8
+
9
+ $ARGUMENTS
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`).
12
+
13
+ ## Invocations & Aliases
14
+
15
+ - `/check`: Run verification on current active run
16
+ - `/check {running-id}`: Run verification on specified running ID
17
+ - `$check`: Codex CLI invocation
18
+
19
+ ## Fast-Track Mainline Workflow
20
+
21
+ ```text
22
+ /spec ──▶ /implement ──▶ /check ──▶ /complete
23
+ ```
24
+
25
+ ## Behavior & Contract
26
+
27
+ When invoked:
28
+
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`.
32
+ 3. Locate `## 1. Specification & Scope` (Acceptance Criteria) and `## 3. Implementation Checklist`.
33
+
34
+ ### 2. Multi-lane Verification Execution
35
+ Execute the verification gates across all lanes:
36
+ 1. **Lane 1 (Type & Syntax Safety)**:
37
+ - Run typecheck and linting (e.g. `npm run typecheck`, `npm run lint`).
38
+ 2. **Lane 2 (Test Suites & Coverage)**:
39
+ - Run automated unit and integration tests (e.g. `npm test`).
40
+ 3. **Lane 3 (Manual / Scenario Proof)**:
41
+ - Verify specific scenarios against Acceptance Criteria (`AC-1`, `AC-2`).
42
+ - Summarize "Where to go", "What to click/call", and "What to expect".
43
+
44
+ ### 3. Update Living Spec (`spec.md`)
45
+ Append or update `## 5. Verification Evidence` in `spec.md` in **Thai (`th`)**:
46
+
47
+ ```markdown
48
+ ## 5. Verification Evidence
49
+ - **Typecheck & Linter**: Passed (0 errors, 0 warnings)
50
+ - **Automated Test Suites**: All tests passed (e.g. 12/12 passed, 0 failed)
51
+ - **Acceptance Criteria Verification**:
52
+ - [x] AC-1: {ผลการตรวจสอบเงื่อนไขที่ 1 ผ่าน 100%}
53
+ - [x] AC-2: {ผลการตรวจสอบเงื่อนไขที่ 2 ผ่าน 100%}
54
+ - **Manual Verification Guide**:
55
+ - *Where to go*: `http://localhost:3000/api/auth`
56
+ - *Action*: Send POST request with test credentials
57
+ - *Expected Result*: Received HTTP 200 with valid JWT token
58
+ ```
59
+
60
+ ### 4. Update Workspace Status
61
+ Update `devflow/context/current-stage.md`:
62
+ - `Current Stage`: `check (Fast-Track -> Verification Passed -> Ready for /complete)`
63
+
64
+ ### 5. Output Summary & Next Step
65
+ Report to the user:
66
+ - Summary of verification results across all lanes
67
+ - Evidence recorded in `spec.md`
68
+ - **Next Command**: `/complete` (or `/complete {RUNNING_ID}`)
@@ -5,7 +5,7 @@ description: "[Devflow] Shared vocabulary for designing deep modules. Use when a
5
5
 
6
6
  # Codebase Design
7
7
 
8
- Use this support skill when `20-spec`, `30-plan`, `40-implement`, or `50-verify` needs better module shape.
8
+ Use this support skill when `20-spec`, `30-plan`, `40-execute`, or `50-verify` needs better module shape.
9
9
 
10
10
  Design deep modules: a lot of behavior behind a small interface, placed at a clean seam, and testable through that interface. The aim is leverage for callers, locality for maintainers, and behavior-focused tests.
11
11
 
@@ -13,7 +13,7 @@ Design deep modules: a lot of behavior behind a small interface, placed at a cle
13
13
 
14
14
  - `20-spec`: use when requirements depend on a stable module or interface contract.
15
15
  - `30-plan`: use when planning needs file-level architecture, seams, or dependency strategy.
16
- - `40-implement`: use when implementation reveals shallow modules or awkward test seams.
16
+ - `40-execute`: use when implementation reveals shallow modules or awkward test seams.
17
17
  - `50-verify`: use when review finds code that is hard to test, hard to change, or too spread out.
18
18
 
19
19
  ## Vocabulary
@@ -55,5 +55,5 @@ Each commit should represent one atomic, self-contained change:
55
55
  ## Relationship To DevFlow 2.0
56
56
 
57
57
  - **Classification**: Companion command & Version control support
58
- - **Mainline integration**: Used during `40-implement` (checkpoint commits), `70-release` (final release commit).
58
+ - **Mainline integration**: Used during `40-execute` (checkpoint commits), `70-release` (final release commit).
59
59
  - **Handoff**: `pr`, `merge`, `70-release`
@@ -0,0 +1,73 @@
1
+ ---
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."
4
+ argument-hint: "{running-id or workspace path}"
5
+ ---
6
+
7
+ # Fast-Track: Complete (Blueprint Mode)
8
+
9
+ $ARGUMENTS
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**.
12
+
13
+ ## Invocations & Aliases
14
+
15
+ - `/complete`: Complete current active run
16
+ - `/complete {running-id}`: Complete specified running ID
17
+ - `$complete`: Codex CLI invocation
18
+
19
+ ## Fast-Track Mainline Workflow
20
+
21
+ ```text
22
+ /spec ──▶ /implement ──▶ /check ──▶ /complete
23
+ ```
24
+
25
+ ## Behavior & Contract
26
+
27
+ When invoked:
28
+
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`.
32
+ 3. Confirm:
33
+ - All checklist items in `## 3. Implementation Checklist` are marked `- [x]`.
34
+ - `## 5. Verification Evidence` contains passing verification results.
35
+
36
+ ### 2. Final Safety Pass & Changelog
37
+ 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
+
43
+ ```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.
49
+ ```
50
+ Update header status in `spec.md`: `> **Status**: Completed`.
51
+
52
+ ### 4. Policy on HTML Reports (Strict Rule)
53
+ > [!IMPORTANT]
54
+ > **No Auto-Generated HTML**: ห้ามสร้างไฟล์ `report.html` หรือ `60-report.html` แบบอัตโนมัติในขั้นตอนนี้โดยเด็ดขาด!
55
+ > หากผู้ใช้ต้องการดู HTML Dashboard สวยงาม ให้แจ้งผู้ใช้ว่าสามารถเรียกคำสั่งแยกได้: `/report:html`
56
+
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`).
60
+
61
+ ### 6. Close Active Run
62
+ Update `devflow/context/current-stage.md`:
63
+ - `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})`
66
+ - `Last Updated`: `{YYYY-MM-DD}`
67
+
68
+ ### 7. Output Completion Report
69
+ Report to the user:
70
+ - Run successfully completed and merged
71
+ - Living Spec path: `devflow/runs/{RUNNING_ID}/spec.md`
72
+ - Standalone HTML command tip: `/report:html` (if HTML view is desired)
73
+ - Workspace is now Idle and ready for the next task.
@@ -65,6 +65,6 @@ Structure:
65
65
  - **Classification**: Companion command & Investigation lane
66
66
  - **Mainline integration**:
67
67
  - During `00-discover`: Unclear failure intake before allocation
68
- - During `40-implement`: Hard test failure or unexpected runtime exception
68
+ - During `40-execute`: Hard test failure or unexpected runtime exception
69
69
  - During `50-verify`: Defect found during QA inspection
70
- - **Handoff**: `test` (write repro test), `40-implement` (execute fix), `50-verify` (re-check)
70
+ - **Handoff**: `test` (write repro test), `40-execute` (execute fix), `50-verify` (re-check)