@jakkrichm/create-nexus-devflow 2.0.8 → 2.0.10
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/package.json +2 -2
- package/template/.agents/skills/00-discover/SKILL.md +13 -13
- package/template/.agents/skills/10-define/SKILL.md +16 -16
- package/template/.agents/skills/20-spec/SKILL.md +14 -14
- package/template/.agents/skills/30-plan/SKILL.md +13 -13
- package/template/.agents/skills/40-implement/SKILL.md +14 -14
- package/template/.agents/skills/50-verify/SKILL.md +15 -15
- package/template/.agents/skills/60-report/SKILL.md +9 -9
- package/template/.agents/skills/70-release/SKILL.md +13 -13
- package/template/.agents/skills/adopt/SKILL.md +5 -5
- package/template/.agents/skills/agent/SKILL.md +4 -4
- package/template/.agents/skills/api-and-interface-design/SKILL.md +1 -1
- package/template/.agents/skills/app-builder/SKILL.md +1 -1
- package/template/.agents/skills/architecture/SKILL.md +1 -1
- package/template/.agents/skills/autopilot/SKILL.md +175 -0
- package/template/.agents/skills/bash-linux/SKILL.md +1 -1
- package/template/.agents/skills/behavioral-modes/SKILL.md +1 -1
- package/template/.agents/skills/brainstorm/SKILL.md +10 -10
- package/template/.agents/skills/brief/SKILL.md +77 -0
- package/template/.agents/skills/browser-testing-with-devtools/SKILL.md +1 -1
- package/template/.agents/skills/changelog/SKILL.md +4 -4
- package/template/.agents/skills/ci/SKILL.md +131 -0
- package/template/.agents/skills/ci-cd-and-automation/SKILL.md +4 -4
- package/template/.agents/skills/code-review-and-quality/SKILL.md +1 -1
- package/template/.agents/skills/code-simplification/SKILL.md +1 -1
- package/template/.agents/skills/codebase-design/SKILL.md +6 -6
- package/template/.agents/skills/commit/SKILL.md +4 -4
- package/template/.agents/skills/competitor-analysis/SKILL.md +3 -3
- package/template/.agents/skills/context-engineering/SKILL.md +1 -1
- package/template/.agents/skills/database-design/SKILL.md +1 -1
- package/template/.agents/skills/debug/SKILL.md +11 -11
- package/template/.agents/skills/debugging-and-error-recovery/SKILL.md +1 -1
- package/template/.agents/skills/deploy/SKILL.md +4 -4
- package/template/.agents/skills/deployment-procedures/SKILL.md +1 -1
- package/template/.agents/skills/deprecation-and-migration/SKILL.md +1 -1
- package/template/.agents/skills/devflow/SKILL.md +30 -20
- package/template/.agents/skills/diagnosing-bugs/SKILL.md +3 -3
- package/template/.agents/skills/doctor/SKILL.md +4 -4
- package/template/.agents/skills/documentation-and-adrs/SKILL.md +1 -1
- package/template/.agents/skills/domain-modeling/SKILL.md +1 -1
- package/template/.agents/skills/followup/SKILL.md +10 -10
- package/template/.agents/skills/frontend-ui-engineering/SKILL.md +1 -1
- package/template/.agents/skills/git-workflow-and-versioning/SKILL.md +1 -1
- package/template/.agents/skills/goal/SKILL.md +11 -11
- package/template/.agents/skills/handoff/SKILL.md +1 -1
- package/template/.agents/skills/help/SKILL.md +18 -18
- package/template/.agents/skills/human-review-decisions/SKILL.md +6 -6
- package/template/.agents/skills/i18n-localization/SKILL.md +1 -1
- package/template/.agents/skills/idea-refine/SKILL.md +1 -1
- package/template/.agents/skills/incremental-implementation/SKILL.md +1 -1
- package/template/.agents/skills/insight/SKILL.md +8 -8
- package/template/.agents/skills/insight-capture/SKILL.md +4 -4
- package/template/.agents/skills/intelligent-routing/SKILL.md +23 -23
- package/template/.agents/skills/issue-triage/SKILL.md +5 -5
- package/template/.agents/skills/lint-and-validate/SKILL.md +1 -1
- package/template/.agents/skills/mcp-builder/SKILL.md +1 -1
- package/template/.agents/skills/md2html/SKILL.md +1 -1
- package/template/.agents/skills/merge/SKILL.md +5 -5
- package/template/.agents/skills/mobile-design/SKILL.md +1 -1
- package/template/.agents/skills/nextjs-react-expert/SKILL.md +1 -1
- package/template/.agents/skills/nodejs-best-practices/SKILL.md +1 -1
- package/template/.agents/skills/onboard/SKILL.md +8 -8
- package/template/.agents/skills/package-json-generator/SKILL.md +1 -1
- package/template/.agents/skills/parallel-agents/SKILL.md +2 -2
- package/template/.agents/skills/performance-optimization/SKILL.md +1 -1
- package/template/.agents/skills/planning-and-task-breakdown/SKILL.md +2 -2
- package/template/.agents/skills/powershell-windows/SKILL.md +1 -1
- package/template/.agents/skills/pr/SKILL.md +8 -8
- package/template/.agents/skills/pr-review/SKILL.md +7 -7
- package/template/.agents/skills/pr-review-analysis/SKILL.md +3 -3
- package/template/.agents/skills/prd/SKILL.md +11 -11
- package/template/.agents/skills/preview/SKILL.md +8 -8
- package/template/.agents/skills/preview-local-check/SKILL.md +5 -5
- package/template/.agents/skills/prototype/SKILL.md +2 -2
- package/template/.agents/skills/python-patterns/SKILL.md +1 -1
- package/template/.agents/skills/release-git-operations/SKILL.md +6 -6
- package/template/.agents/skills/research/SKILL.md +10 -10
- package/template/.agents/skills/review/SKILL.md +3 -3
- package/template/.agents/skills/review-followup-routing/SKILL.md +4 -4
- package/template/.agents/skills/roadmap-strategy/SKILL.md +4 -4
- package/template/.agents/skills/rollback/SKILL.md +108 -0
- package/template/.agents/skills/security-and-hardening/SKILL.md +1 -1
- package/template/.agents/skills/security-review/SKILL.md +4 -4
- package/template/.agents/skills/seo-fundamentals/SKILL.md +1 -1
- package/template/.agents/skills/server-management/SKILL.md +1 -1
- package/template/.agents/skills/shipping-and-launch/SKILL.md +2 -2
- package/template/.agents/skills/silent-failure-audit/SKILL.md +1 -1
- package/template/.agents/skills/simplify/SKILL.md +7 -7
- package/template/.agents/skills/skill-development/SKILL.md +1 -1
- package/template/.agents/skills/spec-driven-development/SKILL.md +1 -1
- package/template/.agents/skills/spec-orchestration/SKILL.md +6 -6
- package/template/.agents/skills/specialist-agent-routing/SKILL.md +8 -8
- package/template/.agents/skills/tailwind-patterns/SKILL.md +1 -1
- package/template/.agents/skills/test/SKILL.md +4 -4
- package/template/.agents/skills/test-driven-development/SKILL.md +1 -1
- package/template/.agents/skills/test-execution-and-coverage/SKILL.md +5 -5
- package/template/.agents/skills/try/SKILL.md +108 -0
- package/template/.agents/skills/type-design/SKILL.md +1 -1
- package/template/.agents/skills/ui-ux-pro-max/SKILL.md +1 -1
- package/template/.agents/skills/using-agent-skills/SKILL.md +1 -1
- package/template/.agents/skills/verification-orchestration/SKILL.md +4 -4
- package/template/.agents/skills/vulnerability-scanner/SKILL.md +1 -1
- package/template/.agents/skills/wiki/SKILL.md +7 -7
- package/template/.agents/skills/workflow-documentation-sync/SKILL.md +2 -2
- package/template/.claude/skills/00-discover/SKILL.md +13 -13
- package/template/.claude/skills/10-define/SKILL.md +16 -16
- package/template/.claude/skills/20-spec/SKILL.md +14 -14
- package/template/.claude/skills/30-plan/SKILL.md +13 -13
- package/template/.claude/skills/40-implement/SKILL.md +14 -14
- package/template/.claude/skills/50-verify/SKILL.md +15 -15
- package/template/.claude/skills/60-report/SKILL.md +9 -9
- package/template/.claude/skills/70-release/SKILL.md +13 -13
- package/template/.claude/skills/adopt/SKILL.md +5 -5
- package/template/.claude/skills/agent/SKILL.md +4 -4
- package/template/.claude/skills/api-and-interface-design/SKILL.md +1 -1
- package/template/.claude/skills/app-builder/SKILL.md +1 -1
- package/template/.claude/skills/architecture/SKILL.md +1 -1
- package/template/.claude/skills/autopilot/SKILL.md +175 -0
- package/template/.claude/skills/bash-linux/SKILL.md +1 -1
- package/template/.claude/skills/behavioral-modes/SKILL.md +1 -1
- package/template/.claude/skills/brainstorm/SKILL.md +10 -10
- package/template/.claude/skills/brief/SKILL.md +77 -0
- package/template/.claude/skills/browser-testing-with-devtools/SKILL.md +1 -1
- package/template/.claude/skills/changelog/SKILL.md +4 -4
- package/template/.claude/skills/ci/SKILL.md +131 -0
- package/template/.claude/skills/ci-cd-and-automation/SKILL.md +4 -4
- package/template/.claude/skills/code-review-and-quality/SKILL.md +1 -1
- package/template/.claude/skills/code-simplification/SKILL.md +1 -1
- package/template/.claude/skills/codebase-design/SKILL.md +6 -6
- package/template/.claude/skills/commit/SKILL.md +4 -4
- package/template/.claude/skills/competitor-analysis/SKILL.md +3 -3
- package/template/.claude/skills/context-engineering/SKILL.md +1 -1
- package/template/.claude/skills/database-design/SKILL.md +1 -1
- package/template/.claude/skills/debug/SKILL.md +11 -11
- package/template/.claude/skills/debugging-and-error-recovery/SKILL.md +1 -1
- package/template/.claude/skills/deploy/SKILL.md +4 -4
- package/template/.claude/skills/deployment-procedures/SKILL.md +1 -1
- package/template/.claude/skills/deprecation-and-migration/SKILL.md +1 -1
- package/template/.claude/skills/devflow/SKILL.md +30 -20
- package/template/.claude/skills/diagnosing-bugs/SKILL.md +3 -3
- package/template/.claude/skills/doctor/SKILL.md +4 -4
- package/template/.claude/skills/documentation-and-adrs/SKILL.md +1 -1
- package/template/.claude/skills/domain-modeling/SKILL.md +1 -1
- package/template/.claude/skills/followup/SKILL.md +10 -10
- package/template/.claude/skills/frontend-ui-engineering/SKILL.md +1 -1
- package/template/.claude/skills/git-workflow-and-versioning/SKILL.md +1 -1
- package/template/.claude/skills/goal/SKILL.md +11 -11
- package/template/.claude/skills/handoff/SKILL.md +1 -1
- package/template/.claude/skills/help/SKILL.md +18 -18
- package/template/.claude/skills/human-review-decisions/SKILL.md +6 -6
- package/template/.claude/skills/i18n-localization/SKILL.md +1 -1
- package/template/.claude/skills/idea-refine/SKILL.md +1 -1
- package/template/.claude/skills/incremental-implementation/SKILL.md +1 -1
- package/template/.claude/skills/insight/SKILL.md +8 -8
- package/template/.claude/skills/insight-capture/SKILL.md +4 -4
- package/template/.claude/skills/intelligent-routing/SKILL.md +23 -23
- package/template/.claude/skills/issue-triage/SKILL.md +5 -5
- package/template/.claude/skills/lint-and-validate/SKILL.md +1 -1
- package/template/.claude/skills/mcp-builder/SKILL.md +1 -1
- package/template/.claude/skills/md2html/SKILL.md +1 -1
- package/template/.claude/skills/merge/SKILL.md +5 -5
- package/template/.claude/skills/mobile-design/SKILL.md +1 -1
- package/template/.claude/skills/nextjs-react-expert/SKILL.md +1 -1
- package/template/.claude/skills/nodejs-best-practices/SKILL.md +1 -1
- package/template/.claude/skills/onboard/SKILL.md +8 -8
- package/template/.claude/skills/package-json-generator/SKILL.md +1 -1
- package/template/.claude/skills/parallel-agents/SKILL.md +2 -2
- package/template/.claude/skills/performance-optimization/SKILL.md +1 -1
- package/template/.claude/skills/planning-and-task-breakdown/SKILL.md +2 -2
- package/template/.claude/skills/powershell-windows/SKILL.md +1 -1
- package/template/.claude/skills/pr/SKILL.md +8 -8
- package/template/.claude/skills/pr-review/SKILL.md +7 -7
- package/template/.claude/skills/pr-review-analysis/SKILL.md +3 -3
- package/template/.claude/skills/prd/SKILL.md +11 -11
- package/template/.claude/skills/preview/SKILL.md +8 -8
- package/template/.claude/skills/preview-local-check/SKILL.md +5 -5
- package/template/.claude/skills/prototype/SKILL.md +2 -2
- package/template/.claude/skills/python-patterns/SKILL.md +1 -1
- package/template/.claude/skills/release-git-operations/SKILL.md +6 -6
- package/template/.claude/skills/research/SKILL.md +10 -10
- package/template/.claude/skills/review/SKILL.md +3 -3
- package/template/.claude/skills/review-followup-routing/SKILL.md +4 -4
- package/template/.claude/skills/roadmap-strategy/SKILL.md +4 -4
- package/template/.claude/skills/rollback/SKILL.md +108 -0
- package/template/.claude/skills/security-and-hardening/SKILL.md +1 -1
- package/template/.claude/skills/security-review/SKILL.md +4 -4
- package/template/.claude/skills/seo-fundamentals/SKILL.md +1 -1
- package/template/.claude/skills/server-management/SKILL.md +1 -1
- package/template/.claude/skills/shipping-and-launch/SKILL.md +2 -2
- package/template/.claude/skills/silent-failure-audit/SKILL.md +1 -1
- package/template/.claude/skills/simplify/SKILL.md +7 -7
- package/template/.claude/skills/skill-development/SKILL.md +1 -1
- package/template/.claude/skills/spec-driven-development/SKILL.md +1 -1
- package/template/.claude/skills/spec-orchestration/SKILL.md +6 -6
- package/template/.claude/skills/specialist-agent-routing/SKILL.md +8 -8
- package/template/.claude/skills/tailwind-patterns/SKILL.md +1 -1
- package/template/.claude/skills/test/SKILL.md +4 -4
- package/template/.claude/skills/test-driven-development/SKILL.md +1 -1
- package/template/.claude/skills/test-execution-and-coverage/SKILL.md +5 -5
- package/template/.claude/skills/try/SKILL.md +108 -0
- package/template/.claude/skills/type-design/SKILL.md +1 -1
- package/template/.claude/skills/ui-ux-pro-max/SKILL.md +1 -1
- package/template/.claude/skills/using-agent-skills/SKILL.md +1 -1
- package/template/.claude/skills/verification-orchestration/SKILL.md +4 -4
- package/template/.claude/skills/vulnerability-scanner/SKILL.md +1 -1
- package/template/.claude/skills/wiki/SKILL.md +7 -7
- package/template/.claude/skills/workflow-documentation-sync/SKILL.md +2 -2
- package/template/AGENTS.md +44 -28
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@jakkrichm/create-nexus-devflow",
|
|
3
|
-
"version": "2.0.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "2.0.10",
|
|
4
|
+
"description": "Installer package for Nexus-DevFlow agentic workflow layer.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "Jakkrich",
|
|
7
7
|
"homepage": "https://github.com/Jakkrich/nexus-devflow#readme",
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---name: 00-discover
|
|
2
2
|
|
|
3
|
-
description: Discover stage in DevFlow 2.0 - explore a request, route supporting inquiry, and decide whether delivery work should begin without allocating a running ID.
|
|
3
|
+
description: "[Devflow] Discover stage in DevFlow 2.0 - explore a request, route supporting inquiry, and decide whether delivery work should begin without allocating a running ID."
|
|
4
4
|
argument-hint: "{title, request, or discovery-id}"
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -13,8 +13,8 @@ Explore a request before delivery commitment. Create or resume a Discovery ID, c
|
|
|
13
13
|
## Usage
|
|
14
14
|
|
|
15
15
|
```text
|
|
16
|
-
|
|
17
|
-
|
|
16
|
+
00-discover {title or request}
|
|
17
|
+
00-discover {discovery-id}
|
|
18
18
|
```
|
|
19
19
|
|
|
20
20
|
Use this when:
|
|
@@ -28,7 +28,7 @@ Use this when:
|
|
|
28
28
|
Write the primary discovery artifact to:
|
|
29
29
|
|
|
30
30
|
```text
|
|
31
|
-
devflow/discoveries/{DISCOVERY_ID}-{slug}
|
|
31
|
+
devflow/discoveries/{DISCOVERY_ID}-{slug}00-discover.md
|
|
32
32
|
```
|
|
33
33
|
|
|
34
34
|
using:
|
|
@@ -65,7 +65,7 @@ Run discovery as a decision-and-routing loop, not as task initialization.
|
|
|
65
65
|
- **Observation**: use concrete evidence such as option tradeoffs, product framing, research results, root cause, stakeholder constraints, open questions, and visible risk.
|
|
66
66
|
- **Adjustment**: invoke only the companion route needed to resolve the current uncertainty; every companion invoked by Discover must return to this Discovery ID for synthesis.
|
|
67
67
|
- **Stop Condition**: stop when the selected route and evidence are recorded, open questions are visible, and the decision is `Proceed`, `Defer`, or `Reject`.
|
|
68
|
-
- **Handoff**: only an approved `Proceed` discovery may hand off to
|
|
68
|
+
- **Handoff**: only an approved `Proceed` discovery may hand off to `10-define {discovery_id}`. `Defer` and `Reject` end without allocating a Running ID.
|
|
69
69
|
|
|
70
70
|
### 1. Create Or Resume The Discovery
|
|
71
71
|
|
|
@@ -99,7 +99,7 @@ After each companion route:
|
|
|
99
99
|
|
|
100
100
|
- update `00-discover.md` with the durable findings and source path
|
|
101
101
|
- reassess whether another route is materially necessary
|
|
102
|
-
- return to the Discover decision rather than jumping directly to
|
|
102
|
+
- return to the Discover decision rather than jumping directly to `10-define`
|
|
103
103
|
|
|
104
104
|
### 5. Decide
|
|
105
105
|
|
|
@@ -109,7 +109,7 @@ Set one decision:
|
|
|
109
109
|
- `Defer`: the idea remains relevant but timing, evidence, or ownership is not ready
|
|
110
110
|
- `Reject`: the idea should not proceed under the current framing
|
|
111
111
|
|
|
112
|
-
Candidate delivery slices may be suggested, but they remain provisional and unnumbered until
|
|
112
|
+
Candidate delivery slices may be suggested, but they remain provisional and unnumbered until `10-define`.
|
|
113
113
|
|
|
114
114
|
### 6. Write `00-discover.md`
|
|
115
115
|
|
|
@@ -117,11 +117,11 @@ Candidate delivery slices may be suggested, but they remain provisional and unnu
|
|
|
117
117
|
- follow the configured `artifact_language`
|
|
118
118
|
- replace placeholders with concrete context
|
|
119
119
|
- record selected routes, returned findings, open questions, decision, and rationale
|
|
120
|
-
- keep `related_runs` empty until
|
|
120
|
+
- keep `related_runs` empty until `10-define` materializes approved slices
|
|
121
121
|
|
|
122
122
|
### 7. Manual Review Gate
|
|
123
123
|
|
|
124
|
-
Before
|
|
124
|
+
Before `10-define`:
|
|
125
125
|
|
|
126
126
|
- confirm the selected route and evidence are sufficient
|
|
127
127
|
- confirm the decision is `Proceed`
|
|
@@ -138,15 +138,15 @@ Report:
|
|
|
138
138
|
- selected support route and why
|
|
139
139
|
- important findings and open questions
|
|
140
140
|
- `Proceed`, `Defer`, or `Reject` decision
|
|
141
|
-
- recommended next step, including
|
|
141
|
+
- recommended next step, including `10-define {discovery_id}` only when Proceed is approved
|
|
142
142
|
|
|
143
143
|
## Relationship To DevFlow 2.0
|
|
144
144
|
|
|
145
145
|
- Classification: Mainline discovery stage
|
|
146
146
|
- Previous state: request intake
|
|
147
|
-
- Next state:
|
|
147
|
+
- Next state: `10-define {discovery_id}` only after approved Proceed
|
|
148
148
|
- Common companion routes: `Brainstorm`, `PRD`, `Research`, `Debug`
|
|
149
|
-
- Running ID lifecycle: begins in
|
|
149
|
+
- Running ID lifecycle: begins in `10-define`, not in Discover
|
|
150
150
|
|
|
151
151
|
## Sources
|
|
152
152
|
|
|
@@ -156,7 +156,7 @@ Report:
|
|
|
156
156
|
|
|
157
157
|
## Next Workflow Recommendation
|
|
158
158
|
|
|
159
|
-
- **Primary**: the selected companion route, or
|
|
159
|
+
- **Primary**: the selected companion route, or `10-define {discovery_id}` after approved Proceed
|
|
160
160
|
- **Alternatives**:
|
|
161
161
|
- `Brainstorm {discovery_id}` for unresolved options
|
|
162
162
|
- `PRD {discovery_id}` for product framing
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---name: 10-define
|
|
2
2
|
|
|
3
|
-
description: Define stage in DevFlow 2.0 - turn an approved discovery into one or more bounded delivery runs with stable scope.
|
|
3
|
+
description: "[Devflow] Define stage in DevFlow 2.0 - turn an approved discovery into one or more bounded delivery runs with stable scope."
|
|
4
4
|
argument-hint: "{approved discovery-id, discovery path, running-id, or run path}"
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -13,8 +13,8 @@ Convert an approved `Proceed` discovery into bounded delivery slices. Allocate o
|
|
|
13
13
|
## Usage
|
|
14
14
|
|
|
15
15
|
```text
|
|
16
|
-
|
|
17
|
-
|
|
16
|
+
10-define {discovery-id or discovery path}
|
|
17
|
+
10-define {running-id or run path}
|
|
18
18
|
```
|
|
19
19
|
|
|
20
20
|
Use a Discovery ID to materialize new delivery runs. Use an existing Running ID only to revise or split a definition that already exists.
|
|
@@ -24,7 +24,7 @@ Use a Discovery ID to materialize new delivery runs. Use an existing Running ID
|
|
|
24
24
|
For every approved delivery slice, write:
|
|
25
25
|
|
|
26
26
|
```text
|
|
27
|
-
devflow/runs/{ID}-{slug}
|
|
27
|
+
devflow/runs/{ID}-{slug}10-define.md
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
using:
|
|
@@ -57,8 +57,8 @@ Run definition as a scope-stabilization and run-allocation loop.
|
|
|
57
57
|
- **Context**: read the approved `00-discover.md`, linked Brainstorm/PRD/Research/Debug outputs, project-wide rules, existing run IDs, and dependencies between candidate slices.
|
|
58
58
|
- **Action**: lock initiative and scope boundaries, decompose delivery slices, review the run map, allocate collision-free Running IDs, and write one `10-define.md` per slice.
|
|
59
59
|
- **Observation**: use independent acceptance boundaries, release boundaries, ownership, dependencies, context size, cross-domain coupling, and reviewability as evidence for splitting or combining slices.
|
|
60
|
-
- **Adjustment**: merge slices that are only implementation tasks; split slices that require separate specs, releases, ownership, or large independent context; return to
|
|
61
|
-
- **Stop Condition**: stop when the run map is approved, IDs are materialized without collision, each run has stable in/out scope, and every generated run can proceed independently to
|
|
60
|
+
- **Adjustment**: merge slices that are only implementation tasks; split slices that require separate specs, releases, ownership, or large independent context; return to `00-discover` if the decision or product direction is still unstable.
|
|
61
|
+
- **Stop Condition**: stop when the run map is approved, IDs are materialized without collision, each run has stable in/out scope, and every generated run can proceed independently to `20-spec {running_id}`.
|
|
62
62
|
- **Handoff**: each `10-define.md` must identify its source Discovery ID, sibling runs, dependencies, scope, non-goals, and exact next command.
|
|
63
63
|
|
|
64
64
|
### 1. Validate The Discovery Gate
|
|
@@ -69,7 +69,7 @@ For new delivery work, require:
|
|
|
69
69
|
- `Approval Status: Approved`
|
|
70
70
|
- a resolvable Discovery ID and `00-discover.md`
|
|
71
71
|
|
|
72
|
-
If either gate is missing, do not create a Running ID. Return to
|
|
72
|
+
If either gate is missing, do not create a Running ID. Return to `00-discover {discovery_id}`.
|
|
73
73
|
|
|
74
74
|
### 2. Build The Delivery Run Map
|
|
75
75
|
|
|
@@ -83,7 +83,7 @@ Create separate runs when work has materially independent:
|
|
|
83
83
|
- dependency sequencing
|
|
84
84
|
- implementation context large enough to threaten reliable planning or review
|
|
85
85
|
|
|
86
|
-
Keep ordinary subtasks inside
|
|
86
|
+
Keep ordinary subtasks inside `30-plan` and checklists.
|
|
87
87
|
|
|
88
88
|
For every slice record:
|
|
89
89
|
|
|
@@ -126,11 +126,11 @@ If an existing definition is too broad:
|
|
|
126
126
|
- preserve traceability to the original run and discovery
|
|
127
127
|
- allocate new IDs only after approval
|
|
128
128
|
- mark the old definition as `Superseded` and list its replacement runs
|
|
129
|
-
- do not silently fork scope during
|
|
129
|
+
- do not silently fork scope during `20-spec`
|
|
130
130
|
|
|
131
131
|
### 7. Manual Review Gate
|
|
132
132
|
|
|
133
|
-
Before recommending
|
|
133
|
+
Before recommending `20-spec`, confirm each generated definition independently. Approval of one run must not imply approval of every sibling run.
|
|
134
134
|
|
|
135
135
|
## Output
|
|
136
136
|
|
|
@@ -141,13 +141,13 @@ Report:
|
|
|
141
141
|
- workspace path for every generated run
|
|
142
142
|
- scope and dependency summary per run
|
|
143
143
|
- any superseded run
|
|
144
|
-
- exact
|
|
144
|
+
- exact `20-spec {running_id}` commands for approved runs
|
|
145
145
|
|
|
146
146
|
## Relationship To DevFlow 2.0
|
|
147
147
|
|
|
148
148
|
- Classification: Mainline workflow and Running ID creation boundary
|
|
149
|
-
- Previous state: approved
|
|
150
|
-
- Next state:
|
|
149
|
+
- Previous state: approved `00-discover`
|
|
150
|
+
- Next state: `20-spec {running_id}` per generated run
|
|
151
151
|
- Running ID lifecycle: starts here
|
|
152
152
|
|
|
153
153
|
## Sources
|
|
@@ -158,13 +158,13 @@ Report:
|
|
|
158
158
|
|
|
159
159
|
## Next Workflow Recommendation
|
|
160
160
|
|
|
161
|
-
- **Primary**:
|
|
161
|
+
- **Primary**: `20-spec {running_id}` for each approved run
|
|
162
162
|
- **Alternatives**:
|
|
163
|
-
-
|
|
163
|
+
- `00-discover {discovery_id}` when the go/no-go decision or direction is unstable
|
|
164
164
|
- `Research {discovery_id}` when evidence still blocks a reliable split
|
|
165
165
|
- `grill-with-docs` when boundaries or terminology remain ambiguous
|
|
166
166
|
|
|
167
167
|
## Nexus Event
|
|
168
168
|
|
|
169
169
|
- Use `domain-modeling` when sibling runs need shared language or durable architectural decisions.
|
|
170
|
-
- Use `planning-and-task-breakdown` only after the delivery boundary is stable; small tasks belong in
|
|
170
|
+
- Use `planning-and-task-breakdown` only after the delivery boundary is stable; small tasks belong in `30-plan`, not separate Running IDs.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---name: 20-spec
|
|
2
2
|
|
|
3
|
-
description: Spec stage in DevFlow 2.0 - write the formal markdown-first specification from a stable definition.
|
|
3
|
+
description: "[Devflow] Spec stage in DevFlow 2.0 - write the formal markdown-first specification from a stable definition."
|
|
4
4
|
argument-hint: "{running-id or workspace path}"
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -13,7 +13,7 @@ Turn the defined work into a specification that is concrete enough for planning
|
|
|
13
13
|
## Usage
|
|
14
14
|
|
|
15
15
|
```text
|
|
16
|
-
|
|
16
|
+
20-spec {running-id or workspace path}
|
|
17
17
|
```
|
|
18
18
|
|
|
19
19
|
Use this when:
|
|
@@ -27,7 +27,7 @@ Use this when:
|
|
|
27
27
|
Write the primary stage artifact to:
|
|
28
28
|
|
|
29
29
|
```text
|
|
30
|
-
devflow/runs/{ID}-{slug}
|
|
30
|
+
devflow/runs/{ID}-{slug}20-spec.md
|
|
31
31
|
```
|
|
32
32
|
|
|
33
33
|
using:
|
|
@@ -60,9 +60,9 @@ Run specification as a contract-hardening loop, not as a prose expansion of the
|
|
|
60
60
|
- **Context**: read the run's `10-define.md`, follow its `source_discovery` link when original framing matters, and read relevant research, hard constraints, and domain or codebase decisions that shape this run's delivery contract.
|
|
61
61
|
- **Action**: write requirements, acceptance criteria, constraints, and out-of-scope items, then inspect whether each requirement is testable and unambiguous.
|
|
62
62
|
- **Observation**: use concrete evidence such as ambiguous wording, unchecked assumptions, edge cases, missing acceptance criteria, conflicting constraints, and implementation details that are not true constraints.
|
|
63
|
-
- **Adjustment**: if facts are missing, route to `Research`; if requirements need stress-testing, use `grill-with-docs`; if module or interface boundaries affect the contract, use `codebase-design`; if scope is unstable or still contains multiple independently deliverable contracts, return to
|
|
64
|
-
- **Stop Condition**: stop when every requirement has checkable acceptance criteria, hard constraints are explicit, out-of-scope items are visible, and
|
|
65
|
-
- **Handoff**: `20-spec.md` must tell
|
|
63
|
+
- **Adjustment**: if facts are missing, route to `Research`; if requirements need stress-testing, use `grill-with-docs`; if module or interface boundaries affect the contract, use `codebase-design`; if scope is unstable or still contains multiple independently deliverable contracts, return to `10-define` and split the run before continuing.
|
|
64
|
+
- **Stop Condition**: stop when every requirement has checkable acceptance criteria, hard constraints are explicit, out-of-scope items are visible, and `30-plan` can break the work down without inventing intent.
|
|
65
|
+
- **Handoff**: `20-spec.md` must tell `30-plan` what must be delivered, how success will be checked, what constraints cannot move, and what is intentionally excluded.
|
|
66
66
|
|
|
67
67
|
### 1. Read Definition Artifacts
|
|
68
68
|
|
|
@@ -94,7 +94,7 @@ If the spec cannot be written confidently:
|
|
|
94
94
|
|
|
95
95
|
Do not hide uncertainty inside vague requirement text.
|
|
96
96
|
|
|
97
|
-
Do not combine sibling Running IDs into one spec. If this run still contains multiple independent acceptance, release, ownership, or context boundaries, stop and return to
|
|
97
|
+
Do not combine sibling Running IDs into one spec. If this run still contains multiple independent acceptance, release, ownership, or context boundaries, stop and return to `10-define {running_id}` for an explicit split.
|
|
98
98
|
|
|
99
99
|
### 4. Finalize `20-spec.md`
|
|
100
100
|
|
|
@@ -106,12 +106,12 @@ Do not combine sibling Running IDs into one spec. If this run still contains mul
|
|
|
106
106
|
|
|
107
107
|
### 5. Manual Review Soft Gate
|
|
108
108
|
|
|
109
|
-
Before recommending
|
|
109
|
+
Before recommending `30-plan`, check whether the delivery contract has been human-reviewed.
|
|
110
110
|
If `Approval Status` is not approved yet:
|
|
111
111
|
|
|
112
112
|
- warn that planning may drift if the spec is still under review
|
|
113
113
|
- recommend review of requirements, exclusions, and acceptance criteria first
|
|
114
|
-
- keep
|
|
114
|
+
- keep `30-plan` as a soft recommendation only
|
|
115
115
|
|
|
116
116
|
## Output
|
|
117
117
|
|
|
@@ -127,8 +127,8 @@ Report:
|
|
|
127
127
|
## Relationship To DevFlow 2.0
|
|
128
128
|
|
|
129
129
|
- Classification: Mainline workflow
|
|
130
|
-
- Previous state:
|
|
131
|
-
- Next state:
|
|
130
|
+
- Previous state: `10-define`
|
|
131
|
+
- Next state: `30-plan` when the contract is implementation-ready
|
|
132
132
|
- Common companion commands: `PRD`, `Spec-Research`, `Competitor`, `Spec-Orchestrate` when product or integration context is still incomplete; support skills: `grill-with-docs`, `domain-modeling`, and `codebase-design` when the spec depends on precise domain language, durable decisions, or module/interface constraints
|
|
133
133
|
|
|
134
134
|
## Sources
|
|
@@ -136,17 +136,17 @@ Report:
|
|
|
136
136
|
- `AGENTS.md`
|
|
137
137
|
- `docs/workspace-artifacts.md`
|
|
138
138
|
- `.agent/resources/schemas/spec.template.md`
|
|
139
|
-
- Related commands:
|
|
139
|
+
- Related commands: `10-define`, `PRD`, `Spec-Research`, `Competitor`, `Spec-Orchestrate`, `30-plan`
|
|
140
140
|
|
|
141
141
|
## Next Workflow Recommendation
|
|
142
142
|
|
|
143
|
-
- **Primary**:
|
|
143
|
+
- **Primary**: `30-plan`
|
|
144
144
|
- **Why**: The specification is now concrete enough to break into executable work.
|
|
145
145
|
- **Alternatives**:
|
|
146
146
|
- `Research` - choose this when the spec still depends on missing facts.
|
|
147
147
|
- `grill-with-docs` - choose this when the spec is readable but not yet tough enough to plan from.
|
|
148
148
|
- `codebase-design` - choose this when interface shape or testability constraints must be settled before planning.
|
|
149
|
-
-
|
|
149
|
+
- `10-define` - choose this when the scope itself is still unstable.
|
|
150
150
|
|
|
151
151
|
## Nexus Event
|
|
152
152
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---name: 30-plan
|
|
2
2
|
|
|
3
|
-
description: Plan
|
|
3
|
+
description: "[Devflow] Plan stage in DevFlow 2.0 - transform 20-spec.md into an executable task breakdown with test decisions."
|
|
4
4
|
---
|
|
5
5
|
# Phase 30: Plan Implementation
|
|
6
6
|
|
|
@@ -11,7 +11,7 @@ Create a codebase-informed implementation plan using `30-plan.md` as the primary
|
|
|
11
11
|
## Usage
|
|
12
12
|
|
|
13
13
|
```text
|
|
14
|
-
|
|
14
|
+
30-plan {ID}
|
|
15
15
|
```
|
|
16
16
|
|
|
17
17
|
## Markdown-First Contract
|
|
@@ -46,15 +46,15 @@ Run planning as an evidence loop, not as a one-shot outline.
|
|
|
46
46
|
- **Context**: read the spec, prior stage artifacts, relevant code/docs, existing commands, and any research that constrains execution.
|
|
47
47
|
- **Action**: draft the smallest useful plan, then inspect whether every phase has files, dependencies, risks, verification, and a test decision.
|
|
48
48
|
- **Observation**: use concrete evidence such as file paths, existing patterns, package scripts, validation commands, and unresolved assumptions.
|
|
49
|
-
- **Adjustment**: if evidence is missing, search/read more, recommend `Research` or `Agent codebase-explorer`, split the work, or route back to
|
|
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
|
|
51
|
+
- **Handoff**: `30-plan.md` must give `40-implement` enough context to select one scoped unit and execute it without inventing intent.
|
|
52
52
|
|
|
53
53
|
### 1. Read Task Artifacts
|
|
54
54
|
|
|
55
55
|
Read:
|
|
56
56
|
|
|
57
|
-
- `devflow/runs/{ID}
|
|
57
|
+
- `devflow/runs/{ID}-*20-spec.md`
|
|
58
58
|
- `10-define.md` and the shared `00-discover.md` referenced by `source_discovery` when they help clarify intent
|
|
59
59
|
|
|
60
60
|
### 2. Assess Complexity
|
|
@@ -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
|
|
164
|
+
Before recommending `40-implement`, 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
|
|
169
|
+
- keep `40-implement` as a soft recommendation only
|
|
170
170
|
|
|
171
171
|
## Output Checklist
|
|
172
172
|
|
|
@@ -183,8 +183,8 @@ If `Approval Status` is still pending or major dependencies remain unresolved:
|
|
|
183
183
|
## Relationship To DevFlow 2.0
|
|
184
184
|
|
|
185
185
|
- Classification: Mainline workflow
|
|
186
|
-
- Previous state:
|
|
187
|
-
- Next state:
|
|
186
|
+
- Previous state: `20-spec`
|
|
187
|
+
- Next state: `40-implement` 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,18 +192,18 @@ 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:
|
|
195
|
+
- Related commands: `20-spec`, `Research`, `Agent`, `40-implement`
|
|
196
196
|
|
|
197
197
|
## Next Workflow Recommendation
|
|
198
198
|
|
|
199
|
-
- **Primary**:
|
|
199
|
+
- **Primary**: `40-implement {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.
|
|
203
203
|
- `Agent codebase-explorer devflow/runs/{ID}-*/` - choose this when architecture or data flow is unclear.
|
|
204
204
|
- `grill-with-docs` - choose this when plan assumptions or design boundaries need one last adversarial pass.
|
|
205
205
|
- `codebase-design` - choose this when a plan needs clearer seams, interfaces, or test surfaces.
|
|
206
|
-
-
|
|
206
|
+
- `20-spec {ID}` - choose this when the spec itself is not strong enough for planning.
|
|
207
207
|
|
|
208
208
|
## Nexus Event
|
|
209
209
|
|
|
@@ -216,6 +216,6 @@ If `Approval Status` is still pending or major dependencies remain unresolved:
|
|
|
216
216
|
- **Needed**: `yes` when planning records a reusable architecture decision, project pattern, or context-loading lesson.
|
|
217
217
|
- **Scope**: `project` unless the planning lesson changes DevFlow framework behavior.
|
|
218
218
|
- **Reason**: Plans often discover stable patterns that future sessions should reuse.
|
|
219
|
-
- **Suggested Command**: `Wiki project ingest devflow/runs/{ID}
|
|
219
|
+
- **Suggested Command**: `Wiki project ingest devflow/runs/{ID}-*30-plan.md`
|
|
220
220
|
|
|
221
221
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---name: 40-implement
|
|
2
2
|
|
|
3
|
-
description: Implement
|
|
3
|
+
description: "[Devflow] Implement stage in DevFlow 2.0 - execute planned tasks incrementally with evidence and unit tests."
|
|
4
4
|
---
|
|
5
5
|
# Phase 40: Implement Code
|
|
6
6
|
|
|
@@ -9,7 +9,7 @@ Implement the approved plan incrementally. Source code edits are allowed in this
|
|
|
9
9
|
## Usage
|
|
10
10
|
|
|
11
11
|
```text
|
|
12
|
-
|
|
12
|
+
40-implement {ID}
|
|
13
13
|
```
|
|
14
14
|
|
|
15
15
|
## Markdown-First Contract
|
|
@@ -43,9 +43,9 @@ Run implementation as scoped execution loops, one unit at a time.
|
|
|
43
43
|
- **Context**: read `30-plan.md`, `20-spec.md`, relevant checklist items, target files, pattern files, and test decisions before editing.
|
|
44
44
|
- **Action**: make the smallest useful change for the current unit, update or create tests when required, run the planned verification, and record the result.
|
|
45
45
|
- **Observation**: inspect concrete evidence from diffs, command output, tests, manual checks, and checklist status before claiming progress.
|
|
46
|
-
- **Adjustment**: if evidence does not match intent, fix within the current unit, capture the blocker, use `Debug`, or return to
|
|
46
|
+
- **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
47
|
- **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-implement.md` must tell
|
|
48
|
+
- **Handoff**: `40-implement.md` must tell `50-verify` what changed, why it changed, which checks ran, what failed or was skipped, and what residual risk remains.
|
|
49
49
|
|
|
50
50
|
### 1. Get Bearings
|
|
51
51
|
|
|
@@ -112,8 +112,8 @@ If the plan was not clearly approved, warn that implementation proceeded under r
|
|
|
112
112
|
When finishing `40-implement.md`:
|
|
113
113
|
|
|
114
114
|
- record any deviation from the approved plan explicitly
|
|
115
|
-
- set reviewer expectations before
|
|
116
|
-
- keep
|
|
115
|
+
- set reviewer expectations before `50-verify`
|
|
116
|
+
- keep `50-verify` as the next soft recommendation rather than an unconditional jump
|
|
117
117
|
|
|
118
118
|
## Output
|
|
119
119
|
|
|
@@ -125,13 +125,13 @@ Report:
|
|
|
125
125
|
- test decisions followed or changed, with reasons
|
|
126
126
|
- loop evidence and handoff notes for Verify
|
|
127
127
|
- blocked items or manual checks
|
|
128
|
-
- next command:
|
|
128
|
+
- next command: `50-verify {ID}`
|
|
129
129
|
|
|
130
130
|
## Relationship To DevFlow 2.0
|
|
131
131
|
|
|
132
132
|
- Classification: Mainline workflow
|
|
133
|
-
- Previous state:
|
|
134
|
-
- Next state:
|
|
133
|
+
- Previous state: `30-plan`
|
|
134
|
+
- Next state: `50-verify` when scoped implementation is complete
|
|
135
135
|
- 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
136
|
|
|
137
137
|
## Sources
|
|
@@ -139,15 +139,15 @@ Report:
|
|
|
139
139
|
- `AGENTS.md`
|
|
140
140
|
- `docs/workspace-artifacts.md`
|
|
141
141
|
- `.agent/resources/schemas/implement.template.md`
|
|
142
|
-
- Related commands:
|
|
142
|
+
- Related commands: `30-plan`, `Debug`, `Preview`, `50-verify`
|
|
143
143
|
|
|
144
144
|
## Next Workflow Recommendation
|
|
145
145
|
|
|
146
|
-
- **Primary**:
|
|
146
|
+
- **Primary**: `50-verify {ID}` when the planned work is complete.
|
|
147
147
|
- **Why**: Implementation needs independent verification before release or human acceptance.
|
|
148
148
|
- **Alternatives**:
|
|
149
149
|
- `Debug "{blocker}"` - choose this when implementation is blocked by an unexplained failure.
|
|
150
|
-
-
|
|
150
|
+
- `30-plan {ID}` - choose this when the plan is incomplete or no longer matches the work.
|
|
151
151
|
- `Preview` - choose this when a local runtime or visual check is useful before formal verification.
|
|
152
152
|
- `codebase-design` - choose this when the implementation cannot be tested cleanly because the module shape is wrong.
|
|
153
153
|
|
|
@@ -155,12 +155,12 @@ Report:
|
|
|
155
155
|
|
|
156
156
|
- Use `Debug` when the conversation reveals an unexplained blocker, flaky behavior, or root-cause gap.
|
|
157
157
|
- Use `Preview` when a runtime, UI, or local interaction check would reduce verification risk.
|
|
158
|
-
- Return to
|
|
158
|
+
- Return to `30-plan` when implementation drift shows the plan no longer matches reality.
|
|
159
159
|
|
|
160
160
|
## Wiki Update Recommendation
|
|
161
161
|
|
|
162
162
|
- **Needed**: `yes` when coding discovers a reusable implementation pattern, gotcha, or context optimization.
|
|
163
163
|
- **Scope**: `project` unless the discovery is about DevFlow itself.
|
|
164
164
|
- **Reason**: Coding findings are useful only when they are stable enough to help future tasks.
|
|
165
|
-
- **Suggested Command**: `Wiki project ingest devflow/runs/{ID}
|
|
165
|
+
- **Suggested Command**: `Wiki project ingest devflow/runs/{ID}-*40-implement.md`
|
|
166
166
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---name: 50-verify
|
|
2
2
|
|
|
3
|
-
description: Verify
|
|
3
|
+
description: "[Devflow] Verify stage in DevFlow 2.0 - perform senior QA review, record evidence, and decide pass or return-to-implement."
|
|
4
4
|
---
|
|
5
5
|
# Phase 50: Verify Quality
|
|
6
6
|
|
|
@@ -9,7 +9,7 @@ Review implementation quality, run validation, produce a verification report, an
|
|
|
9
9
|
## Usage
|
|
10
10
|
|
|
11
11
|
```text
|
|
12
|
-
|
|
12
|
+
50-verify {ID}
|
|
13
13
|
```
|
|
14
14
|
|
|
15
15
|
## Markdown-First Contract
|
|
@@ -46,9 +46,9 @@ Run verification as an evidence review loop, not as a single pass/fail guess.
|
|
|
46
46
|
- **Context**: read `20-spec.md`, `30-plan.md`, `40-implement.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
|
|
49
|
+
- **Adjustment**: if evidence is missing or failing, request targeted implementation follow-up, route to `Debug`, or return to `40-implement` 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
|
|
51
|
+
- **Handoff**: `50-verify.md` must tell `60-report` why the work is ready, or tell `40-implement` exactly what must change before verification resumes.
|
|
52
52
|
|
|
53
53
|
### 1. Context Gathering
|
|
54
54
|
|
|
@@ -120,11 +120,11 @@ Include:
|
|
|
120
120
|
|
|
121
121
|
If pass:
|
|
122
122
|
|
|
123
|
-
- route to
|
|
123
|
+
- route to `60-report`
|
|
124
124
|
|
|
125
125
|
If fail:
|
|
126
126
|
|
|
127
|
-
- route back to
|
|
127
|
+
- route back to `40-implement` 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,8 +134,8 @@ 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
|
|
138
|
-
- keep
|
|
137
|
+
- recommend additional review or a return to `40-implement`
|
|
138
|
+
- keep `60-report` as a soft recommendation only
|
|
139
139
|
|
|
140
140
|
## Output
|
|
141
141
|
|
|
@@ -146,13 +146,13 @@ 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:
|
|
149
|
+
- next command: `60-report {ID}` if pass, or `40-implement {ID}` if fail
|
|
150
150
|
|
|
151
151
|
## Relationship To DevFlow 2.0
|
|
152
152
|
|
|
153
153
|
- Classification: Mainline workflow
|
|
154
|
-
- Previous state:
|
|
155
|
-
- Next state:
|
|
154
|
+
- Previous state: `40-implement`
|
|
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
|
|
158
158
|
|
|
@@ -162,16 +162,16 @@ 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:
|
|
165
|
+
- Related commands: `40-implement`, `Debug`, `Test`, `QA-Orchestrate`, `PR-Review`, `Agent`, `60-report`
|
|
166
166
|
|
|
167
167
|
## Next Workflow Recommendation
|
|
168
168
|
|
|
169
|
-
- **Primary**:
|
|
169
|
+
- **Primary**: `60-report {ID}` when verification passes, or `40-implement {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.
|
|
173
173
|
- `review` - choose this when changed work needs standards and spec review as separate axes.
|
|
174
|
-
- `Wiki project ingest devflow/runs/{ID}
|
|
174
|
+
- `Wiki project ingest devflow/runs/{ID}-*50-verify.md` - choose this when verification reveals reusable project knowledge.
|
|
175
175
|
|
|
176
176
|
## Nexus Event
|
|
177
177
|
|
|
@@ -184,5 +184,5 @@ Report:
|
|
|
184
184
|
- **Needed**: `yes` when QA confirms a reusable lesson, regression pattern, manual check, or validation command.
|
|
185
185
|
- **Scope**: `project` unless QA reveals a DevFlow framework rule.
|
|
186
186
|
- **Reason**: Verified QA evidence is one of the safest sources for project wiki updates.
|
|
187
|
-
- **Suggested Command**: `Wiki project ingest devflow/runs/{ID}
|
|
187
|
+
- **Suggested Command**: `Wiki project ingest devflow/runs/{ID}-*50-verify.md`
|
|
188
188
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---name: 60-report
|
|
2
2
|
|
|
3
|
-
description: Report stage in DevFlow 2.0 - produce
|
|
3
|
+
description: "[Devflow] Report stage in DevFlow 2.0 - produce standardized markdown and HTML summary report for the completed run."
|
|
4
4
|
argument-hint: "{running-id or workspace path}"
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -13,7 +13,7 @@ Produce the final human-friendly summary of the full running flow in both Markdo
|
|
|
13
13
|
## Usage
|
|
14
14
|
|
|
15
15
|
```text
|
|
16
|
-
|
|
16
|
+
60-report {running-id or workspace path}
|
|
17
17
|
```
|
|
18
18
|
|
|
19
19
|
Use this when:
|
|
@@ -27,8 +27,8 @@ Use this when:
|
|
|
27
27
|
Write the primary stage artifacts to:
|
|
28
28
|
|
|
29
29
|
```text
|
|
30
|
-
devflow/runs/{ID}-{slug}
|
|
31
|
-
devflow/runs/{ID}-{slug}
|
|
30
|
+
devflow/runs/{ID}-{slug}60-report.md
|
|
31
|
+
devflow/runs/{ID}-{slug}60-report.html
|
|
32
32
|
```
|
|
33
33
|
|
|
34
34
|
using:
|
|
@@ -157,8 +157,8 @@ npm run report:html -- <workspace-path-or-running-id>
|
|
|
157
157
|
## Relationship To DevFlow 2.0
|
|
158
158
|
|
|
159
159
|
- Classification: Mainline workflow
|
|
160
|
-
- Previous state:
|
|
161
|
-
- Next state:
|
|
160
|
+
- Previous state: `50-verify`
|
|
161
|
+
- Next state: `70-release` when the summary is aligned and release can proceed
|
|
162
162
|
- Common companion commands: `Wiki` for durable knowledge capture, `Help` for routing or explanation
|
|
163
163
|
- Support skills: `handoff`, `insight-capture`, and writing skills when final reporting must support continuation or reusable learning
|
|
164
164
|
|
|
@@ -167,11 +167,11 @@ npm run report:html -- <workspace-path-or-running-id>
|
|
|
167
167
|
- `AGENTS.md`
|
|
168
168
|
- `docs/workspace-artifacts.md`
|
|
169
169
|
- `.agent/resources/schemas/report.template.md`
|
|
170
|
-
- Related commands:
|
|
170
|
+
- Related commands: `50-verify`, `70-release`, `Wiki`, `Help`
|
|
171
171
|
|
|
172
172
|
## Next Workflow Recommendation
|
|
173
173
|
|
|
174
|
-
- **Primary**:
|
|
174
|
+
- **Primary**: `70-release {ID}` after `60-report.md` and `60-report.html` reflect the verified state clearly.
|
|
175
175
|
- **Render HTML**: `npm run report:html -- {ID}` after `60-report.md` is finalized so the standardized stakeholder HTML stays in sync
|
|
176
176
|
- **Alternative**: `Wiki` when the completed run should be promoted into durable reusable knowledge before release packaging continues
|
|
177
177
|
- **Additional Alternative**: `handoff` when another session or agent must continue from the completed run.
|
|
@@ -180,4 +180,4 @@ npm run report:html -- <workspace-path-or-running-id>
|
|
|
180
180
|
|
|
181
181
|
- Use `Wiki` when the final summary should become durable project or framework knowledge.
|
|
182
182
|
- Use `Help` when approval signals, ownership, or route timing still feel ambiguous.
|
|
183
|
-
- Return to
|
|
183
|
+
- Return to `50-verify` when unresolved evidence, blockers, or review state mean the report should not advance yet.
|