@jakkrichm/create-nexus-devflow 2.0.9 → 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.
Files changed (122) hide show
  1. package/package.json +1 -1
  2. package/template/.agents/skills/00-discover/SKILL.md +12 -12
  3. package/template/.agents/skills/10-define/SKILL.md +15 -15
  4. package/template/.agents/skills/20-spec/SKILL.md +13 -13
  5. package/template/.agents/skills/30-plan/SKILL.md +12 -12
  6. package/template/.agents/skills/40-implement/SKILL.md +13 -13
  7. package/template/.agents/skills/50-verify/SKILL.md +14 -14
  8. package/template/.agents/skills/60-report/SKILL.md +8 -8
  9. package/template/.agents/skills/70-release/SKILL.md +12 -12
  10. package/template/.agents/skills/adopt/SKILL.md +4 -4
  11. package/template/.agents/skills/agent/SKILL.md +3 -3
  12. package/template/.agents/skills/autopilot/SKILL.md +19 -19
  13. package/template/.agents/skills/brainstorm/SKILL.md +9 -9
  14. package/template/.agents/skills/brief/SKILL.md +8 -8
  15. package/template/.agents/skills/changelog/SKILL.md +3 -3
  16. package/template/.agents/skills/ci/SKILL.md +1 -1
  17. package/template/.agents/skills/ci-cd-and-automation/SKILL.md +3 -3
  18. package/template/.agents/skills/codebase-design/SKILL.md +5 -5
  19. package/template/.agents/skills/commit/SKILL.md +3 -3
  20. package/template/.agents/skills/competitor-analysis/SKILL.md +2 -2
  21. package/template/.agents/skills/debug/SKILL.md +10 -10
  22. package/template/.agents/skills/deploy/SKILL.md +3 -3
  23. package/template/.agents/skills/devflow/SKILL.md +24 -24
  24. package/template/.agents/skills/diagnosing-bugs/SKILL.md +3 -3
  25. package/template/.agents/skills/doctor/SKILL.md +3 -3
  26. package/template/.agents/skills/followup/SKILL.md +9 -9
  27. package/template/.agents/skills/goal/SKILL.md +10 -10
  28. package/template/.agents/skills/help/SKILL.md +17 -17
  29. package/template/.agents/skills/human-review-decisions/SKILL.md +5 -5
  30. package/template/.agents/skills/insight/SKILL.md +7 -7
  31. package/template/.agents/skills/insight-capture/SKILL.md +3 -3
  32. package/template/.agents/skills/intelligent-routing/SKILL.md +22 -22
  33. package/template/.agents/skills/issue-triage/SKILL.md +4 -4
  34. package/template/.agents/skills/merge/SKILL.md +4 -4
  35. package/template/.agents/skills/onboard/SKILL.md +7 -7
  36. package/template/.agents/skills/parallel-agents/SKILL.md +1 -1
  37. package/template/.agents/skills/planning-and-task-breakdown/SKILL.md +1 -1
  38. package/template/.agents/skills/pr/SKILL.md +7 -7
  39. package/template/.agents/skills/pr-review/SKILL.md +6 -6
  40. package/template/.agents/skills/pr-review-analysis/SKILL.md +2 -2
  41. package/template/.agents/skills/prd/SKILL.md +10 -10
  42. package/template/.agents/skills/preview/SKILL.md +7 -7
  43. package/template/.agents/skills/preview-local-check/SKILL.md +5 -5
  44. package/template/.agents/skills/prototype/SKILL.md +1 -1
  45. package/template/.agents/skills/release-git-operations/SKILL.md +5 -5
  46. package/template/.agents/skills/research/SKILL.md +9 -9
  47. package/template/.agents/skills/review/SKILL.md +3 -3
  48. package/template/.agents/skills/review-followup-routing/SKILL.md +3 -3
  49. package/template/.agents/skills/roadmap-strategy/SKILL.md +3 -3
  50. package/template/.agents/skills/rollback/SKILL.md +5 -5
  51. package/template/.agents/skills/security-review/SKILL.md +3 -3
  52. package/template/.agents/skills/shipping-and-launch/SKILL.md +1 -1
  53. package/template/.agents/skills/simplify/SKILL.md +6 -6
  54. package/template/.agents/skills/spec-orchestration/SKILL.md +5 -5
  55. package/template/.agents/skills/specialist-agent-routing/SKILL.md +7 -7
  56. package/template/.agents/skills/test/SKILL.md +3 -3
  57. package/template/.agents/skills/test-execution-and-coverage/SKILL.md +4 -4
  58. package/template/.agents/skills/try/SKILL.md +3 -3
  59. package/template/.agents/skills/verification-orchestration/SKILL.md +4 -4
  60. package/template/.agents/skills/wiki/SKILL.md +6 -6
  61. package/template/.agents/skills/workflow-documentation-sync/SKILL.md +1 -1
  62. package/template/.claude/skills/00-discover/SKILL.md +12 -12
  63. package/template/.claude/skills/10-define/SKILL.md +15 -15
  64. package/template/.claude/skills/20-spec/SKILL.md +13 -13
  65. package/template/.claude/skills/30-plan/SKILL.md +12 -12
  66. package/template/.claude/skills/40-implement/SKILL.md +13 -13
  67. package/template/.claude/skills/50-verify/SKILL.md +14 -14
  68. package/template/.claude/skills/60-report/SKILL.md +8 -8
  69. package/template/.claude/skills/70-release/SKILL.md +12 -12
  70. package/template/.claude/skills/adopt/SKILL.md +4 -4
  71. package/template/.claude/skills/agent/SKILL.md +3 -3
  72. package/template/.claude/skills/autopilot/SKILL.md +19 -19
  73. package/template/.claude/skills/brainstorm/SKILL.md +9 -9
  74. package/template/.claude/skills/brief/SKILL.md +8 -8
  75. package/template/.claude/skills/changelog/SKILL.md +3 -3
  76. package/template/.claude/skills/ci/SKILL.md +1 -1
  77. package/template/.claude/skills/ci-cd-and-automation/SKILL.md +3 -3
  78. package/template/.claude/skills/codebase-design/SKILL.md +5 -5
  79. package/template/.claude/skills/commit/SKILL.md +3 -3
  80. package/template/.claude/skills/competitor-analysis/SKILL.md +2 -2
  81. package/template/.claude/skills/debug/SKILL.md +10 -10
  82. package/template/.claude/skills/deploy/SKILL.md +3 -3
  83. package/template/.claude/skills/devflow/SKILL.md +24 -24
  84. package/template/.claude/skills/diagnosing-bugs/SKILL.md +3 -3
  85. package/template/.claude/skills/doctor/SKILL.md +3 -3
  86. package/template/.claude/skills/followup/SKILL.md +9 -9
  87. package/template/.claude/skills/goal/SKILL.md +10 -10
  88. package/template/.claude/skills/help/SKILL.md +17 -17
  89. package/template/.claude/skills/human-review-decisions/SKILL.md +5 -5
  90. package/template/.claude/skills/insight/SKILL.md +7 -7
  91. package/template/.claude/skills/insight-capture/SKILL.md +3 -3
  92. package/template/.claude/skills/intelligent-routing/SKILL.md +22 -22
  93. package/template/.claude/skills/issue-triage/SKILL.md +4 -4
  94. package/template/.claude/skills/merge/SKILL.md +4 -4
  95. package/template/.claude/skills/onboard/SKILL.md +7 -7
  96. package/template/.claude/skills/parallel-agents/SKILL.md +1 -1
  97. package/template/.claude/skills/planning-and-task-breakdown/SKILL.md +1 -1
  98. package/template/.claude/skills/pr/SKILL.md +7 -7
  99. package/template/.claude/skills/pr-review/SKILL.md +6 -6
  100. package/template/.claude/skills/pr-review-analysis/SKILL.md +2 -2
  101. package/template/.claude/skills/prd/SKILL.md +10 -10
  102. package/template/.claude/skills/preview/SKILL.md +7 -7
  103. package/template/.claude/skills/preview-local-check/SKILL.md +5 -5
  104. package/template/.claude/skills/prototype/SKILL.md +1 -1
  105. package/template/.claude/skills/release-git-operations/SKILL.md +5 -5
  106. package/template/.claude/skills/research/SKILL.md +9 -9
  107. package/template/.claude/skills/review/SKILL.md +3 -3
  108. package/template/.claude/skills/review-followup-routing/SKILL.md +3 -3
  109. package/template/.claude/skills/roadmap-strategy/SKILL.md +3 -3
  110. package/template/.claude/skills/rollback/SKILL.md +5 -5
  111. package/template/.claude/skills/security-review/SKILL.md +3 -3
  112. package/template/.claude/skills/shipping-and-launch/SKILL.md +1 -1
  113. package/template/.claude/skills/simplify/SKILL.md +6 -6
  114. package/template/.claude/skills/spec-orchestration/SKILL.md +5 -5
  115. package/template/.claude/skills/specialist-agent-routing/SKILL.md +7 -7
  116. package/template/.claude/skills/test/SKILL.md +3 -3
  117. package/template/.claude/skills/test-execution-and-coverage/SKILL.md +4 -4
  118. package/template/.claude/skills/try/SKILL.md +3 -3
  119. package/template/.claude/skills/verification-orchestration/SKILL.md +4 -4
  120. package/template/.claude/skills/wiki/SKILL.md +6 -6
  121. package/template/.claude/skills/workflow-documentation-sync/SKILL.md +1 -1
  122. package/template/AGENTS.md +43 -38
