@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
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---name: insight
|
|
2
2
|
|
|
3
|
-
description:
|
|
3
|
+
description: "[Devflow] Extract reusable lessons, patterns, file insights, and post-mortem learning from completed work."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Phase 54: Insight Extraction
|
|
@@ -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
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: insight-capture
|
|
3
|
-
description: Extract durable lessons, patterns, gotchas, and post-mortem knowledge from completed work. Use when implementation or verification work should become reusable team knowledge.
|
|
3
|
+
description: "[Devflow] Extract durable lessons, patterns, gotchas, and post-mortem knowledge from completed work. Use when implementation or verification work should become reusable team knowledge."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Insight Capture
|
|
@@ -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
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: intelligent-routing
|
|
3
|
-
description: Automatic agent and stage routing for DevFlow 2.0. Use when deciding which active workflow, skill, or specialist should own the next step.
|
|
3
|
+
description: "[Devflow] Automatic agent and stage routing for DevFlow 2.0. Use when deciding which active workflow, skill, or specialist should own the next step."
|
|
4
4
|
version: 2.0.0
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -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
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: issue-triage
|
|
3
|
-
description:
|
|
3
|
+
description: "[Devflow] Intake, categorize, and prioritize incoming issues and bug reports before delivery commitment."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
---
|
|
@@ -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
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: lint-and-validate
|
|
3
|
-
description: Automatic quality control, linting, and static analysis procedures. Use after every code modification to ensure syntax correctness and project standards. Triggers onKeywords: lint, format, check, validate, types, static analysis.
|
|
3
|
+
description: "[Devflow] Automatic quality control, linting, and static analysis procedures. Use after every code modification to ensure syntax correctness and project standards. Triggers onKeywords: lint, format, check, validate, types, static analysis."
|
|
4
4
|
allowed-tools: Read, Glob, Grep, Bash
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: mcp-builder
|
|
3
|
-
description: MCP (Model Context Protocol) server building principles. Tool design, resource patterns, best practices.
|
|
3
|
+
description: "[Devflow] MCP (Model Context Protocol) server building principles. Tool design, resource patterns, best practices."
|
|
4
4
|
allowed-tools: Read, Write, Edit, Glob, Grep
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: md2html
|
|
3
|
-
description: Convert long-form Markdown (plan, spec, system design, RFC, runbook, postmortem, brainstorm, notes) into a single self-contained HTML page with Mermaid diagrams, step timelines, callouts, sidebar TOC. Claude-orange light+dark theme. Multi-language. Portable across Claude Code / Codex / Antigravity / any AI agent.
|
|
3
|
+
description: "[Devflow] Convert long-form Markdown (plan, spec, system design, RFC, runbook, postmortem, brainstorm, notes) into a single self-contained HTML page with Mermaid diagrams, step timelines, callouts, sidebar TOC. Claude-orange light+dark theme. Multi-language. Portable across Claude Code / Codex / Antigravity / any AI agent."
|
|
4
4
|
trigger: /md2html
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---name: merge
|
|
2
2
|
|
|
3
|
-
description:
|
|
3
|
+
description: "[Devflow] Safe PR branch merge into base branch, cleanup, and release readiness check."
|
|
4
4
|
---
|
|
5
5
|
# Smart Merge (Git Orchestration)
|
|
6
6
|
|
|
@@ -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
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: mobile-design
|
|
3
|
-
description: Mobile-first design thinking and decision-making for iOS and Android apps. Touch interaction, performance patterns, platform conventions. Teaches principles, not fixed values. Use when building React Native, Flutter, or native mobile apps.
|
|
3
|
+
description: "[Devflow] Mobile-first design thinking and decision-making for iOS and Android apps. Touch interaction, performance patterns, platform conventions. Teaches principles, not fixed values. Use when building React Native, Flutter, or native mobile apps."
|
|
4
4
|
allowed-tools: Read, Glob, Grep, Bash
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: react-best-practices
|
|
3
|
-
description: React and Next.js performance optimization from Vercel Engineering. Use when building React components, optimizing performance, eliminating waterfalls, reducing bundle size, reviewing code for performance issues, or implementing server/client-side optimizations.
|
|
3
|
+
description: "[Devflow] React and Next.js performance optimization from Vercel Engineering. Use when building React components, optimizing performance, eliminating waterfalls, reducing bundle size, reviewing code for performance issues, or implementing server/client-side optimizations."
|
|
4
4
|
allowed-tools: Read, Write, Edit, Glob, Grep, Bash
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: nodejs-best-practices
|
|
3
|
-
description: Node.js development principles and decision-making. Framework selection, async patterns, security, and architecture. Teaches thinking, not copying.
|
|
3
|
+
description: "[Devflow] Node.js development principles and decision-making. Framework selection, async patterns, security, and architecture. Teaches thinking, not copying."
|
|
4
4
|
allowed-tools: Read, Write, Edit, Glob, Grep
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: onboard
|
|
3
|
-
description: Set up Nexus-DevFlow after overlaying it onto a freshly scaffolded or early
|
|
3
|
+
description: "[Devflow] Set up Nexus-DevFlow after overlaying it onto a freshly scaffolded or early-stage project."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# onboard - Finish the Nexus-DevFlow Setup for Fresh Projects
|
|
@@ -8,15 +8,15 @@ description: Set up Nexus-DevFlow after overlaying it onto a freshly scaffolded
|
|
|
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
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: package-json-generator
|
|
3
|
-
description: Generates or updates a package.json file with standardized npm scripts for the project. Automatically migrates tasks from .vscode/tasks.json if present. Use when initializing npm scripts, migrating from VS Code tasks, or setting up a centralized task runner.
|
|
3
|
+
description: "[Devflow] Generates or updates a package.json file with standardized npm scripts for the project. Automatically migrates tasks from .vscode/tasks.json if present. Use when initializing npm scripts, migrating from VS Code tasks, or setting up a centralized task runner."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Package JSON Generator
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: parallel-agents
|
|
3
|
-
description: Multi-agent orchestration patterns for the current DevFlow 2.0 specialist set. Use when multiple independent analyses or implementation perspectives can run in parallel.
|
|
3
|
+
description: "[Devflow] Multi-agent orchestration patterns for the current DevFlow 2.0 specialist set. Use when multiple independent analyses or implementation perspectives can run in parallel."
|
|
4
4
|
allowed-tools: Read, Glob, Grep
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -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
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: performance-optimization
|
|
3
|
-
description: Optimizes application performance. Use when performance requirements exist, when you suspect performance regressions, or when Core Web Vitals or load times need improvement. Use when profiling reveals bottlenecks that need fixing.
|
|
3
|
+
description: "[Devflow] Optimizes application performance. Use when performance requirements exist, when you suspect performance regressions, or when Core Web Vitals or load times need improvement. Use when profiling reveals bottlenecks that need fixing."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Performance Optimization
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: planning-and-task-breakdown
|
|
3
|
-
description: Breaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.
|
|
3
|
+
description: "[Devflow] Breaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Planning and Task Breakdown
|
|
@@ -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
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: powershell-windows
|
|
3
|
-
description: PowerShell Windows patterns. Critical pitfalls, operator syntax, error handling.
|
|
3
|
+
description: "[Devflow] PowerShell Windows patterns. Critical pitfalls, operator syntax, error handling."
|
|
4
4
|
allowed-tools: Read, Write, Edit, Glob, Grep, Bash
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---name: pr
|
|
2
2
|
|
|
3
|
-
description:
|
|
3
|
+
description: "[Devflow] Pull Request creation with automated change summaries, verification evidence, and linked stage artifacts."
|
|
4
4
|
---
|
|
5
5
|
# Create Pull Request (Git Orchestration)
|
|
6
6
|
|
|
@@ -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
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---name: pr-review
|
|
2
2
|
|
|
3
|
-
description: PR Review Addon - Review a pull request using GitHub review prompt patterns and the credited 9arm-skills/scrutinize discipline.
|
|
3
|
+
description: "[Devflow] PR Review Addon - Review a pull request using GitHub review prompt patterns and the credited 9arm-skills/scrutinize discipline."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Phase 55: PR Review Addon
|
|
@@ -9,7 +9,7 @@ description: PR Review Addon - Review a pull request using GitHub review prompt
|
|
|
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
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: pr-review-analysis
|
|
3
|
-
description: Review pull requests or local diffs with structured finding discipline, selective review lanes, and Nexus-DevFlow report templates. Use when the team needs a substantial review without turning review into a numbered workflow stage.
|
|
3
|
+
description: "[Devflow] Review pull requests or local diffs with structured finding discipline, selective review lanes, and Nexus-DevFlow report templates. Use when the team needs a substantial review without turning review into a numbered workflow stage."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# PR Review Analysis
|
|
@@ -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`
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: prd
|
|
3
|
-
description:
|
|
3
|
+
description: "[Devflow] Product Requirements Document drafting, user story mapping, and feature scoping before delivery commitment."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
---
|
|
@@ -12,9 +12,9 @@ description: Strategic PRD Generator (Orchestration) - Transform a product or fe
|
|
|
12
12
|
|
|
13
13
|
Transform a product or feature idea into a problem-first, hypothesis-driven Product Requirements Document (PRD).
|
|
14
14
|
|
|
15
|
-
In DevFlow 2.0, this is a supporting workflow, not part of the numbered mainline state path. Use it when the idea is still too product-shaped for
|
|
15
|
+
In DevFlow 2.0, this is a supporting workflow, not part of the numbered mainline state path. Use it when the idea is still too product-shaped for `10-define` or `20-spec` to proceed cleanly.
|
|
16
16
|
Use `to-prd` when existing conversation, discovery, or codebase context is already sufficient and the job is synthesis rather than another interview.
|
|
17
|
-
When invoked from
|
|
17
|
+
When invoked from `00-discover`, link the PRD to the Discovery ID and return to `00-discover {discovery_id}` for the final `Proceed`, `Defer`, or `Reject` decision. PRD does not create Running IDs.
|
|
18
18
|
|
|
19
19
|
---
|
|
20
20
|
|
|
@@ -56,7 +56,7 @@ You are an orchestrator. Your goal is to call the specialized PRD Architect agen
|
|
|
56
56
|
- explicit assumptions
|
|
57
57
|
- open questions
|
|
58
58
|
- risks that should remain visible before delivery planning
|
|
59
|
-
- Do not let the PRD silently drift into implementation detail that belongs in
|
|
59
|
+
- Do not let the PRD silently drift into implementation detail that belongs in `20-spec` or `30-plan`.
|
|
60
60
|
|
|
61
61
|
### Phase 4: Output Generation
|
|
62
62
|
|
|
@@ -84,10 +84,10 @@ devflow/prds/{date}-{slug}.prd.md
|
|
|
84
84
|
|
|
85
85
|
Convert the PRD into explicit next steps for the Timeline flow:
|
|
86
86
|
|
|
87
|
-
-
|
|
88
|
-
-
|
|
89
|
-
-
|
|
90
|
-
-
|
|
87
|
+
- `00-discover {discovery_id}` when the PRD belongs to an active discovery
|
|
88
|
+
- `10-define` when product framing was created outside Discover and delivery has already been approved
|
|
89
|
+
- `20-spec` when the delivery contract is ready to be locked
|
|
90
|
+
- `30-plan {ID}` only after the spec is execution-ready
|
|
91
91
|
|
|
92
92
|
The user should still approve the transition into execution work. Do not treat PRD generation as automatic task creation.
|
|
93
93
|
|
|
@@ -110,18 +110,18 @@ Return:
|
|
|
110
110
|
- Classification: Companion command
|
|
111
111
|
- Mainline status: Not a numbered stage
|
|
112
112
|
- Typical entry points: product framing before implementation-ready scope exists
|
|
113
|
-
- Typical handoff targets:
|
|
113
|
+
- Typical handoff targets: `00-discover {discovery_id}`, `10-define`, `20-spec`, `Roadmap`, `Spec-Orchestrate`
|
|
114
114
|
|
|
115
115
|
## Sources
|
|
116
116
|
|
|
117
117
|
- `AGENTS.md`
|
|
118
118
|
- `.agent/resources/schemas/prd.template.md`
|
|
119
|
-
- Related commands: `Brainstorm`, `Research`,
|
|
119
|
+
- Related commands: `Brainstorm`, `Research`, `10-define`, `20-spec`, `Roadmap`, `Spec-Orchestrate`
|
|
120
120
|
- Support skills: `to-prd`, `grill-with-docs`, `domain-modeling`
|
|
121
121
|
|
|
122
122
|
## Next Workflow Recommendation
|
|
123
123
|
|
|
124
|
-
- **Primary**:
|
|
124
|
+
- **Primary**: `00-discover {discovery_id}` when invoked from discovery; otherwise `10-define`
|
|
125
125
|
- **Why**: PRD shapes product intent, while Discover owns the delivery decision and Define owns Running ID creation.
|
|
126
126
|
- **Alternative**: `Research` when technical feasibility or external dependencies are still unresolved.
|
|
127
127
|
|