@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.
- package/package.json +1 -1
- package/template/.agents/skills/00-discover/SKILL.md +12 -12
- package/template/.agents/skills/10-define/SKILL.md +15 -15
- package/template/.agents/skills/20-spec/SKILL.md +13 -13
- package/template/.agents/skills/30-plan/SKILL.md +12 -12
- package/template/.agents/skills/40-implement/SKILL.md +13 -13
- package/template/.agents/skills/50-verify/SKILL.md +14 -14
- package/template/.agents/skills/60-report/SKILL.md +8 -8
- package/template/.agents/skills/70-release/SKILL.md +12 -12
- package/template/.agents/skills/adopt/SKILL.md +4 -4
- package/template/.agents/skills/agent/SKILL.md +3 -3
- package/template/.agents/skills/autopilot/SKILL.md +19 -19
- package/template/.agents/skills/brainstorm/SKILL.md +9 -9
- package/template/.agents/skills/brief/SKILL.md +8 -8
- package/template/.agents/skills/changelog/SKILL.md +3 -3
- package/template/.agents/skills/ci/SKILL.md +1 -1
- package/template/.agents/skills/ci-cd-and-automation/SKILL.md +3 -3
- package/template/.agents/skills/codebase-design/SKILL.md +5 -5
- package/template/.agents/skills/commit/SKILL.md +3 -3
- package/template/.agents/skills/competitor-analysis/SKILL.md +2 -2
- package/template/.agents/skills/debug/SKILL.md +10 -10
- package/template/.agents/skills/deploy/SKILL.md +3 -3
- package/template/.agents/skills/devflow/SKILL.md +24 -24
- package/template/.agents/skills/diagnosing-bugs/SKILL.md +3 -3
- package/template/.agents/skills/doctor/SKILL.md +3 -3
- package/template/.agents/skills/followup/SKILL.md +9 -9
- package/template/.agents/skills/goal/SKILL.md +10 -10
- package/template/.agents/skills/help/SKILL.md +17 -17
- package/template/.agents/skills/human-review-decisions/SKILL.md +5 -5
- package/template/.agents/skills/insight/SKILL.md +7 -7
- package/template/.agents/skills/insight-capture/SKILL.md +3 -3
- package/template/.agents/skills/intelligent-routing/SKILL.md +22 -22
- package/template/.agents/skills/issue-triage/SKILL.md +4 -4
- package/template/.agents/skills/merge/SKILL.md +4 -4
- package/template/.agents/skills/onboard/SKILL.md +7 -7
- package/template/.agents/skills/parallel-agents/SKILL.md +1 -1
- package/template/.agents/skills/planning-and-task-breakdown/SKILL.md +1 -1
- package/template/.agents/skills/pr/SKILL.md +7 -7
- package/template/.agents/skills/pr-review/SKILL.md +6 -6
- package/template/.agents/skills/pr-review-analysis/SKILL.md +2 -2
- package/template/.agents/skills/prd/SKILL.md +10 -10
- package/template/.agents/skills/preview/SKILL.md +7 -7
- package/template/.agents/skills/preview-local-check/SKILL.md +5 -5
- package/template/.agents/skills/prototype/SKILL.md +1 -1
- package/template/.agents/skills/release-git-operations/SKILL.md +5 -5
- package/template/.agents/skills/research/SKILL.md +9 -9
- package/template/.agents/skills/review/SKILL.md +3 -3
- package/template/.agents/skills/review-followup-routing/SKILL.md +3 -3
- package/template/.agents/skills/roadmap-strategy/SKILL.md +3 -3
- package/template/.agents/skills/rollback/SKILL.md +5 -5
- package/template/.agents/skills/security-review/SKILL.md +3 -3
- package/template/.agents/skills/shipping-and-launch/SKILL.md +1 -1
- package/template/.agents/skills/simplify/SKILL.md +6 -6
- package/template/.agents/skills/spec-orchestration/SKILL.md +5 -5
- package/template/.agents/skills/specialist-agent-routing/SKILL.md +7 -7
- package/template/.agents/skills/test/SKILL.md +3 -3
- package/template/.agents/skills/test-execution-and-coverage/SKILL.md +4 -4
- package/template/.agents/skills/try/SKILL.md +3 -3
- package/template/.agents/skills/verification-orchestration/SKILL.md +4 -4
- package/template/.agents/skills/wiki/SKILL.md +6 -6
- package/template/.agents/skills/workflow-documentation-sync/SKILL.md +1 -1
- package/template/.claude/skills/00-discover/SKILL.md +12 -12
- package/template/.claude/skills/10-define/SKILL.md +15 -15
- package/template/.claude/skills/20-spec/SKILL.md +13 -13
- package/template/.claude/skills/30-plan/SKILL.md +12 -12
- package/template/.claude/skills/40-implement/SKILL.md +13 -13
- package/template/.claude/skills/50-verify/SKILL.md +14 -14
- package/template/.claude/skills/60-report/SKILL.md +8 -8
- package/template/.claude/skills/70-release/SKILL.md +12 -12
- package/template/.claude/skills/adopt/SKILL.md +4 -4
- package/template/.claude/skills/agent/SKILL.md +3 -3
- package/template/.claude/skills/autopilot/SKILL.md +19 -19
- package/template/.claude/skills/brainstorm/SKILL.md +9 -9
- package/template/.claude/skills/brief/SKILL.md +8 -8
- package/template/.claude/skills/changelog/SKILL.md +3 -3
- package/template/.claude/skills/ci/SKILL.md +1 -1
- package/template/.claude/skills/ci-cd-and-automation/SKILL.md +3 -3
- package/template/.claude/skills/codebase-design/SKILL.md +5 -5
- package/template/.claude/skills/commit/SKILL.md +3 -3
- package/template/.claude/skills/competitor-analysis/SKILL.md +2 -2
- package/template/.claude/skills/debug/SKILL.md +10 -10
- package/template/.claude/skills/deploy/SKILL.md +3 -3
- package/template/.claude/skills/devflow/SKILL.md +24 -24
- package/template/.claude/skills/diagnosing-bugs/SKILL.md +3 -3
- package/template/.claude/skills/doctor/SKILL.md +3 -3
- package/template/.claude/skills/followup/SKILL.md +9 -9
- package/template/.claude/skills/goal/SKILL.md +10 -10
- package/template/.claude/skills/help/SKILL.md +17 -17
- package/template/.claude/skills/human-review-decisions/SKILL.md +5 -5
- package/template/.claude/skills/insight/SKILL.md +7 -7
- package/template/.claude/skills/insight-capture/SKILL.md +3 -3
- package/template/.claude/skills/intelligent-routing/SKILL.md +22 -22
- package/template/.claude/skills/issue-triage/SKILL.md +4 -4
- package/template/.claude/skills/merge/SKILL.md +4 -4
- package/template/.claude/skills/onboard/SKILL.md +7 -7
- package/template/.claude/skills/parallel-agents/SKILL.md +1 -1
- package/template/.claude/skills/planning-and-task-breakdown/SKILL.md +1 -1
- package/template/.claude/skills/pr/SKILL.md +7 -7
- package/template/.claude/skills/pr-review/SKILL.md +6 -6
- package/template/.claude/skills/pr-review-analysis/SKILL.md +2 -2
- package/template/.claude/skills/prd/SKILL.md +10 -10
- package/template/.claude/skills/preview/SKILL.md +7 -7
- package/template/.claude/skills/preview-local-check/SKILL.md +5 -5
- package/template/.claude/skills/prototype/SKILL.md +1 -1
- package/template/.claude/skills/release-git-operations/SKILL.md +5 -5
- package/template/.claude/skills/research/SKILL.md +9 -9
- package/template/.claude/skills/review/SKILL.md +3 -3
- package/template/.claude/skills/review-followup-routing/SKILL.md +3 -3
- package/template/.claude/skills/roadmap-strategy/SKILL.md +3 -3
- package/template/.claude/skills/rollback/SKILL.md +5 -5
- package/template/.claude/skills/security-review/SKILL.md +3 -3
- package/template/.claude/skills/shipping-and-launch/SKILL.md +1 -1
- package/template/.claude/skills/simplify/SKILL.md +6 -6
- package/template/.claude/skills/spec-orchestration/SKILL.md +5 -5
- package/template/.claude/skills/specialist-agent-routing/SKILL.md +7 -7
- package/template/.claude/skills/test/SKILL.md +3 -3
- package/template/.claude/skills/test-execution-and-coverage/SKILL.md +4 -4
- package/template/.claude/skills/try/SKILL.md +3 -3
- package/template/.claude/skills/verification-orchestration/SKILL.md +4 -4
- package/template/.claude/skills/wiki/SKILL.md +6 -6
- package/template/.claude/skills/workflow-documentation-sync/SKILL.md +1 -1
- package/template/AGENTS.md +43 -38
|
@@ -12,7 +12,7 @@ Any time during development -> [doctor] -> Health Report & Actionable Fixes
|
|
|
12
12
|
(read-only inspection) (diagnostics) (remediation recommendations)
|
|
13
13
|
```
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
`doctor` is a safe, read-only diagnostic skill that verifies whether your repository's Nexus-DevFlow configuration, context files, tool adapters, commands, and active runs are healthy and aligned.
|
|
16
16
|
|
|
17
17
|
---
|
|
18
18
|
|
|
@@ -29,7 +29,7 @@ Run through these 5 health checks:
|
|
|
29
29
|
### Check 1: Core Framework & Context Files Integrity
|
|
30
30
|
- Check if [AGENTS.md](AGENTS.md) and [CLAUDE.md](CLAUDE.md) exist and are populated.
|
|
31
31
|
- Check required context files under `devflow/context/`:
|
|
32
|
-
- `project-overview.md` (Check if still empty/placeholder -> recommend
|
|
32
|
+
- `project-overview.md` (Check if still empty/placeholder -> recommend `onboard` or `adopt`)
|
|
33
33
|
- `coding-standards.md` (Check if customized for stack)
|
|
34
34
|
- `ai-interaction.md` (Check if rules are configured)
|
|
35
35
|
- `current-stage.md` (Check if active run matches filesystem)
|
|
@@ -80,5 +80,5 @@ Present a clean, scannable diagnostic report:
|
|
|
80
80
|
|
|
81
81
|
### Recommended Remediation Actions:
|
|
82
82
|
1. [Action item if any warning or failure detected]
|
|
83
|
-
2. [Suggested next command, e.g.
|
|
83
|
+
2. [Suggested next command, e.g. devflow, onboard, adopt, etc.]
|
|
84
84
|
```
|
|
@@ -33,11 +33,11 @@ Preserve existing phases, subtasks, statuses, logs, QA results, and completed co
|
|
|
33
33
|
|
|
34
34
|
Read:
|
|
35
35
|
|
|
36
|
-
- `devflow/runs/{ID}
|
|
37
|
-
- `devflow/runs/{ID}
|
|
38
|
-
- `devflow/runs/{ID}
|
|
39
|
-
- `devflow/runs/{ID}
|
|
40
|
-
- `devflow/runs/{ID}
|
|
36
|
+
- `devflow/runs/{ID}-*10-define.md`
|
|
37
|
+
- `devflow/runs/{ID}-*20-spec.md`
|
|
38
|
+
- `devflow/runs/{ID}-*30-plan.md`
|
|
39
|
+
- `devflow/runs/{ID}-*40-implement.md`
|
|
40
|
+
- `devflow/runs/{ID}-*50-verify.md` if present
|
|
41
41
|
|
|
42
42
|
### 2. Classify The Follow-Up
|
|
43
43
|
|
|
@@ -57,7 +57,7 @@ Append the follow-up scope directly to the relevant stage markdown files for the
|
|
|
57
57
|
|
|
58
58
|
### 4. Ask For Confirmation
|
|
59
59
|
|
|
60
|
-
After adding or proposing follow-up subtasks, ask the user to confirm before
|
|
60
|
+
After adding or proposing follow-up subtasks, ask the user to confirm before `40-implement`.
|
|
61
61
|
|
|
62
62
|
## Output
|
|
63
63
|
|
|
@@ -66,18 +66,18 @@ Return:
|
|
|
66
66
|
- follow-up category
|
|
67
67
|
- new phase/subtask plan
|
|
68
68
|
- validation result
|
|
69
|
-
- next command:
|
|
69
|
+
- next command: `40-implement {ID}`
|
|
70
70
|
|
|
71
71
|
## Relationship To DevFlow 2.0
|
|
72
72
|
|
|
73
73
|
- Classification: Companion command
|
|
74
74
|
- Mainline status: Not a numbered stage
|
|
75
75
|
- Typical entry points: after review, triage, or release follow-up work is identified
|
|
76
|
-
- Typical handoff targets:
|
|
76
|
+
- Typical handoff targets: `10-define`, `20-spec`, `30-plan`, `40-implement`
|
|
77
77
|
|
|
78
78
|
## Sources
|
|
79
79
|
|
|
80
80
|
- `AGENTS.md`
|
|
81
|
-
- Related commands: `PR-Followup`, `Issue-Triage`, `Human-Feedback`,
|
|
81
|
+
- Related commands: `PR-Followup`, `Issue-Triage`, `Human-Feedback`, `10-define`, `20-spec`, `40-implement`
|
|
82
82
|
|
|
83
83
|
|
|
@@ -48,11 +48,11 @@ The Boss first classifies the request into one of these paths:
|
|
|
48
48
|
|
|
49
49
|
| Flow | Use When | Typical Next Step |
|
|
50
50
|
| :--- | :--- | :--- |
|
|
51
|
-
| DevFlow Mainline | New feature, bug, test, docs, migration, or refactor requests. |
|
|
52
|
-
| PRD / Spec Orchestration | Product ideas or requirement-heavy planning before a Discovery ID exists. |
|
|
53
|
-
| Brainstorm Flow | Early ambiguous ideas that need options and tradeoff analysis. |
|
|
54
|
-
| Research Flow | External facts, docs, codebase evidence, or feasibility proof are needed. |
|
|
55
|
-
| RCA / Debug Flow | Failures, errors, regressions, or investigation-heavy bug reports. |
|
|
51
|
+
| DevFlow Mainline | New feature, bug, test, docs, migration, or refactor requests. | `00-discover`, which owns the delivery decision |
|
|
52
|
+
| PRD / Spec Orchestration | Product ideas or requirement-heavy planning before a Discovery ID exists. | `00-discover`, likely routing to `PRD` |
|
|
53
|
+
| Brainstorm Flow | Early ambiguous ideas that need options and tradeoff analysis. | `00-discover`, likely routing to `Brainstorm` |
|
|
54
|
+
| Research Flow | External facts, docs, codebase evidence, or feasibility proof are needed. | `00-discover`, likely routing to `Research` |
|
|
55
|
+
| RCA / Debug Flow | Failures, errors, regressions, or investigation-heavy bug reports. | `00-discover`, likely routing to `Debug` |
|
|
56
56
|
|
|
57
57
|
## Process
|
|
58
58
|
|
|
@@ -124,22 +124,22 @@ Report:
|
|
|
124
124
|
- Classification: Companion command
|
|
125
125
|
- Mainline status: Not a numbered stage
|
|
126
126
|
- Typical entry points: broad goals before a Discovery ID exists
|
|
127
|
-
- Typical handoff target:
|
|
127
|
+
- Typical handoff target: `00-discover`, with a likely companion route recorded as guidance rather than executed outside Discover
|
|
128
128
|
|
|
129
129
|
## Sources
|
|
130
130
|
|
|
131
131
|
- `AGENTS.md`
|
|
132
132
|
- `.agent/scripts/goal-runner.mjs`
|
|
133
|
-
- Related commands:
|
|
133
|
+
- Related commands: `00-discover`, `Brainstorm`, `Research`, `PRD`, `Spec-Orchestrate`, `Debug`
|
|
134
134
|
|
|
135
135
|
## Next Workflow Recommendation
|
|
136
136
|
|
|
137
137
|
- **Primary**: the first command listed in `recommended_commands`
|
|
138
138
|
- **Why**: `Goal` exists to route broad intent into the correct DevFlow 2.0 entry point
|
|
139
139
|
- **Alternatives**:
|
|
140
|
-
-
|
|
141
|
-
-
|
|
142
|
-
-
|
|
140
|
+
- `00-discover "{goal}"` for all new work; Discover chooses Brainstorm, PRD, Research, Debug, or direct decision
|
|
141
|
+
- `10-define {discovery_id}` only after an approved Proceed decision
|
|
142
|
+
- `20-spec {running_id}` only for an existing approved delivery run
|
|
143
143
|
|
|
144
144
|
## Wiki Update Recommendation
|
|
145
145
|
|
|
@@ -77,14 +77,14 @@ Help Summary:
|
|
|
77
77
|
Environment: All OK
|
|
78
78
|
|
|
79
79
|
Active Runs:
|
|
80
|
-
- 010-auth-refactor: stage=40-implement | approval=Pending | next
|
|
81
|
-
- 011-billing-phase-1: stage=20-spec | approval=Approved | next
|
|
82
|
-
- 012-admin-console: stage=50-verify | approval=Approved | next
|
|
80
|
+
- 010-auth-refactor: stage=40-implement | approval=Pending | next=50-verify 010 | warnings: manual review open
|
|
81
|
+
- 011-billing-phase-1: stage=20-spec | approval=Approved | next=30-plan 011
|
|
82
|
+
- 012-admin-console: stage=50-verify | approval=Approved | next=60-report 012 | warnings: not ready for release
|
|
83
83
|
|
|
84
84
|
Recommended Next Action:
|
|
85
|
-
- 010 ->
|
|
86
|
-
- 011 ->
|
|
87
|
-
- 012 ->
|
|
85
|
+
- 010 -> 50-verify 010
|
|
86
|
+
- 011 -> 20-spec 011
|
|
87
|
+
- 012 -> 40-implement 012
|
|
88
88
|
```
|
|
89
89
|
|
|
90
90
|
### Phase C: Manual Review Soft Gate
|
|
@@ -108,13 +108,13 @@ Typical warning shape:
|
|
|
108
108
|
```text
|
|
109
109
|
Manual Review Warning:
|
|
110
110
|
- 014 -> 20-spec.md still shows Approval Status: Pending
|
|
111
|
-
- Recommended action: review 20-spec.md and confirm the next allowed command before moving to
|
|
111
|
+
- Recommended action: review 20-spec.md and confirm the next allowed command before moving to 30-plan 014
|
|
112
112
|
```
|
|
113
113
|
|
|
114
114
|
## DevFlow 2.0 Mainline
|
|
115
115
|
|
|
116
116
|
```text
|
|
117
|
-
|
|
117
|
+
00-discover -> 10-define -> 20-spec -> 30-plan -> 40-implement -> 50-verify -> 60-report -> 70-release
|
|
118
118
|
```
|
|
119
119
|
|
|
120
120
|
## Public Companion Commands
|
|
@@ -163,38 +163,38 @@ These files still exist because their prompt bodies contain useful behavior, but
|
|
|
163
163
|
|
|
164
164
|
### 1. If the user is just starting
|
|
165
165
|
|
|
166
|
-
Recommend
|
|
166
|
+
Recommend `00-discover`. Discover selects `Brainstorm`, `PRD`, `Research`, `Debug`, or direct decision and owns the return synthesis.
|
|
167
167
|
If the request is large, high-risk, multi-phase, or requirement-heavy, explain that the run should use the manual review flow with explicit human approval at each stage.
|
|
168
168
|
|
|
169
169
|
### 2. If an approved discovery needs delivery boundaries
|
|
170
170
|
|
|
171
|
-
Recommend
|
|
171
|
+
Recommend `10-define {discovery_id}` so Define can create one or more Running IDs.
|
|
172
172
|
|
|
173
|
-
If the go/no-go decision is not approved, return to
|
|
173
|
+
If the go/no-go decision is not approved, return to `00-discover {discovery_id}` instead.
|
|
174
174
|
|
|
175
175
|
### 3. If the task is already defined and needs requirements
|
|
176
176
|
|
|
177
|
-
Recommend
|
|
177
|
+
Recommend `20-spec`.
|
|
178
178
|
|
|
179
179
|
### 4. If requirements already exist and implementation planning is next
|
|
180
180
|
|
|
181
|
-
Recommend
|
|
181
|
+
Recommend `30-plan`.
|
|
182
182
|
|
|
183
183
|
### 5. If planning is done and work should begin
|
|
184
184
|
|
|
185
|
-
Recommend
|
|
185
|
+
Recommend `40-implement`.
|
|
186
186
|
|
|
187
187
|
### 6. If implementation exists and needs checking
|
|
188
188
|
|
|
189
|
-
Recommend
|
|
189
|
+
Recommend `50-verify`.
|
|
190
190
|
|
|
191
191
|
### 7. If work is done and needs a final human-friendly summary before release
|
|
192
192
|
|
|
193
|
-
Recommend
|
|
193
|
+
Recommend `60-report`.
|
|
194
194
|
|
|
195
195
|
### 8. If the work needs packaging or release handling after the report is aligned
|
|
196
196
|
|
|
197
|
-
Recommend
|
|
197
|
+
Recommend `70-release`.
|
|
198
198
|
|
|
199
199
|
## General Q And A Role
|
|
200
200
|
|
|
@@ -18,7 +18,7 @@ This skill handles the human review loop after implementation and verification.
|
|
|
18
18
|
|
|
19
19
|
## When to Use
|
|
20
20
|
|
|
21
|
-
- After
|
|
21
|
+
- After `50-verify` when a human must decide whether the work is acceptable
|
|
22
22
|
- When verified work needs non-blocking feedback
|
|
23
23
|
- When review fails and the task must be sent back with explicit action items
|
|
24
24
|
- When a read-only re-evaluation is needed before the human chooses a decision
|
|
@@ -42,23 +42,23 @@ Read only what is necessary to understand the review question and evidence.
|
|
|
42
42
|
|
|
43
43
|
- confirm the task is genuinely review-ready
|
|
44
44
|
- record approval in the current review-facing artifact
|
|
45
|
-
- route to
|
|
45
|
+
- route to `60-report` first, then `70-release` when release execution is the remaining step
|
|
46
46
|
|
|
47
47
|
#### Feedback
|
|
48
48
|
|
|
49
49
|
- record requested improvements without treating them as hard rejection
|
|
50
50
|
- preserve the feedback round and source
|
|
51
|
-
- route to
|
|
51
|
+
- route to `40-implement` or `30-plan` if the feedback changes scope
|
|
52
52
|
|
|
53
53
|
#### Reject
|
|
54
54
|
|
|
55
55
|
- record rejection reason and concrete action items
|
|
56
|
-
- route to
|
|
56
|
+
- route to `40-implement`, `30-plan`, or `Debug` depending on the issue
|
|
57
57
|
|
|
58
58
|
#### Recheck
|
|
59
59
|
|
|
60
60
|
- keep the action read-only unless the user explicitly asks to record it
|
|
61
|
-
- evaluate the evidence and recommend `approve`, `feedback`, `reject`, or
|
|
61
|
+
- evaluate the evidence and recommend `approve`, `feedback`, `reject`, or `50-verify`
|
|
62
62
|
|
|
63
63
|
### 3. Record Reusable Lessons
|
|
64
64
|
|
|
@@ -70,8 +70,8 @@ Use the smallest durable destination:
|
|
|
70
70
|
|
|
71
71
|
- stage artifacts when the lesson is specific to the current run
|
|
72
72
|
- `devflow/lessons.md` for project-wide lessons
|
|
73
|
-
-
|
|
74
|
-
-
|
|
73
|
+
- `60-report` for final narrative communication before release
|
|
74
|
+
- `70-release` for release-facing notes and execution details
|
|
75
75
|
|
|
76
76
|
For token/context learning, prefer the smallest concrete note:
|
|
77
77
|
|
|
@@ -104,22 +104,22 @@ If `post-mortem` was applied, include a short `Source Discipline` note crediting
|
|
|
104
104
|
|
|
105
105
|
- Classification: Companion command
|
|
106
106
|
- Mainline status: Knowledge capture command, not a numbered stage
|
|
107
|
-
- Typical entry points: after `Debug`,
|
|
108
|
-
- Typical handoff targets: `Wiki`,
|
|
107
|
+
- Typical entry points: after `Debug`, `50-verify`, incident work, or review findings
|
|
108
|
+
- Typical handoff targets: `Wiki`, `60-report`, `Help`
|
|
109
109
|
|
|
110
110
|
## Sources
|
|
111
111
|
|
|
112
112
|
- `AGENTS.md`
|
|
113
113
|
- `.agent/resources/schemas/lessons.template.md`
|
|
114
|
-
- Related commands: `Debug`,
|
|
114
|
+
- Related commands: `Debug`, `50-verify`, `Wiki`, `60-report`, `Help`
|
|
115
115
|
|
|
116
116
|
## Next Workflow Recommendation
|
|
117
117
|
|
|
118
118
|
- **Primary**: `Wiki project ingest {source}` when the insight is reusable project knowledge.
|
|
119
119
|
- **Why**: `Insight` extracts lessons; `Wiki` compiles selected lessons into navigable knowledge pages.
|
|
120
120
|
- **Alternatives**:
|
|
121
|
-
-
|
|
122
|
-
-
|
|
121
|
+
- `60-report {ID}` - choose this when the insight should become the final communication summary before release.
|
|
122
|
+
- `70-release {ID}` - choose this when the insight should shape release packaging or execution details.
|
|
123
123
|
- `Help {ID}` - choose this when the next route is unclear.
|
|
124
124
|
|
|
125
125
|
## Wiki Update Recommendation
|
|
@@ -20,7 +20,7 @@ This skill should reuse and align with:
|
|
|
20
20
|
|
|
21
21
|
## When to Use
|
|
22
22
|
|
|
23
|
-
- after
|
|
23
|
+
- after `50-verify`, release preparation, or a completed implementation run
|
|
24
24
|
- after debugging, regression fixes, or incidents that deserve durable learning
|
|
25
25
|
- when reusable project knowledge should move into lessons, wiki material, or final reporting
|
|
26
26
|
|
|
@@ -68,7 +68,7 @@ Prefer:
|
|
|
68
68
|
- stage artifacts when the lesson is run-specific
|
|
69
69
|
- `devflow/lessons.md` for project-wide knowledge
|
|
70
70
|
- `Wiki` when the knowledge should become navigable team documentation
|
|
71
|
-
-
|
|
71
|
+
- `60-report` when the lesson belongs in the final communication package before release
|
|
72
72
|
|
|
73
73
|
When updating `devflow/lessons.md`, use `.agent/resources/schemas/lessons.template.md` and replace placeholder text completely.
|
|
74
74
|
|
|
@@ -81,4 +81,4 @@ Return:
|
|
|
81
81
|
- approach outcome
|
|
82
82
|
- recommendations
|
|
83
83
|
- where the insight was recorded
|
|
84
|
-
- whether `Wiki` or
|
|
84
|
+
- whether `Wiki` or `60-report` should be the next handoff
|
|
@@ -25,7 +25,7 @@ When routing to support skills, follow `docs/skill-selection-policy.md`.
|
|
|
25
25
|
|
|
26
26
|
## Timeline Stages
|
|
27
27
|
|
|
28
|
-
|
|
28
|
+
`00-discover -> 10-define -> 20-spec -> 30-plan -> 40-implement -> 50-verify -> 60-report -> 70-release`
|
|
29
29
|
|
|
30
30
|
## Public Companion Commands
|
|
31
31
|
|
|
@@ -66,14 +66,14 @@ Use these agent mappings when expert judgment is the best next step:
|
|
|
66
66
|
|
|
67
67
|
| User State | Recommended Route |
|
|
68
68
|
|---|---|
|
|
69
|
-
| new request, vague or clear |
|
|
70
|
-
| approved discovery needs one or more delivery boundaries |
|
|
71
|
-
| needs requirements and acceptance criteria |
|
|
72
|
-
| has a stable spec and needs execution plan |
|
|
73
|
-
| needs implementation work |
|
|
74
|
-
| needs testing, review, or validation evidence |
|
|
75
|
-
| needs packaging, commit, PR, or release handling |
|
|
76
|
-
| needs the final summary or handoff narrative |
|
|
69
|
+
| new request, vague or clear | `00-discover`; it selects support inquiry and owns the delivery decision |
|
|
70
|
+
| approved discovery needs one or more delivery boundaries | `10-define {discovery_id}` |
|
|
71
|
+
| needs requirements and acceptance criteria | `20-spec` |
|
|
72
|
+
| has a stable spec and needs execution plan | `30-plan` |
|
|
73
|
+
| needs implementation work | `40-implement` |
|
|
74
|
+
| needs testing, review, or validation evidence | `50-verify` |
|
|
75
|
+
| needs packaging, commit, PR, or release handling | `70-release` |
|
|
76
|
+
| needs the final summary or handoff narrative | `60-report` |
|
|
77
77
|
|
|
78
78
|
## Routing Heuristics
|
|
79
79
|
|
|
@@ -97,9 +97,9 @@ Use these agent mappings when expert judgment is the best next step:
|
|
|
97
97
|
|
|
98
98
|
If `grill-with-docs` is available in the current environment, prefer it as an optional internal support skill for:
|
|
99
99
|
|
|
100
|
-
-
|
|
101
|
-
-
|
|
102
|
-
-
|
|
100
|
+
- `10-define` when scope or terminology is unstable
|
|
101
|
+
- `20-spec` when acceptance criteria or rules are ambiguous
|
|
102
|
+
- `30-plan` when architecture or verification choices are still reversible but unclear
|
|
103
103
|
|
|
104
104
|
Do not use deep questioning by default in every stage. Collect only the information that affects the current Timeline-stage decision.
|
|
105
105
|
|
|
@@ -111,9 +111,9 @@ Do not use deep questioning by default in every stage. Collect only the informat
|
|
|
111
111
|
|
|
112
112
|
If `grill-with-docs` is available in the current environment, prefer it as an optional internal support skill for:
|
|
113
113
|
|
|
114
|
-
-
|
|
115
|
-
-
|
|
116
|
-
-
|
|
114
|
+
- `10-define` when scope or terminology is unstable
|
|
115
|
+
- `20-spec` when acceptance criteria or rules are ambiguous
|
|
116
|
+
- `30-plan` when architecture or verification choices are still reversible but unclear
|
|
117
117
|
|
|
118
118
|
Do not use deep questioning by default in every stage. Collect only the information that affects the current stage decision.
|
|
119
119
|
|
|
@@ -145,18 +145,18 @@ Key conflict defaults:
|
|
|
145
145
|
| `grilling` vs `grill-with-docs` | `grill-with-docs` when a codebase or durable docs matter |
|
|
146
146
|
| `grill-with-docs` vs `domain-modeling` | `grill-with-docs` interviews; `domain-modeling` records confirmed glossary terms or ADRs |
|
|
147
147
|
| `to-prd` vs `PRD` | `PRD` owns the public surface; `to-prd` is an internal synthesis method |
|
|
148
|
-
| `to-issues` vs
|
|
149
|
-
| `implement` vs
|
|
150
|
-
| `review` vs
|
|
148
|
+
| `to-issues` vs `30-plan` | `30-plan` owns work breakdown; `to-issues` packages slices when issue tracker output is needed |
|
|
149
|
+
| `implement` vs `40-implement` | `40-implement` owns implementation |
|
|
150
|
+
| `review` vs `50-verify` | `50-verify` owns verification; `review` is one lane |
|
|
151
151
|
|
|
152
152
|
## Examples
|
|
153
153
|
|
|
154
154
|
| User Request | Route |
|
|
155
155
|
|---|---|
|
|
156
|
-
| "I have an idea but not the shape yet" |
|
|
157
|
-
| "Turn this stable new goal into requirements" |
|
|
158
|
-
| "Fix this newly reported broken auth flow" |
|
|
159
|
-
| "Review this implementation for risks" |
|
|
156
|
+
| "I have an idea but not the shape yet" | `00-discover`, likely `Brainstorm`, then return to Discover |
|
|
157
|
+
| "Turn this stable new goal into requirements" | `00-discover`, then `10-define {discovery_id}` before `20-spec {running_id}` |
|
|
158
|
+
| "Fix this newly reported broken auth flow" | `00-discover`, likely `Debug`, then return to Discover before Define |
|
|
159
|
+
| "Review this implementation for risks" | `50-verify` or `Agent code-reviewer ...` |
|
|
160
160
|
| "Install or upgrade Nexus-DevFlow on this machine" | `Check-For-Updates` |
|
|
161
161
|
| "Help me figure out which command to use" | `Help` |
|
|
162
162
|
|
|
@@ -84,8 +84,8 @@ Use:
|
|
|
84
84
|
- `Debug` for confirmed bugs needing root cause work
|
|
85
85
|
- `Research` or `Spec-Research` for external dependency uncertainty
|
|
86
86
|
- `PRD` for product-level feature requests that need problem framing
|
|
87
|
-
-
|
|
88
|
-
-
|
|
87
|
+
- `10-define` for actionable work that still needs scope decisions
|
|
88
|
+
- `20-spec` for work that is already stable enough to become a delivery contract
|
|
89
89
|
- `Help` when the issue is not actionable yet
|
|
90
90
|
|
|
91
91
|
## Output Triage Recommendation
|
|
@@ -103,13 +103,13 @@ Return:
|
|
|
103
103
|
- Classification: Companion command
|
|
104
104
|
- Mainline status: Intake support command, not a numbered stage
|
|
105
105
|
- Typical entry points: issue intake before scope or implementation begins
|
|
106
|
-
- Typical handoff targets: `Debug`, `PRD`,
|
|
106
|
+
- Typical handoff targets: `Debug`, `PRD`, `10-define`, `Research`, `Help`
|
|
107
107
|
|
|
108
108
|
## Sources
|
|
109
109
|
|
|
110
110
|
- `AGENTS.md`
|
|
111
111
|
- `.agent/resources/schemas/triage.template.md`
|
|
112
|
-
- Related commands: `Debug`, `PRD`,
|
|
112
|
+
- Related commands: `Debug`, `PRD`, `10-define`, `Research`, `Help`
|
|
113
113
|
- Support skills: `triage`, `to-issues`, `domain-modeling`
|
|
114
114
|
|
|
115
115
|
|
|
@@ -59,18 +59,18 @@ You are an orchestrator. Your goal is to safely integrate code and clean up loca
|
|
|
59
59
|
- Classification: Companion command
|
|
60
60
|
- Mainline status: Release support command, not a numbered stage
|
|
61
61
|
- Typical entry points: after `PR` and review gates are complete
|
|
62
|
-
- Typical handoff targets:
|
|
62
|
+
- Typical handoff targets: `70-release`, `Wiki`
|
|
63
63
|
|
|
64
64
|
## Sources
|
|
65
65
|
|
|
66
66
|
- `AGENTS.md`
|
|
67
67
|
- `.agents/skills/release-git-operations/SKILL.md`
|
|
68
68
|
- `.agents/skills/git-workflow-and-versioning/SKILL.md`
|
|
69
|
-
- Related commands: `PR`, `PR-Review`, `PR-Followup`,
|
|
69
|
+
- Related commands: `PR`, `PR-Review`, `PR-Followup`, `60-report`, `70-release`
|
|
70
70
|
|
|
71
71
|
## Next Workflow Recommendation
|
|
72
72
|
|
|
73
|
-
- **Primary**:
|
|
73
|
+
- **Primary**: `70-release`
|
|
74
74
|
- **Why**: after merge, the remaining work is usually release execution, deployment coordination, or final packaging against the already aligned report.
|
|
75
|
-
- **Alternative**:
|
|
75
|
+
- **Alternative**: `60-report` if merge outcomes changed the story enough that the final summary must be refreshed first.
|
|
76
76
|
|
|
@@ -8,15 +8,15 @@ description: "[Devflow] Set up Nexus-DevFlow after overlaying it onto a freshly
|
|
|
8
8
|
Where this sits in the workflow:
|
|
9
9
|
|
|
10
10
|
```text
|
|
11
|
-
scaffold app -> overlay DevFlow -> [onboard] ->
|
|
11
|
+
scaffold app -> overlay DevFlow -> [onboard] -> 00-discover or 10-define -> Mainline Loop
|
|
12
12
|
(user/tool) (create-nexus) (tune setup) (discovery / run scoping) (20-spec -> 70-release)
|
|
13
13
|
```
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
`onboard` is the fresh-project on-ramp for Nexus-DevFlow. It assumes the application was scaffolded first (e.g. via `create-next-app`, `create-vite`, `cargo new`, etc.) and DevFlow was overlaid after.
|
|
16
16
|
|
|
17
|
-
Run
|
|
17
|
+
Run `onboard` before starting discovery or delivery runs. Its job is to make DevFlow fit the real project from day one: detecting commands, project name, coding conventions, ignore rules, and tool adapters.
|
|
18
18
|
|
|
19
|
-
Use
|
|
19
|
+
Use `adopt` instead when the app already has substantial shipped code, working routes, and existing business logic.
|
|
20
20
|
|
|
21
21
|
---
|
|
22
22
|
|
|
@@ -32,7 +32,7 @@ Inspect the repository and context files:
|
|
|
32
32
|
|
|
33
33
|
- If the project is freshly scaffolded with minimal boilerplate, proceed.
|
|
34
34
|
- If `devflow/context/project-overview.md` and `devflow/context/coding-standards.md` already contain rich, user-customized content, do not overwrite them without explicit confirmation.
|
|
35
|
-
- If the repository already has substantial existing routes, controllers, or database models, stop and recommend
|
|
35
|
+
- If the repository already has substantial existing routes, controllers, or database models, stop and recommend `adopt` instead.
|
|
36
36
|
|
|
37
37
|
Never run a framework scaffolder. DevFlow is already overlaid.
|
|
38
38
|
|
|
@@ -125,5 +125,5 @@ Present a concise onboarding summary report:
|
|
|
125
125
|
- Files tuned during onboarding
|
|
126
126
|
- Adapter status (`.agents/`, `.claude/`)
|
|
127
127
|
- Recommended next step:
|
|
128
|
-
- Run `00-discover` (or
|
|
129
|
-
- Run `10-define` (or
|
|
128
|
+
- Run `00-discover` (or `00-discover`, `$00-discover`) to explore the first feature or product direction
|
|
129
|
+
- Run `10-define` (or `10-define`, `$10-define`) if the initial delivery slice is already clear and ready for execution
|
|
@@ -24,7 +24,7 @@ Before parallelizing:
|
|
|
24
24
|
2. identify the lifecycle owner
|
|
25
25
|
3. split the work into independent questions
|
|
26
26
|
|
|
27
|
-
If those conditions are missing, return first to
|
|
27
|
+
If those conditions are missing, return first to `00-discover`, `20-spec`, or `30-plan`.
|
|
28
28
|
|
|
29
29
|
## Basic Invocation Patterns
|
|
30
30
|
|
|
@@ -24,7 +24,7 @@ Decompose work into small, verifiable tasks with explicit acceptance criteria. G
|
|
|
24
24
|
- You need to communicate scope to a human
|
|
25
25
|
- The implementation order isn't obvious
|
|
26
26
|
|
|
27
|
-
In DevFlow 2.0, this skill primarily supports
|
|
27
|
+
In DevFlow 2.0, this skill primarily supports `30-plan`.
|
|
28
28
|
|
|
29
29
|
**When NOT to use:** Single-file changes with obvious scope, or when the spec already contains well-defined tasks.
|
|
30
30
|
|
|
@@ -16,7 +16,7 @@ Primary behavior now lives in:
|
|
|
16
16
|
|
|
17
17
|
Treat this workflow file as a compatibility wrapper around that skill in `pr` mode.
|
|
18
18
|
|
|
19
|
-
In DevFlow 2.0, this is a release-adjacent workflow. It usually follows
|
|
19
|
+
In DevFlow 2.0, this is a release-adjacent workflow. It usually follows `60-report` and pairs naturally with `70-release` once the final summary is aligned.
|
|
20
20
|
|
|
21
21
|
---
|
|
22
22
|
|
|
@@ -31,7 +31,7 @@ You are an orchestrator. Your goal is to call the specialized Git PR Maker agent
|
|
|
31
31
|
- Ensure the branch is not `main` or `master`.
|
|
32
32
|
- Check for unpushed commits.
|
|
33
33
|
- Verify the working directory is clean enough for PR submission.
|
|
34
|
-
- Confirm the implementation has already passed the expected verification gate. If it has not, route back to
|
|
34
|
+
- Confirm the implementation has already passed the expected verification gate. If it has not, route back to `50-verify` first.
|
|
35
35
|
|
|
36
36
|
### Phase 2: Context And Template
|
|
37
37
|
|
|
@@ -75,19 +75,19 @@ Verify that the workflow returns:
|
|
|
75
75
|
|
|
76
76
|
- Classification: Companion command
|
|
77
77
|
- Mainline status: Release support command, not a numbered stage
|
|
78
|
-
- Typical entry points:
|
|
79
|
-
- Typical handoff targets: `PR-Review`, `PR-Followup`, `Merge`,
|
|
78
|
+
- Typical entry points: `70-release`, `Commit`
|
|
79
|
+
- Typical handoff targets: `PR-Review`, `PR-Followup`, `Merge`, `70-release`
|
|
80
80
|
|
|
81
81
|
## Sources
|
|
82
82
|
|
|
83
83
|
- `AGENTS.md`
|
|
84
84
|
- `.agents/skills/release-git-operations/SKILL.md`
|
|
85
85
|
- `.agents/skills/git-workflow-and-versioning/SKILL.md`
|
|
86
|
-
- Related commands: `Commit`, `PR-Review`, `PR-Followup`, `Merge`,
|
|
86
|
+
- Related commands: `Commit`, `PR-Review`, `PR-Followup`, `Merge`, `60-report`, `70-release`
|
|
87
87
|
|
|
88
88
|
## Next Workflow Recommendation
|
|
89
89
|
|
|
90
|
-
- **Primary**:
|
|
90
|
+
- **Primary**: `70-release`
|
|
91
91
|
- **Why**: after PR creation, release execution and handoff details should stay consistent with the approved report.
|
|
92
|
-
- **Alternative**: `PR-Review` for structured review before broader sharing, or
|
|
92
|
+
- **Alternative**: `PR-Review` for structured review before broader sharing, or `60-report` when the final communication summary still needs to be refreshed first.
|
|
93
93
|
|
|
@@ -9,7 +9,7 @@ description: "[Devflow] PR Review Addon - Review a pull request using GitHub rev
|
|
|
9
9
|
|
|
10
10
|
Use this workflow when you need a structured PR review without creating or changing the PR. It can review a local diff, a PR URL or number, or a task-linked branch.
|
|
11
11
|
|
|
12
|
-
In DevFlow 2.0, this remains a supporting review workflow. It should feed corrective work back into
|
|
12
|
+
In DevFlow 2.0, this remains a supporting review workflow. It should feed corrective work back into `40-implement` or clear the path toward `60-report` and then `70-release`.
|
|
13
13
|
|
|
14
14
|
Primary behavior now lives in the `pr-review-analysis` skill. Keep this workflow as the compatibility wrapper and user-facing review prompt surface.
|
|
15
15
|
|
|
@@ -123,21 +123,21 @@ devflow/runs/{ID}-*/pr_review.md
|
|
|
123
123
|
|
|
124
124
|
- Classification: Companion command
|
|
125
125
|
- Mainline status: Verification and release support command, not a numbered stage
|
|
126
|
-
- Typical entry points:
|
|
127
|
-
- Typical handoff targets: `PR-Followup`,
|
|
126
|
+
- Typical entry points: `50-verify`, `PR`, `Agent code-reviewer`
|
|
127
|
+
- Typical handoff targets: `PR-Followup`, `60-report`, `70-release`, `Wiki`
|
|
128
128
|
|
|
129
129
|
## Sources
|
|
130
130
|
|
|
131
131
|
- `AGENTS.md`
|
|
132
132
|
- `.agent/resources/schemas/pr_review.template.md`
|
|
133
|
-
- Related commands:
|
|
133
|
+
- Related commands: `50-verify`, `PR`, `PR-Followup`, `Agent`, `60-report`, `70-release`, `Wiki`
|
|
134
134
|
|
|
135
135
|
## Next Workflow Recommendation
|
|
136
136
|
|
|
137
|
-
- **Primary**:
|
|
137
|
+
- **Primary**: `40-implement {ID}` when review finds required fixes, or `60-report {ID}` when the review is clean and the run needs the final summary refreshed before release execution.
|
|
138
138
|
- **Why**: PR review either creates corrective implementation work or clears the path toward final summary alignment and release-facing packaging.
|
|
139
139
|
- **Alternatives**:
|
|
140
|
-
-
|
|
140
|
+
- `70-release` when the report is already aligned and only release execution remains
|
|
141
141
|
- `Wiki` when the review establishes a durable convention or risk pattern
|
|
142
142
|
- `PR-Followup {target}` when the PR already has comments that need classification and response
|
|
143
143
|
|
|
@@ -20,7 +20,7 @@ This skill should reuse and align with:
|
|
|
20
20
|
|
|
21
21
|
## When to Use
|
|
22
22
|
|
|
23
|
-
- after
|
|
23
|
+
- after `50-verify` when the change needs structured review before `60-report` and `70-release`
|
|
24
24
|
- when a local diff, branch, or pull request needs findings-first analysis
|
|
25
25
|
- when the user wants review without directly editing code
|
|
26
26
|
|
|
@@ -86,4 +86,4 @@ Return:
|
|
|
86
86
|
- open questions or assumptions
|
|
87
87
|
- residual risks or test gaps
|
|
88
88
|
- where the review report was saved
|
|
89
|
-
- the recommended next route such as
|
|
89
|
+
- the recommended next route such as `40-implement`, `70-release`, or `PR-Followup`
|