@@ -13,8 +13,8 @@ Convert an approved `Proceed` discovery into bounded delivery slices. Allocate o
13
13
  ## Usage
14
14
 
15
15
  ```text
16
- /10-Define {discovery-id or discovery path}
17
- /10-Define {running-id or run path}
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}/10-define.md
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 `/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}`.
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 `/00-Discover {discovery_id}`.
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 `/30-Plan` and checklists.
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 `/20-Spec`
129
+ - do not silently fork scope during `20-spec`
130
130
 
131
131
  ### 7. Manual Review Gate
132
132
 
133
- Before recommending `/20-Spec`, confirm each generated definition independently. Approval of one run must not imply approval of every sibling run.
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 `/20-Spec {running_id}` commands for approved runs
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 `/00-Discover`
150
- - Next state: `/20-Spec {running_id}` per generated run
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**: `/20-Spec {running_id}` for each approved run
161
+ - **Primary**: `20-spec {running_id}` for each approved run
162
162
  - **Alternatives**:
163
- - `/00-Discover {discovery_id}` when the go/no-go decision or direction is unstable
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 `/30-Plan`, not separate Running IDs.
170
+ - Use `planning-and-task-breakdown` only after the delivery boundary is stable; small tasks belong in `30-plan`, not separate Running IDs.
@@ -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
- /20-Spec {running-id or workspace path}
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}/20-spec.md
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 `/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.
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 `/10-Define {running_id}` for an explicit split.
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 `/30-Plan`, check whether the delivery contract has been human-reviewed.
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 `/30-Plan` as a soft recommendation only
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: `/10-Define`
131
- - Next state: `/30-Plan` when the contract is implementation-ready
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: `/10-Define`, `PRD`, `Spec-Research`, `Competitor`, `Spec-Orchestrate`, `/30-Plan`
139
+ - Related commands: `10-define`, `PRD`, `Spec-Research`, `Competitor`, `Spec-Orchestrate`, `30-plan`
140
140
 
