@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.
- package/README.md +4 -4
- package/dist/bin/create-nexus-devflow.d.ts +2 -0
- package/dist/bin/create-nexus-devflow.js +233 -0
- package/dist/bin/create-nexus-devflow.js.map +1 -0
- package/dist/lib/starter-templates.d.ts +6 -0
- package/dist/lib/starter-templates.js +8 -0
- package/dist/lib/starter-templates.js.map +1 -0
- package/dist/lib/update.d.ts +68 -0
- package/dist/lib/update.js +325 -0
- package/dist/lib/update.js.map +1 -0
- package/dist/scripts/clean-template.d.ts +1 -0
- package/dist/scripts/clean-template.js +14 -0
- package/dist/scripts/clean-template.js.map +1 -0
- package/dist/scripts/prepare-template.d.ts +1 -0
- package/dist/scripts/prepare-template.js +89 -0
- package/dist/scripts/prepare-template.js.map +1 -0
- package/package.json +11 -9
- package/template/.agents/skills/00-discover/SKILL.md +2 -0
- package/template/.agents/skills/30-plan/SKILL.md +6 -6
- package/template/{.claude/skills/40-implement → .agents/skills/40-execute}/SKILL.md +21 -26
- package/template/.agents/skills/50-verify/SKILL.md +10 -10
- package/template/.agents/skills/60-report/SKILL.md +22 -76
- package/template/.agents/skills/70-release/SKILL.md +11 -10
- package/template/.agents/skills/agent/SKILL.md +3 -3
- package/template/.agents/skills/autopilot/SKILL.md +6 -6
- package/template/.agents/skills/brainstorm/SKILL.md +1 -1
- package/template/.agents/skills/brief/SKILL.md +1 -1
- package/template/.agents/skills/check/SKILL.md +68 -0
- package/template/.agents/skills/codebase-design/SKILL.md +2 -2
- package/template/.agents/skills/commit/SKILL.md +1 -1
- package/template/.agents/skills/complete/SKILL.md +73 -0
- package/template/.agents/skills/debug/SKILL.md +2 -2
- package/template/.agents/skills/devflow/SKILL.md +89 -80
- package/template/.agents/skills/doctor/SKILL.md +1 -1
- package/template/.agents/skills/feature/SKILL.md +103 -0
- package/template/.agents/skills/fix/SKILL.md +102 -0
- package/template/.agents/skills/followup/SKILL.md +5 -5
- package/template/.agents/skills/help/SKILL.md +4 -4
- package/template/.agents/skills/idea/SKILL.md +57 -0
- package/template/.agents/skills/implement/SKILL.md +64 -0
- package/template/.agents/skills/insight/SKILL.md +1 -1
- package/template/.agents/skills/overview/SKILL.md +114 -0
- package/template/.agents/skills/pr/SKILL.md +1 -1
- package/template/.agents/skills/preview/SKILL.md +1 -1
- package/template/.agents/skills/report-html/SKILL.md +45 -0
- package/template/.agents/skills/review/SKILL.md +1 -1
- package/template/.agents/skills/rollback/SKILL.md +3 -3
- package/template/.agents/skills/security-review/SKILL.md +2 -2
- package/template/.agents/skills/simplify/SKILL.md +1 -1
- package/template/.agents/skills/spec/SKILL.md +38 -0
- package/template/.agents/skills/test/SKILL.md +2 -2
- package/template/.agents/skills/try/SKILL.md +2 -2
- package/template/.claude/skills/00-discover/SKILL.md +2 -0
- package/template/.claude/skills/30-plan/SKILL.md +6 -6
- package/template/{.agents/skills/40-implement → .claude/skills/40-execute}/SKILL.md +21 -26
- package/template/.claude/skills/50-verify/SKILL.md +10 -10
- package/template/.claude/skills/60-report/SKILL.md +22 -76
- package/template/.claude/skills/70-release/SKILL.md +11 -10
- package/template/.claude/skills/agent/SKILL.md +3 -3
- package/template/.claude/skills/autopilot/SKILL.md +6 -6
- package/template/.claude/skills/brainstorm/SKILL.md +1 -1
- package/template/.claude/skills/brief/SKILL.md +1 -1
- package/template/.claude/skills/check/SKILL.md +68 -0
- package/template/.claude/skills/codebase-design/SKILL.md +2 -2
- package/template/.claude/skills/commit/SKILL.md +1 -1
- package/template/.claude/skills/complete/SKILL.md +73 -0
- package/template/.claude/skills/debug/SKILL.md +2 -2
- package/template/.claude/skills/devflow/SKILL.md +89 -80
- package/template/.claude/skills/doctor/SKILL.md +1 -1
- package/template/.claude/skills/feature/SKILL.md +103 -0
- package/template/.claude/skills/fix/SKILL.md +102 -0
- package/template/.claude/skills/followup/SKILL.md +5 -5
- package/template/.claude/skills/help/SKILL.md +4 -4
- package/template/.claude/skills/idea/SKILL.md +57 -0
- package/template/.claude/skills/implement/SKILL.md +64 -0
- package/template/.claude/skills/insight/SKILL.md +1 -1
- package/template/.claude/skills/overview/SKILL.md +114 -0
- package/template/.claude/skills/pr/SKILL.md +1 -1
- package/template/.claude/skills/preview/SKILL.md +1 -1
- package/template/.claude/skills/report-html/SKILL.md +45 -0
- package/template/.claude/skills/review/SKILL.md +1 -1
- package/template/.claude/skills/rollback/SKILL.md +3 -3
- package/template/.claude/skills/security-review/SKILL.md +2 -2
- package/template/.claude/skills/simplify/SKILL.md +1 -1
- package/template/.claude/skills/spec/SKILL.md +38 -0
- package/template/.claude/skills/test/SKILL.md +2 -2
- package/template/.claude/skills/try/SKILL.md +2 -2
- package/template/AGENTS.md +72 -74
- package/template/devflow/context/ai-interaction.md +3 -2
- package/template/devflow/context/coding-standards.md +31 -18
- package/template/devflow/context/current-stage.md +4 -3
- package/template/devflow/context/findings.md +10 -6
- package/template/devflow/context/project-overview.md +33 -11
- package/template/devflow/discoveries/.gitkeep +0 -0
- package/template/devflow/history/HISTORY.md +6 -0
- package/template/devflow/ideas.md +15 -0
- package/template/devflow/reference/running-id-contract.md +2 -2
- package/template/devflow/runs/.gitkeep +0 -0
- package/bin/create-nexus-devflow.js +0 -287
- package/lib/starter-templates.js +0 -111
- package/lib/update.js +0 -393
- package/template/.nexus/nexus-devflow.json +0 -44
|
@@ -1,25 +1,23 @@
|
|
|
1
|
-
---name: 40-implement
|
|
2
|
-
|
|
3
|
-
description: "[Devflow] Implement stage in DevFlow 2.0 - execute planned tasks incrementally with evidence and unit tests."
|
|
4
1
|
---
|
|
5
|
-
|
|
2
|
+
name: 40-execute
|
|
3
|
+
description: "[Devflow] Execute stage in DevFlow 2.0 - execute planned tasks incrementally with evidence and unit tests."
|
|
4
|
+
---
|
|
5
|
+
# Phase 40: Execute Code
|
|
6
6
|
|
|
7
|
-
Implement the approved plan incrementally. Source code edits are allowed in this phase.
|
|
7
|
+
Implement and execute the approved plan incrementally. Source code edits are allowed in this phase.
|
|
8
8
|
|
|
9
9
|
## Usage
|
|
10
10
|
|
|
11
11
|
```text
|
|
12
|
-
40-
|
|
12
|
+
40-execute {ID}
|
|
13
13
|
```
|
|
14
14
|
|
|
15
15
|
## Markdown-First Contract
|
|
16
16
|
|
|
17
|
-
Use `40-
|
|
18
|
-
Before writing `40-
|
|
17
|
+
Use `40-execute.md` as the primary execution artifact.
|
|
18
|
+
Before writing `40-execute.md`, produce the artifact in Thai (`th`).
|
|
19
19
|
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
Before implementation, confirm the plan is approved in the stage artifacts. Track subtask progress, implementation notes, and completion evidence directly in `40-implement.md` and related stage markdown files.
|
|
20
|
+
Before execution, confirm the plan is approved in the stage artifacts. Track subtask progress, execution notes, and completion evidence directly in `40-execute.md` and related stage markdown files.
|
|
23
21
|
|
|
24
22
|
## Required Section Content
|
|
25
23
|
|
|
@@ -37,7 +35,7 @@ Before completing any generated artifact:
|
|
|
37
35
|
|
|
38
36
|
### Loop Contract
|
|
39
37
|
|
|
40
|
-
Run
|
|
38
|
+
Run execution as scoped execution loops, one unit at a time.
|
|
41
39
|
|
|
42
40
|
- **Intent**: complete the selected planned unit while preserving the spec, plan, and repository conventions.
|
|
43
41
|
- **Context**: read `30-plan.md`, `20-spec.md`, relevant checklist items, target files, pattern files, and test decisions before editing.
|
|
@@ -45,7 +43,7 @@ Run implementation as scoped execution loops, one unit at a time.
|
|
|
45
43
|
- **Observation**: inspect concrete evidence from diffs, command output, tests, manual checks, and checklist status before claiming progress.
|
|
46
44
|
- **Adjustment**: if evidence does not match intent, fix within the current unit, capture the blocker, use `Debug`, or return to `30-plan` or `20-spec` when the work no longer matches the contract.
|
|
47
45
|
- **Stop Condition**: stop the unit when the planned change is complete, verification evidence is recorded, deviations are explained, and the next unit or handoff is clear.
|
|
48
|
-
- **Handoff**: `40-
|
|
46
|
+
- **Handoff**: `40-execute.md` must tell `50-verify` what changed, why it changed, which checks ran, what failed or was skipped, and what residual risk remains.
|
|
49
47
|
|
|
50
48
|
### 1. Get Bearings
|
|
51
49
|
|
|
@@ -61,7 +59,7 @@ Confirm the current Git branch with `git branch --show-current` and use that bra
|
|
|
61
59
|
|
|
62
60
|
Select one scoped unit of work at a time. Do not implement the whole plan as one blob.
|
|
63
61
|
|
|
64
|
-
### 2.
|
|
62
|
+
### 2. Execute One Scoped Unit
|
|
65
63
|
|
|
66
64
|
Use the original coder discipline, adapted to 2.0:
|
|
67
65
|
|
|
@@ -73,7 +71,7 @@ Use the original coder discipline, adapted to 2.0:
|
|
|
73
71
|
- make the smallest useful code change
|
|
74
72
|
- preserve project style
|
|
75
73
|
- run the planned verification
|
|
76
|
-
- record observation, adjustment, stop condition status, and the result in `40-
|
|
74
|
+
- record observation, adjustment, stop condition status, and the result in `40-execute.md`
|
|
77
75
|
- update checklist item status, timestamps, and evidence links as work progresses
|
|
78
76
|
|
|
79
77
|
If tests are `Required`:
|
|
@@ -93,7 +91,7 @@ Use the old recovery discipline when blocked:
|
|
|
93
91
|
|
|
94
92
|
Use `tdd` for behavior-change implementation loops, `diagnosing-bugs` when a tight repro is needed before a fix, and `codebase-design` when implementation exposes an awkward seam or shallow module.
|
|
95
93
|
|
|
96
|
-
### 4. Finalize
|
|
94
|
+
### 4. Finalize Execution
|
|
97
95
|
|
|
98
96
|
When the scoped work is complete:
|
|
99
97
|
|
|
@@ -102,14 +100,13 @@ When the scoped work is complete:
|
|
|
102
100
|
- record verification performed
|
|
103
101
|
- record loop evidence for each completed unit: intent, observation, adjustment, and stop condition
|
|
104
102
|
- record deviations, blockers, and manual checks
|
|
105
|
-
- follow the `artifact_language` configured in `implement.template.md`
|
|
106
103
|
- make sure checklist statuses match the actual state of the code and tests
|
|
107
|
-
- make sure `40-
|
|
104
|
+
- make sure `40-execute.md` is ready for Verify
|
|
108
105
|
|
|
109
106
|
### 5. Manual Review Soft Gate
|
|
110
107
|
|
|
111
|
-
If the plan was not clearly approved, warn that
|
|
112
|
-
When finishing `40-
|
|
108
|
+
If the plan was not clearly approved, warn that execution proceeded under review risk.
|
|
109
|
+
When finishing `40-execute.md`:
|
|
113
110
|
|
|
114
111
|
- record any deviation from the approved plan explicitly
|
|
115
112
|
- set reviewer expectations before `50-verify`
|
|
@@ -131,14 +128,13 @@ Report:
|
|
|
131
128
|
|
|
132
129
|
- Classification: Mainline workflow
|
|
133
130
|
- Previous state: `30-plan`
|
|
134
|
-
- Next state: `50-verify` when scoped
|
|
131
|
+
- Next state: `50-verify` when scoped execution is complete
|
|
135
132
|
- Common companion commands: `Debug` for blockers, `Preview` for local checks; support skills: `tdd`, `diagnosing-bugs`, and `codebase-design` for behavior changes, root-cause loops, and implementation-time design pressure
|
|
136
133
|
|
|
137
134
|
## Sources
|
|
138
135
|
|
|
139
136
|
- `AGENTS.md`
|
|
140
137
|
- `docs/workspace-artifacts.md`
|
|
141
|
-
- `.agent/resources/schemas/implement.template.md`
|
|
142
138
|
- Related commands: `30-plan`, `Debug`, `Preview`, `50-verify`
|
|
143
139
|
|
|
144
140
|
## Next Workflow Recommendation
|
|
@@ -146,7 +142,7 @@ Report:
|
|
|
146
142
|
- **Primary**: `50-verify {ID}` when the planned work is complete.
|
|
147
143
|
- **Why**: Implementation needs independent verification before release or human acceptance.
|
|
148
144
|
- **Alternatives**:
|
|
149
|
-
- `Debug "{blocker}"` - choose this when
|
|
145
|
+
- `Debug "{blocker}"` - choose this when execution is blocked by an unexplained failure.
|
|
150
146
|
- `30-plan {ID}` - choose this when the plan is incomplete or no longer matches the work.
|
|
151
147
|
- `Preview` - choose this when a local runtime or visual check is useful before formal verification.
|
|
152
148
|
- `codebase-design` - choose this when the implementation cannot be tested cleanly because the module shape is wrong.
|
|
@@ -155,12 +151,11 @@ Report:
|
|
|
155
151
|
|
|
156
152
|
- Use `Debug` when the conversation reveals an unexplained blocker, flaky behavior, or root-cause gap.
|
|
157
153
|
- Use `Preview` when a runtime, UI, or local interaction check would reduce verification risk.
|
|
158
|
-
- Return to `30-plan` when
|
|
154
|
+
- Return to `30-plan` when execution drift shows the plan no longer matches reality.
|
|
159
155
|
|
|
160
156
|
## Wiki Update Recommendation
|
|
161
157
|
|
|
162
158
|
- **Needed**: `yes` when coding discovers a reusable implementation pattern, gotcha, or context optimization.
|
|
163
159
|
- **Scope**: `project` unless the discovery is about DevFlow itself.
|
|
164
160
|
- **Reason**: Coding findings are useful only when they are stable enough to help future tasks.
|
|
165
|
-
- **Suggested Command**: `Wiki project ingest devflow/runs/{ID}-*40-
|
|
166
|
-
|
|
161
|
+
- **Suggested Command**: `Wiki project ingest devflow/runs/{ID}-*40-execute.md`
|
|
@@ -43,12 +43,12 @@ Before completing any generated artifact:
|
|
|
43
43
|
Run verification as an evidence review loop, not as a single pass/fail guess.
|
|
44
44
|
|
|
45
45
|
- **Intent**: decide whether the implementation satisfies the spec and plan without introducing unacceptable regression risk.
|
|
46
|
-
- **Context**: read `20-spec.md`, `30-plan.md`, `40-
|
|
46
|
+
- **Context**: read `20-spec.md`, `30-plan.md`, `40-execute.md`, checklist state, changed files, test decisions, and available command/manual evidence.
|
|
47
47
|
- **Action**: run or inspect validation, compare implementation evidence against the contract, review risk areas, and record findings by severity.
|
|
48
48
|
- **Observation**: use concrete evidence from test output, validation output, diff review, manual checks, skipped checks, and impact notes.
|
|
49
|
-
- **Adjustment**: if evidence is missing or failing, request targeted implementation follow-up, route to `Debug`, or return to `40-
|
|
49
|
+
- **Adjustment**: if evidence is missing or failing, request targeted implementation follow-up, route to `Debug`, or return to `40-execute` with the exact evidence gap.
|
|
50
50
|
- **Stop Condition**: stop only with a clear verdict: pass, fail, or blocked; include the evidence, residual risks, and next route.
|
|
51
|
-
- **Handoff**: `50-verify.md` must tell `60-report` why the work is ready, or tell `40-
|
|
51
|
+
- **Handoff**: `50-verify.md` must tell `60-report` why the work is ready, or tell `40-execute` exactly what must change before verification resumes.
|
|
52
52
|
|
|
53
53
|
### 1. Context Gathering
|
|
54
54
|
|
|
@@ -56,7 +56,7 @@ Read:
|
|
|
56
56
|
|
|
57
57
|
- `20-spec.md`
|
|
58
58
|
- `30-plan.md`
|
|
59
|
-
- `40-
|
|
59
|
+
- `40-execute.md`
|
|
60
60
|
- `checklists/verification-checklist.md` when present
|
|
61
61
|
- changed files
|
|
62
62
|
- test output, command output, screenshots, or manual-check evidence
|
|
@@ -124,7 +124,7 @@ If pass:
|
|
|
124
124
|
|
|
125
125
|
If fail:
|
|
126
126
|
|
|
127
|
-
- route back to `40-
|
|
127
|
+
- route back to `40-execute` with exact failed evidence, missing checks, or required changes
|
|
128
128
|
|
|
129
129
|
Use `Debug` when investigation is needed before implementation can resume.
|
|
130
130
|
|
|
@@ -134,7 +134,7 @@ Verification is the main human review checkpoint for implemented work.
|
|
|
134
134
|
If the evidence is incomplete or `Approval Status` remains pending:
|
|
135
135
|
|
|
136
136
|
- warn that release is not yet ready for confident handoff
|
|
137
|
-
- recommend additional review or a return to `40-
|
|
137
|
+
- recommend additional review or a return to `40-execute`
|
|
138
138
|
- keep `60-report` as a soft recommendation only
|
|
139
139
|
|
|
140
140
|
## Output
|
|
@@ -146,12 +146,12 @@ Report:
|
|
|
146
146
|
- commands run
|
|
147
147
|
- validation status
|
|
148
148
|
- impact and rollback analysis when `50-verify-impact.md` is present
|
|
149
|
-
- next command: `60-report {ID}` if pass, or `40-
|
|
149
|
+
- next command: `60-report {ID}` if pass, or `40-execute {ID}` if fail
|
|
150
150
|
|
|
151
151
|
## Relationship To DevFlow 2.0
|
|
152
152
|
|
|
153
153
|
- Classification: Mainline workflow
|
|
154
|
-
- Previous state: `40-
|
|
154
|
+
- Previous state: `40-execute`
|
|
155
155
|
- Next state: `60-report` when evidence is sufficient
|
|
156
156
|
- Common companion commands: `Debug`, `Test`, `QA-Orchestrate`, `PR-Review`, `Agent`, `Wiki`
|
|
157
157
|
- Support skills: `review`, `diagnosing-bugs`, `tdd`, and `silent-failure-audit` for focused verification lanes
|
|
@@ -162,11 +162,11 @@ Report:
|
|
|
162
162
|
- `docs/workspace-artifacts.md`
|
|
163
163
|
- `.agent/resources/schemas/verify.template.md`
|
|
164
164
|
- `.agent/resources/schemas/verify-impact.template.md`
|
|
165
|
-
- Related commands: `40-
|
|
165
|
+
- Related commands: `40-execute`, `Debug`, `Test`, `QA-Orchestrate`, `PR-Review`, `Agent`, `60-report`
|
|
166
166
|
|
|
167
167
|
## Next Workflow Recommendation
|
|
168
168
|
|
|
169
|
-
- **Primary**: `60-report {ID}` when verification passes, or `40-
|
|
169
|
+
- **Primary**: `60-report {ID}` when verification passes, or `40-execute {ID}` when verification fails.
|
|
170
170
|
- **Why**: Verification decides whether work moves forward to the final report stage or loops back for fixes.
|
|
171
171
|
- **Alternatives**:
|
|
172
172
|
- `Debug` - choose this when the failure needs root cause analysis before more implementation.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
---
|
|
2
|
-
|
|
3
|
-
description: "[Devflow] Report stage in DevFlow 2.0 - produce standardized markdown
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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 `
|
|
66
|
-
- **Handoff**: `
|
|
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-
|
|
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
|
-
|
|
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`
|
|
152
|
-
-
|
|
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`
|
|
176
|
-
- **
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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 `
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
58
|
+
- **Mainline integration**: Used during `40-execute` (checkpoint commits), `70-release` (final release commit).
|
|
59
59
|
- **Handoff**: `pr`, `merge`, `70-release`
|