141
141
  ## Next Workflow Recommendation
142
142
 
143
- - **Primary**: `/30-Plan`
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
- - `/10-Define` - choose this when the scope itself is still unstable.
149
+ - `10-define` - choose this when the scope itself is still unstable.
150
150
 
151
151
  ## Nexus Event
152
152
 
@@ -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
- /30-Plan {ID}
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 `/20-Spec` when the contract is not plan-ready.
49
+ - **Adjustment**: if evidence is missing, search/read more, recommend `Research` or `Agent codebase-explorer`, split the work, or route back to `20-spec` when the contract is not plan-ready.
50
50
  - **Stop Condition**: stop only when phases are ordered, subtasks are scoped, verification is explicit, test decisions are recorded, and any blockers are visible.
51
- - **Handoff**: `30-plan.md` must give `/40-Implement` enough context to select one scoped unit and execute it without inventing intent.
51
+ - **Handoff**: `30-plan.md` must give `40-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}-*/20-spec.md`
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 `/40-Implement`, check whether the plan still shows pending review.
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 `/40-Implement` as a soft recommendation only
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: `/20-Spec`
187
- - Next state: `/40-Implement` when execution steps and verification are clear
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: `/20-Spec`, `Research`, `Agent`, `/40-Implement`
195
+ - Related commands: `20-spec`, `Research`, `Agent`, `40-implement`
196
196
 
197
197
  ## Next Workflow Recommendation
198
198
 
199
- - **Primary**: `/40-Implement {ID}`
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
- - `/20-Spec {ID}` - choose this when the spec itself is not strong enough for planning.
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}-*/30-plan.md`
219
+ - **Suggested Command**: `Wiki project ingest devflow/runs/{ID}-*30-plan.md`
220
220
 
221
221
 
@@ -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
- /40-Implement {ID}
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 `/30-Plan` or `/20-Spec` when the work no longer matches the contract.
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 `/50-Verify` what changed, why it changed, which checks ran, what failed or was skipped, and what residual risk remains.
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 `/50-Verify`
116
- - keep `/50-Verify` as the next soft recommendation rather than an unconditional jump
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: `/50-Verify {ID}`
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: `/30-Plan`
134
- - Next state: `/50-Verify` when scoped implementation is complete
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: `/30-Plan`, `Debug`, `Preview`, `/50-Verify`
142
+ - Related commands: `30-plan`, `Debug`, `Preview`, `50-verify`
143
143
 
144
144
  ## Next Workflow Recommendation
145
145
 
146
- - **Primary**: `/50-Verify {ID}` when the planned work is complete.
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
- - `/30-Plan {ID}` - choose this when the plan is incomplete or no longer matches the work.
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 `/30-Plan` when implementation drift shows the plan no longer matches reality.
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}-*/40-implement.md`
165
+ - **Suggested Command**: `Wiki project ingest devflow/runs/{ID}-*40-implement.md`
166
166
 
@@ -9,7 +9,7 @@ Review implementation quality, run validation, produce a verification report, an
9
9
  ## Usage
10
10
 
11
11
  ```text
12
- /50-Verify {ID}
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 `/40-Implement` with the exact evidence gap.
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 `/60-Report` why the work is ready, or tell `/40-Implement` exactly what must change before verification resumes.
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 `/60-Report`
123
+ - route to `60-report`
124
124
 
125
125
  If fail:
126
126
 
127
- - route back to `/40-Implement` with exact failed evidence, missing checks, or required changes
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 `/40-Implement`
138
- - keep `/60-Report` as a soft recommendation only
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: `/60-Report {ID}` if pass, or `/40-Implement {ID}` if fail
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: `/40-Implement`
155
- - Next state: `/60-Report` when evidence is sufficient
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: `/40-Implement`, `Debug`, `Test`, `QA-Orchestrate`, `PR-Review`, `Agent`, `/60-Report`
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**: `/60-Report {ID}` when verification passes, or `/40-Implement {ID}` when verification fails.
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}-*/50-verify.md` - choose this when verification reveals reusable project knowledge.
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}-*/50-verify.md`
187
+ - **Suggested Command**: `Wiki project ingest devflow/runs/{ID}-*50-verify.md`
188
188
 
@@ -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
- /60-Report {running-id or workspace path}
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}/60-report.md
31
- devflow/runs/{ID}-{slug}/60-report.html
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: `/50-Verify`
161
- - Next state: `/70-Release` when the summary is aligned and release can proceed
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: `/50-Verify`, `/70-Release`, `Wiki`, `Help`
170
+ - Related commands: `50-verify`, `70-release`, `Wiki`, `Help`
171
171
 
172
172
  ## Next Workflow Recommendation
173
173
 
174
- - **Primary**: `/70-Release {ID}` after `60-report.md` and `60-report.html` reflect the verified state clearly.
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 `/50-Verify` when unresolved evidence, blockers, or review state mean the report should not advance yet.
183
+ - Return to `50-verify` when unresolved evidence, blockers, or review state mean the report should not advance yet.
@@ -13,12 +13,12 @@ Package approved work for delivery after the report stage has captured the final
13
13
  ## Usage
14
14
 
15
15
  ```text
16
- /70-Release {running-id or workspace path}
16
+ 70-release {running-id or workspace path}
17
17
  ```
18
18
 
19
19
  Use this when:
20
20
 
21
- - `/60-Report` is complete
21
+ - `60-report` is complete
22
22
  - the work needs release execution or a release-facing handoff packet
23
23
  - downstream stakeholders need delivery notes instead of raw implementation detail
24
24
 
@@ -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}/70-release.md
30
+ devflow/runs/{ID}-{slug}70-release.md
31
31
  ```
32
32
 
33
33
  using:
@@ -60,7 +60,7 @@ Run release as a readiness-packaging loop, not as a celebratory summary.
60
60
  - **Context**: read `50-verify.md`, `50-verify-impact.md` when present, `40-implement.md`, `20-spec.md`, checklist state, and any PR, deploy, merge, or handoff notes.
61
61
  - **Action**: summarize delivered scope, user/system impact, readiness state, validation evidence, rollback or mitigation notes, and follow-up items.
62
62
  - **Observation**: use concrete evidence such as verify verdict, failed or skipped checks, impact notes, residual risks, merge/deploy constraints, and checklist status.
63
- - **Adjustment**: if release readiness becomes uncertain, return to `/50-Verify`; if fixes are required, return to `/40-Implement`; if context must transfer, use `handoff`.
63
+ - **Adjustment**: if release readiness becomes uncertain, return to `50-verify`; if fixes are required, return to `40-implement`; 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
 
@@ -99,7 +99,7 @@ Prefer clear release-note style wording:
99
99
 
100
100
  If release readiness changes because unresolved issues are found:
101
101
 
102
- - route back to `/50-Verify` or `/40-Implement`
102
+ - route back to `50-verify` or `40-implement`
103
103
 
104
104
  Do not package unfinished work as release-ready through wording tricks.
105
105
  Use `resolving-merge-conflicts` when merge or rebase conflicts block packaging. Use `handoff` when release output must transfer to another agent or session without duplicating artifacts.
@@ -125,7 +125,7 @@ Report:
125
125
  ## Relationship To DevFlow 2.0
126
126
 
127
127
  - Classification: Mainline workflow
128
- - Previous state: `/60-Report`
128
+ - Previous state: `60-report`
129
129
  - Next state: End of the mainline run when release packaging or handoff is complete
130
130
  - Common companion commands: `Commit`, `PR`, `Deploy`, `Changelog`, `Merge`, `Wiki`
131
131
  - Support skills: `resolving-merge-conflicts`, `handoff`, and `setup-pre-commit` when release packaging needs conflict resolution, transfer notes, or local quality gates
@@ -135,21 +135,21 @@ Report:
135
135
  - `AGENTS.md`
136
136
  - `docs/workspace-artifacts.md`
137
137
  - `.agent/resources/schemas/release.template.md`
138
- - Related commands: `/60-Report`, `Commit`, `PR`, `Deploy`, `Changelog`, `Merge`, `Wiki`
138
+ - Related commands: `60-report`, `Commit`, `PR`, `Deploy`, `Changelog`, `Merge`, `Wiki`
139
139
 
140
140
  ## Next Workflow Recommendation
141
141
 
142
142
  - **Primary**: End of Timeline flow
143
143
  - **Why**: The report is already complete, and this phase is the final release-facing execution step.
144
144
  - **Alternatives**:
145
- - `/60-Report` - choose this when the release package diverges from the approved report and the summary must be refreshed first.
146
- - `/50-Verify` - choose this when release readiness becomes uncertain.
147
- - `/40-Implement` - choose this when additional fixes are needed before release can proceed.
145
+ - `60-report` - choose this when the release package diverges from the approved report and the summary must be refreshed first.
146
+ - `50-verify` - choose this when release readiness becomes uncertain.
147
+ - `40-implement` - choose this when additional fixes are needed before release can proceed.
148
148
  - `handoff` - choose this when release-ready context must move to another session, agent, or stakeholder packet.
149
149
 
150
150
  ## Nexus Event
151
151
 
152
152
  - Use `Commit`, `PR`, `Deploy`, `Merge`, or `Changelog` when release execution still needs a concrete lane.
153
- - Return to `/60-Report` when release notes, scope, or handoff wording diverge from the approved summary.
154
- - Return to `/50-Verify` or `/40-Implement` when release readiness changes because unresolved issues are discovered.
153
+ - Return to `60-report` when release notes, scope, or handoff wording diverge from the approved summary.
154
+ - Return to `50-verify` or `40-implement` when release readiness changes because unresolved issues are discovered.
155
155
 
@@ -8,14 +8,14 @@ description: "[Devflow] Survey existing brownfield codebase and bootstrap DevFlo
8
8
  Where this sits in the workflow:
9
9
 
10
10
  ```text
11
- existing codebase -> [adopt] -> project-overview + coding-standards -> /00-discover or /10-define
11
+ existing codebase -> [adopt] -> project-overview + coding-standards -> 00-discover or 10-define
12
12
  (already has code) (survey + (seeded from the real code; (first feature / refactoring
13
13
  interview) shipped architecture documented) delivery lifecycle)
14
14
  ```
15
15
 
16
16
  Standard onboarding assumes a freshly scaffolded, near-empty app. That does not fit a codebase that already has thousands of lines of working code.
17
17
 
18
- `/adopt` is the brownfield on-ramp for Nexus-DevFlow: it reads what is already there, asks only for what the code cannot reveal (the *intent*, the *why*, and the *upcoming roadmap*), and produces the exact context files the rest of the DevFlow lifecycle expects (`project-overview.md`, `coding-standards.md`, `AGENTS.md` commands).
18
+ `adopt` is the brownfield on-ramp for Nexus-DevFlow: it reads what is already there, asks only for what the code cannot reveal (the *intent*, the *why*, and the *upcoming roadmap*), and produces the exact context files the rest of the DevFlow lifecycle expects (`project-overview.md`, `coding-standards.md`, `AGENTS.md` commands).
19
19
 
20
20
  ---
21
21
 
@@ -91,5 +91,5 @@ Present the adoption summary for review:
91
91
  - Inferred conventions and coding standards
92
92
  - Available verified commands in `AGENTS.md`
93
93
  - Recommended next step:
94
- - Run `00-discover` (or `/00-discover`, `$00-discover`) to explore the next major initiative or feature
95
- - Run `10-define` (or `/10-define`, `$10-define`) to immediately scope a delivery run for known roadmap items
94
+ - Run `00-discover` (or `00-discover`, `$00-discover`) to explore the next major initiative or feature
95
+ - Run `10-define` (or `10-define`, `$10-define`) to immediately scope a delivery run for known roadmap items
@@ -17,7 +17,7 @@ Agent {AGENT_NAME} {TARGET}
17
17
  Examples:
18
18
 
19
19
  ```text
20
- Agent requirements-engineer devflow/runs/007-auth-refactor/20-spec.md
20
+ Agent requirements-engineer devflow/runs/007-auth-refactor20-spec.md
21
21
  Agent codebase-explorer src/services/
22
22
  Agent code-reviewer devflow/runs/007-auth-refactor
23
23
  ```
@@ -145,7 +145,7 @@ Short reports can be returned directly in chat.
145
145
  - Classification: Companion command
146
146
  - Mainline status: Specialist invocation command, not a numbered stage
147
147
  - Typical entry points: any stage that needs focused specialist judgment
148
- - Typical handoff targets: return to the owning workflow such as `/10-Define`, `/20-Spec`, `/30-Plan`, `/40-Implement`, `/50-Verify`, `/60-Report`, `/70-Release`
148
+ - Typical handoff targets: return to the owning workflow such as `10-define`, `20-spec`, `30-plan`, `40-implement`, `50-verify`, `60-report`, `70-release`
149
149
 
150
150
  ## Sources
151
151
 
@@ -156,7 +156,7 @@ Short reports can be returned directly in chat.
156
156
 
157
157
  ## Next Workflow Recommendation
158
158
 
159
- - **Primary**: the workflow that owns the target's lifecycle, such as `/10-Define`, `/20-Spec`, `/30-Plan`, `/40-Implement`, `/50-Verify`, `/60-Report`, `/70-Release`, or `PR-Review`.
159
+ - **Primary**: the workflow that owns the target's lifecycle, such as `10-define`, `20-spec`, `30-plan`, `40-implement`, `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