@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
|
@@ -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
|
-
|
|
16
|
+
70-release {running-id or workspace path}
|
|
17
17
|
```
|
|
18
18
|
|
|
19
19
|
Use this when:
|
|
20
20
|
|
|
21
|
-
-
|
|
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}
|
|
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
|
|
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
|
|
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:
|
|
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:
|
|
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
|
-
-
|
|
146
|
-
-
|
|
147
|
-
-
|
|
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
|
|
154
|
-
- Return to
|
|
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 ->
|
|
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
|
-
|
|
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
|
|
95
|
-
- Run `10-define` (or
|
|
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-
|
|
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
|
|
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
|
|
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
|
|
@@ -8,7 +8,7 @@ description: "[Devflow] Optional explicit mode for one bounded spec/plan/impleme
|
|
|
8
8
|
Where this sits in the workflow:
|
|
9
9
|
|
|
10
10
|
```text
|
|
11
|
-
|
|
11
|
+
devflow -> [autopilot] -> review packet -> 70-release
|
|
12
12
|
(where (spec, plan, (human review, (package, PR,
|
|
13
13
|
are we?) build, verify, walkthrough) merge with approval)
|
|
14
14
|
report)
|
|
@@ -16,7 +16,7 @@ Where this sits in the workflow:
|
|
|
16
16
|
|
|
17
17
|
Autopilot is an explicit opt-in execution skill for Nexus-DevFlow 2.0. It runs a single bounded loop across the delivery lifecycle (**`20-spec` -> `30-plan` -> `40-implement` -> `50-verify` -> `60-report`**) without requiring human confirmation between every sub-step.
|
|
18
18
|
|
|
19
|
-
It does **not** replace the normal step-by-step workflow. Mainline commands (
|
|
19
|
+
It does **not** replace the normal step-by-step workflow. Mainline commands (`20-spec`, `30-plan`, `40-implement`, `50-verify`, `60-report`, `70-release`) remain the conservative default.
|
|
20
20
|
|
|
21
21
|
Do not suggest Autopilot as the default next action. Use it only when the user explicitly asks for it.
|
|
22
22
|
|
|
@@ -27,14 +27,14 @@ The explicit Autopilot request is permission to create checkpoint commits on the
|
|
|
27
27
|
Common forms:
|
|
28
28
|
|
|
29
29
|
- **No argument**: resume the active run in `devflow/context/current-stage.md`, or target the next planned run/feature in `devflow/context/project-overview.md`.
|
|
30
|
-
- **Running ID or feature name**: target that run, e.g.
|
|
30
|
+
- **Running ID or feature name**: target that run, e.g. `autopilot RUN-004` or `autopilot "add user authentication"`.
|
|
31
31
|
- **`fix "<issue>"`**: write and execute an ad-hoc fix run.
|
|
32
32
|
- **`resume`**: continue the current active run on its existing branch.
|
|
33
33
|
|
|
34
34
|
If the requested target conflicts with a run already in progress, stop and ask which one should win. Do not overwrite active stage artifacts silently.
|
|
35
35
|
|
|
36
36
|
> [!IMPORTANT]
|
|
37
|
-
> Rollback is intentionally excluded from Autopilot. If the request is a rollback or the stage is marked Rollback, stop and direct the user to
|
|
37
|
+
> Rollback is intentionally excluded from Autopilot. If the request is a rollback or the stage is marked Rollback, stop and direct the user to `rollback` and reviewed `40-implement`. Reversing completed work requires explicit dependency and human review gates.
|
|
38
38
|
|
|
39
39
|
---
|
|
40
40
|
|
|
@@ -61,7 +61,7 @@ Stop before changing files when:
|
|
|
61
61
|
|
|
62
62
|
## Step 2 - Choose or Write Specification (`20-spec`)
|
|
63
63
|
|
|
64
|
-
1. If `devflow/runs/{running-id}-{slug}
|
|
64
|
+
1. If `devflow/runs/{running-id}-{slug}20-spec.md` already exists, resume it.
|
|
65
65
|
2. If no spec exists:
|
|
66
66
|
- Ensure `10-define.md` exists with locked scope and allocated Running ID.
|
|
67
67
|
- Write `20-spec.md` following the DevFlow specification schema.
|
|
@@ -77,7 +77,7 @@ Stop before changing files when:
|
|
|
77
77
|
- Fix: `fix/{slug}-{running-id}`
|
|
78
78
|
- Switch to or create the working branch. Never run Autopilot directly on `main` or `master`.
|
|
79
79
|
2. **Planning**:
|
|
80
|
-
- Write `devflow/runs/{running-id}-{slug}
|
|
80
|
+
- Write `devflow/runs/{running-id}-{slug}30-plan.md`.
|
|
81
81
|
- Seed `checklists/implementation-checklist.md` and `checklists/verification-checklist.md`.
|
|
82
82
|
|
|
83
83
|
---
|
|
@@ -99,7 +99,7 @@ For every subtask:
|
|
|
99
99
|
git add <modified-files> devflow/runs/{running-id}-{slug}/checklists/implementation-checklist.md
|
|
100
100
|
git commit -m "feat({running-id}): checkpoint <concise step description>"
|
|
101
101
|
```
|
|
102
|
-
8. Write `devflow/runs/{running-id}-{slug}
|
|
102
|
+
8. Write `devflow/runs/{running-id}-{slug}40-implement.md`.
|
|
103
103
|
|
|
104
104
|
---
|
|
105
105
|
|
|
@@ -111,7 +111,7 @@ For every subtask:
|
|
|
111
111
|
- Project test suite (Unit tests, integration tests)
|
|
112
112
|
- Build / Package smoke tests
|
|
113
113
|
2. Update `checklists/verification-checklist.md` with concrete evidence.
|
|
114
|
-
3. Write `devflow/runs/{running-id}-{slug}
|
|
114
|
+
3. Write `devflow/runs/{running-id}-{slug}50-verify.md` with QA verdict (`PASS` / `FAIL`).
|
|
115
115
|
|
|
116
116
|
---
|
|
117
117
|
|
|
@@ -129,9 +129,9 @@ Review diffs and inspect `devflow/context/findings.md`:
|
|
|
129
129
|
|
|
130
130
|
## Step 7 - Delivery Digest & Review Packet (`60-report`)
|
|
131
131
|
|
|
132
|
-
1. Write `devflow/runs/{running-id}-{slug}
|
|
133
|
-
2. Render standalone HTML dashboard `devflow/runs/{running-id}-{slug}
|
|
134
|
-
3. Update `devflow/context/current-stage.md` to indicate ready for
|
|
132
|
+
1. Write `devflow/runs/{running-id}-{slug}60-report.md`.
|
|
133
|
+
2. Render standalone HTML dashboard `devflow/runs/{running-id}-{slug}60-report.html` (via `md2html` or report generator).
|
|
134
|
+
3. Update `devflow/context/current-stage.md` to indicate ready for `70-release`.
|
|
135
135
|
4. Stop with a concise **Review Packet Dashboard** for human approval.
|
|
136
136
|
|
|
137
137
|
---
|
|
@@ -159,17 +159,17 @@ When Autopilot finishes successfully, output a scannable review packet:
|
|
|
159
159
|
- **Branch**: `{branch-name}`
|
|
160
160
|
- **Target Run**: `{running-id} - {title}`
|
|
161
161
|
- **Artifacts Generated**:
|
|
162
|
-
- Spec: `devflow/runs/{id}
|
|
163
|
-
- Plan: `devflow/runs/{id}
|
|
164
|
-
- Implement Evidence: `devflow/runs/{id}
|
|
165
|
-
- QA Verify Report: `devflow/runs/{id}
|
|
166
|
-
- Digest Report: `devflow/runs/{id}
|
|
167
|
-
- HTML Dashboard: `devflow/runs/{id}
|
|
162
|
+
- Spec: `devflow/runs/{id}20-spec.md`
|
|
163
|
+
- Plan: `devflow/runs/{id}30-plan.md`
|
|
164
|
+
- Implement Evidence: `devflow/runs/{id}40-implement.md`
|
|
165
|
+
- QA Verify Report: `devflow/runs/{id}50-verify.md`
|
|
166
|
+
- Digest Report: `devflow/runs/{id}60-report.md`
|
|
167
|
+
- HTML Dashboard: `devflow/runs/{id}60-report.html`
|
|
168
168
|
- **Validation & Tests**: `All Passed (Green)`
|
|
169
169
|
- **Checkpoint Commits**: `{count} commits created on {branch-name}`
|
|
170
|
-
- **Manual QA Walkthrough**: Run
|
|
170
|
+
- **Manual QA Walkthrough**: Run `try {running-id}` for human review guide
|
|
171
171
|
|
|
172
172
|
---
|
|
173
173
|
👉 **Next Recommended Action**:
|
|
174
|
-
Inspect diffs and
|
|
174
|
+
Inspect diffs and `try` walkthrough, then run `70-release {running-id}` to package, merge, or create PR.
|
|
175
175
|
```
|
|
@@ -24,10 +24,10 @@ Use it when:
|
|
|
24
24
|
|
|
25
25
|
Preferred DevFlow 2.0 pairing:
|
|
26
26
|
|
|
27
|
-
- from
|
|
28
|
-
- from
|
|
27
|
+
- from `00-discover` when the request is still fuzzy
|
|
28
|
+
- from `10-define` when the direction is still unstable
|
|
29
29
|
|
|
30
|
-
When invoked with a Discovery ID, link the brainstorming report to that discovery and return to
|
|
30
|
+
When invoked with a Discovery ID, link the brainstorming report to that discovery and return to `00-discover {discovery_id}` for synthesis. Do not allocate a Running ID or jump directly from a discovery-owned brainstorm into Define.
|
|
31
31
|
|
|
32
32
|
## Behavior
|
|
33
33
|
|
|
@@ -145,24 +145,24 @@ Brainstorm caching strategy
|
|
|
145
145
|
- Honest tradeoffs over fake confidence
|
|
146
146
|
- Multiple viable paths before recommending one
|
|
147
147
|
- Persistent output saved to disk
|
|
148
|
-
- Mainline remains:
|
|
148
|
+
- Mainline remains: `00-discover -> 10-define -> 20-spec -> 30-plan -> 40-implement -> 50-verify -> 60-report -> 70-release`
|
|
149
149
|
|
|
150
150
|
## Relationship To DevFlow 2.0
|
|
151
151
|
|
|
152
152
|
- Classification: Companion command
|
|
153
153
|
- Mainline status: Not a numbered stage
|
|
154
|
-
- Typical entry points:
|
|
155
|
-
- Typical handoff targets:
|
|
154
|
+
- Typical entry points: `00-discover`, `10-define`
|
|
155
|
+
- Typical handoff targets: `00-discover {discovery_id}` for discovery-owned work, or the active numbered stage for run-owned work
|
|
156
156
|
|
|
157
157
|
## Sources
|
|
158
158
|
|
|
159
159
|
- `AGENTS.md`
|
|
160
160
|
- `.agent/resources/schemas/brainstorm.template.md`
|
|
161
|
-
- Related commands:
|
|
161
|
+
- Related commands: `00-discover`, `10-define`, `Research`, `PRD`, `20-spec`
|
|
162
162
|
|
|
163
163
|
## Next Workflow Recommendation
|
|
164
164
|
|
|
165
|
-
- Default: return to
|
|
165
|
+
- Default: return to `00-discover {discovery_id}` when Discover requested the work; otherwise return to the stage that requested it
|
|
166
166
|
- Alternate: `Research` when facts are still missing
|
|
167
|
-
- Alternate:
|
|
167
|
+
- Alternate: `10-define` or `20-spec` only when the work was not opened from a pending discovery
|
|
168
168
|
|
|
@@ -8,7 +8,7 @@ description: "[Devflow] Read-only scope, dependency, and risk pre-briefing befor
|
|
|
8
8
|
Where this sits in the workflow:
|
|
9
9
|
|
|
10
10
|
```text
|
|
11
|
-
10-define or project-overview.md -> [brief] ->
|
|
11
|
+
10-define or project-overview.md -> [brief] -> 20-spec -> 30-plan -> 40-implement
|
|
12
12
|
(proposed scope & context) (read-only (write (break down) (build it)
|
|
13
13
|
explainer) contract)
|
|
14
14
|
```
|
|
@@ -22,10 +22,10 @@ It is **strictly read-only 100%**. It never writes specs, creates directories, b
|
|
|
22
22
|
## Input
|
|
23
23
|
|
|
24
24
|
- **no argument**: briefs the active run in `devflow/context/current-stage.md` (or the first planned feature in `devflow/context/project-overview.md`).
|
|
25
|
-
- **running ID or feature name**: e.g.
|
|
26
|
-
- **topic / concern**: e.g.
|
|
25
|
+
- **running ID or feature name**: e.g. `brief RUN-003`, `brief "OAuth Login"`.
|
|
26
|
+
- **topic / concern**: e.g. `brief "database migration"`.
|
|
27
27
|
|
|
28
|
-
If there is no active run and the overview does not list planned features, plainly report that context is needed and recommend
|
|
28
|
+
If there is no active run and the overview does not list planned features, plainly report that context is needed and recommend `00-discover` or `10-define`.
|
|
29
29
|
|
|
30
30
|
## Step 1 - Read Context (Read-Only)
|
|
31
31
|
|
|
@@ -44,7 +44,7 @@ Evaluate:
|
|
|
44
44
|
- **Depends On**: Required upstream models, tables, APIs, environment variables, or sibling runs.
|
|
45
45
|
- **Unblocks**: Downstream features or workflows that this run enables.
|
|
46
46
|
- **Touches**: Files, modules, API routes, database tables, or UI components likely to change.
|
|
47
|
-
- **Estimated Size**: Small (S), Medium (M), Large (L), or Extra-Large (XL - recommend splitting in
|
|
47
|
+
- **Estimated Size**: Small (S), Medium (M), Large (L), or Extra-Large (XL - recommend splitting in `10-define`).
|
|
48
48
|
- **Open Questions & Risks**: Ambiguous requirements, missing external APIs, or complex migrations.
|
|
49
49
|
|
|
50
50
|
## Step 3 - Output Structured Briefing
|
|
@@ -59,16 +59,16 @@ Produce a short, scannable briefing:
|
|
|
59
59
|
- **Unblocks**: Downstream capabilities enabled by this feature.
|
|
60
60
|
- **Touches**: Anticipated files, schemas, endpoints, and UI views.
|
|
61
61
|
- **Estimated Scope & Size**: `[S / M / L / XL]` (and split recommendation if XL).
|
|
62
|
-
- **Key Risks & Open Questions**: Technical or product unknowns that must be settled in
|
|
62
|
+
- **Key Risks & Open Questions**: Technical or product unknowns that must be settled in `20-spec`.
|
|
63
63
|
|
|
64
64
|
---
|
|
65
|
-
👉 **Next Recommended Action**:
|
|
65
|
+
👉 **Next Recommended Action**: `20-spec {running-id}` (or resolve prerequisite blocker first).
|
|
66
66
|
```
|
|
67
67
|
|
|
68
68
|
## Rules
|
|
69
69
|
|
|
70
70
|
- **Always Read-Only**: Never edit any workspace file, never allocate running IDs, never commit or execute scripts.
|
|
71
|
-
- **Explain, Don't Spec**: Focus on scope, architectural dependencies, and size estimation. The formal delivery contract is the responsibility of
|
|
71
|
+
- **Explain, Don't Spec**: Focus on scope, architectural dependencies, and size estimation. The formal delivery contract is the responsibility of `20-spec`.
|
|
72
72
|
- **Ground In Reality**: Trace all assertions back to `project-overview.md` or actual codebase facts. Do not invent non-existent packages or fictional architecture.
|
|
73
73
|
- **Highlight Blockers Early**: Flagging a missing prerequisite before speccing is the primary value of this command.
|
|
74
74
|
|
|
@@ -96,14 +96,14 @@ When changelog input is too implementation-heavy, apply `.agents/skills/9arm-ski
|
|
|
96
96
|
|
|
97
97
|
- Classification: Companion command
|
|
98
98
|
- Mainline status: Release communication support, not a numbered stage
|
|
99
|
-
- Typical entry points:
|
|
100
|
-
- Typical handoff targets:
|
|
99
|
+
- Typical entry points: `70-release`, `Deploy`, `PR`
|
|
100
|
+
- Typical handoff targets: `60-report`, `Wiki`
|
|
101
101
|
|
|
102
102
|
## Sources
|
|
103
103
|
|
|
104
104
|
- `AGENTS.md`
|
|
105
105
|
- `.agents/skills/release-git-operations/SKILL.md`
|
|
106
106
|
- `.agent/resources/schemas/changelog_entry.template.md`
|
|
107
|
-
- Related commands:
|
|
107
|
+
- Related commands: `70-release`, `Deploy`, `PR`, `60-report`, `Wiki`
|
|
108
108
|
|
|
109
109
|
|
|
@@ -8,7 +8,7 @@ description: "[Devflow] Set up automated GitHub Actions CI workflow (.github/wor
|
|
|
8
8
|
Where this sits in the workflow:
|
|
9
9
|
|
|
10
10
|
```text
|
|
11
|
-
|
|
11
|
+
onboard or adopt -> [ci] -> Verify locally -> GitHub Actions runs Verify on PR & Push
|
|
12
12
|
(project setup) (setup) (same command) (automated checks)
|
|
13
13
|
```
|
|
14
14
|
|
|
@@ -58,7 +58,7 @@ Pull Request Opened
|
|
|
58
58
|
### Basic CI Pipeline
|
|
59
59
|
|
|
60
60
|
```yaml
|
|
61
|
-
# .github/
|
|
61
|
+
# .github/workflowsci.yml
|
|
62
62
|
name: CI
|
|
63
63
|
|
|
64
64
|
on:
|
|
@@ -127,11 +127,11 @@ jobs:
|
|
|
127
127
|
- name: Run migrations
|
|
128
128
|
run: npx prisma migrate deploy
|
|
129
129
|
env:
|
|
130
|
-
DATABASE_URL: postgresql
|
|
130
|
+
DATABASE_URL: postgresql:/ci_user:${{ secrets.CI_DB_PASSWORD }}@localhost:5432/testdb
|
|
131
131
|
- name: Integration tests
|
|
132
132
|
run: npm run test:integration
|
|
133
133
|
env:
|
|
134
|
-
DATABASE_URL: postgresql
|
|
134
|
+
DATABASE_URL: postgresql:/ci_user:${{ secrets.CI_DB_PASSWORD }}@localhost:5432/testdb
|
|
135
135
|
```
|
|
136
136
|
|
|
137
137
|
> **Note:** Even for CI-only test databases, use GitHub Secrets for credentials rather than hardcoding values. This builds good habits and prevents accidental reuse of test credentials in other contexts.
|
|
@@ -5,16 +5,16 @@ description: "[Devflow] Shared vocabulary for designing deep modules. Use when a
|
|
|
5
5
|
|
|
6
6
|
# Codebase Design
|
|
7
7
|
|
|
8
|
-
Use this support skill when
|
|
8
|
+
Use this support skill when `20-spec`, `30-plan`, `40-implement`, or `50-verify` needs better module shape.
|
|
9
9
|
|
|
10
10
|
Design deep modules: a lot of behavior behind a small interface, placed at a clean seam, and testable through that interface. The aim is leverage for callers, locality for maintainers, and behavior-focused tests.
|
|
11
11
|
|
|
12
12
|
## DevFlow Placement
|
|
13
13
|
|
|
14
|
-
-
|
|
15
|
-
-
|
|
16
|
-
-
|
|
17
|
-
-
|
|
14
|
+
- `20-spec`: use when requirements depend on a stable module or interface contract.
|
|
15
|
+
- `30-plan`: use when planning needs file-level architecture, seams, or dependency strategy.
|
|
16
|
+
- `40-implement`: use when implementation reveals shallow modules or awkward test seams.
|
|
17
|
+
- `50-verify`: use when review finds code that is hard to test, hard to change, or too spread out.
|
|
18
18
|
|
|
19
19
|
## Vocabulary
|
|
20
20
|
|
|
@@ -50,14 +50,14 @@ You are an orchestrator. Your goal is to call the specialized Git Committer agen
|
|
|
50
50
|
|
|
51
51
|
- Classification: Companion command
|
|
52
52
|
- Mainline status: Release support command, not a numbered stage
|
|
53
|
-
- Typical entry points:
|
|
54
|
-
- Typical handoff targets: `PR`, `Deploy`,
|
|
53
|
+
- Typical entry points: `70-release` after the report is aligned and release execution is ready
|
|
54
|
+
- Typical handoff targets: `PR`, `Deploy`, `70-release`
|
|
55
55
|
|
|
56
56
|
## Sources
|
|
57
57
|
|
|
58
58
|
- `AGENTS.md`
|
|
59
59
|
- `.agents/skills/release-git-operations/SKILL.md`
|
|
60
60
|
- `.agents/skills/git-workflow-and-versioning/SKILL.md`
|
|
61
|
-
- Related commands:
|
|
61
|
+
- Related commands: `70-release`, `PR`, `Deploy`, `Merge`
|
|
62
62
|
|
|
63
63
|
|
|
@@ -51,9 +51,9 @@ Use `.agent/resources/schemas/competitor_analysis.template.md` when saving a reu
|
|
|
51
51
|
### 5. Route Back
|
|
52
52
|
|
|
53
53
|
- `PRD` for product framing
|
|
54
|
-
-
|
|
54
|
+
- `10-define` for scope and decision shaping
|
|
55
55
|
- `Roadmap` for prioritization
|
|
56
|
-
-
|
|
56
|
+
- `20-spec` when a selected opportunity becomes actionable
|
|
57
57
|
|
|
58
58
|
## Output
|
|
59
59
|
|
|
@@ -27,11 +27,11 @@ Use it when:
|
|
|
27
27
|
|
|
28
28
|
Preferred DevFlow 2.0 pairing:
|
|
29
29
|
|
|
30
|
-
- from
|
|
31
|
-
- from
|
|
32
|
-
- from
|
|
30
|
+
- from `00-discover` when a new request begins with a failure whose root cause is unknown
|
|
31
|
+
- from `40-implement`
|
|
32
|
+
- from `50-verify`
|
|
33
33
|
|
|
34
|
-
When invoked with a Discovery ID, link the RCA report to that discovery and return to
|
|
34
|
+
When invoked with a Discovery ID, link the RCA report to that discovery and return to `00-discover {discovery_id}` for the delivery decision. Do not allocate a Running ID for an unapproved fix during Debug.
|
|
35
35
|
|
|
36
36
|
## Source Discipline
|
|
37
37
|
|
|
@@ -114,18 +114,18 @@ Debug unexpected duplicate records
|
|
|
114
114
|
|
|
115
115
|
- Classification: Companion command
|
|
116
116
|
- Mainline status: Not a numbered stage
|
|
117
|
-
- Typical entry points:
|
|
118
|
-
- Typical handoff targets:
|
|
117
|
+
- Typical entry points: `00-discover`, `40-implement`, `50-verify`, `Issue-Triage`, production failure analysis
|
|
118
|
+
- Typical handoff targets: `00-discover {discovery_id}` for discovery-owned RCA, `40-implement`, `50-verify`, `Insight`, `Wiki`
|
|
119
119
|
|
|
120
120
|
## Sources
|
|
121
121
|
|
|
122
122
|
- `AGENTS.md`
|
|
123
123
|
- `.agent/resources/schemas/rca.template.md`
|
|
124
|
-
- Related commands:
|
|
124
|
+
- Related commands: `40-implement`, `50-verify`, `Test`, `Insight`, `Wiki`, `Agent`
|
|
125
125
|
|
|
126
126
|
## Next Workflow Recommendation
|
|
127
127
|
|
|
128
|
-
- Default: return to
|
|
129
|
-
- Alternate:
|
|
130
|
-
- Alternate:
|
|
128
|
+
- Default: return to `00-discover {discovery_id}` when the failure entered through discovery; otherwise return to `40-implement` when a tracked fix already exists
|
|
129
|
+
- Alternate: `30-plan` if the fix needs planning changes
|
|
130
|
+
- Alternate: `50-verify` when the issue is resolved and needs re-checking
|
|
131
131
|
|
|
@@ -76,8 +76,8 @@ Generate an Error summary detailing:
|
|
|
76
76
|
|
|
77
77
|
- Classification: Companion command
|
|
78
78
|
- Mainline status: Release support command, not a numbered stage
|
|
79
|
-
- Typical entry points:
|
|
80
|
-
- Typical handoff targets:
|
|
79
|
+
- Typical entry points: `70-release` after the report is aligned and packaging is ready to execute
|
|
80
|
+
- Typical handoff targets: `60-report`, `Changelog`, `Wiki`
|
|
81
81
|
|
|
82
82
|
## Sources
|
|
83
83
|
|
|
@@ -86,6 +86,6 @@ Generate an Error summary detailing:
|
|
|
86
86
|
- `.agents/skills/shipping-and-launch/SKILL.md`
|
|
87
87
|
- `.agents/skills/deployment-procedures/SKILL.md`
|
|
88
88
|
- `.agent/resources/schemas/deploy_report.template.md`
|
|
89
|
-
- Related commands:
|
|
89
|
+
- Related commands: `70-release`, `Commit`, `PR`, `Changelog`, `60-report`
|
|
90
90
|
|
|
91
91
|
|
|
@@ -9,14 +9,14 @@ Use this skill to guide the user on what to do next, inspect current workspace s
|
|
|
9
9
|
|
|
10
10
|
## Input
|
|
11
11
|
|
|
12
|
-
- **No argument (`devflow`,
|
|
12
|
+
- **No argument (`devflow`, `devflow`, `$devflow`, or `status`)**: Inspect current workspace state (active run in `devflow/runs/` or `devflow/context/current-stage.md`, active discovery in `devflow/discoveries/`, open findings in `devflow/context/findings.md`, and project overview in `devflow/context/project-overview.md`) and recommend the exact next action.
|
|
13
13
|
- **With user request (`devflow "<request>"`)**: Classify the user's intent and guide them to the matching DevFlow 2.0 stage or companion command path.
|
|
14
14
|
|
|
15
15
|
## Workspace State Inspection
|
|
16
16
|
|
|
17
17
|
When invoked without an argument (or when determining the next step), inspect:
|
|
18
18
|
|
|
19
|
-
1. **Project Setup Baseline**: Read `devflow/context/project-overview.md` and `devflow/context/coding-standards.md`. If they are empty or default placeholders, recommend
|
|
19
|
+
1. **Project Setup Baseline**: Read `devflow/context/project-overview.md` and `devflow/context/coding-standards.md`. If they are empty or default placeholders, recommend `onboard` (for fresh projects) or `adopt` (for existing codebases).
|
|
20
20
|
2. **Active Delivery Run**: Read `devflow/context/current-stage.md` and check `devflow/runs/{RUNNING_ID}/` for active artifacts (`10-define.md`, `20-spec.md`, `30-plan.md`, `40-implement.md`, `50-verify.md`, `60-report.md`, `70-release.md`).
|
|
21
21
|
3. **Active Discovery**: Check `devflow/discoveries/` for open discovery notes.
|
|
22
22
|
4. **Audit Findings Ledger**: Check `devflow/context/findings.md` for open high-severity findings.
|
|
@@ -24,15 +24,15 @@ When invoked without an argument (or when determining the next step), inspect:
|
|
|
24
24
|
### State-Based Recommendation Rules
|
|
25
25
|
|
|
26
26
|
- If context is empty/unconfigured -> Recommend `onboard` (for fresh project) or `adopt` (for brownfield codebase).
|
|
27
|
-
- If a run is at `10-define.md` -> Recommend `20-spec {RUNNING_ID}` (or
|
|
28
|
-
- If a run is at `20-spec.md` -> Recommend `30-plan {RUNNING_ID}` (or
|
|
29
|
-
- If a run is at `30-plan.md` -> Recommend `40-implement {RUNNING_ID}` (or
|
|
27
|
+
- If a run is at `10-define.md` -> Recommend `20-spec {RUNNING_ID}` (or `20-spec`, `$20-spec`, `spec`).
|
|
28
|
+
- If a run is at `20-spec.md` -> Recommend `30-plan {RUNNING_ID}` (or `30-plan`, `$30-plan`, `plan`).
|
|
29
|
+
- If a run is at `30-plan.md` -> Recommend `40-implement {RUNNING_ID}` (or `40-implement`, `$40-implement`, `implement`).
|
|
30
30
|
- If a run is at `40-implement.md` with incomplete tasks -> Recommend `40-implement {RUNNING_ID}`.
|
|
31
|
-
- If a run is at `40-implement.md` with all tasks done -> Recommend `50-verify {RUNNING_ID}` (or
|
|
31
|
+
- If a run is at `40-implement.md` with all tasks done -> Recommend `50-verify {RUNNING_ID}` (or `50-verify`, `$50-verify`, `verify`).
|
|
32
32
|
- If a run passed `50-verify.md` -> Recommend `60-report {RUNNING_ID}` then `70-release {RUNNING_ID}`.
|
|
33
33
|
- If no run is active and user wants to explore an idea -> Recommend `00-discover` (or `discover`, `Brainstorm`).
|
|
34
34
|
- If no run is active and open P0/P1 findings exist -> Recommend `security-review` or `debug`.
|
|
35
|
-
- If user asks to check system health or configuration -> Recommend `doctor` (or
|
|
35
|
+
- If user asks to check system health or configuration -> Recommend `doctor` (or `doctor`, `$doctor`).
|
|
36
36
|
|
|
37
37
|
## Intent Classification & Skill Routing
|
|
38
38
|
|
|
@@ -71,25 +71,25 @@ When the user specifies a request, map it to the matching DevFlow 2.0 stage or c
|
|
|
71
71
|
Always provide a clean summary of available Nexus-DevFlow skills grouped by lifecycle stage:
|
|
72
72
|
|
|
73
73
|
### 1. Mainline Lifecycle Stages (Linear Order)
|
|
74
|
-
- `00-discover` (`discover`,
|
|
75
|
-
- `10-define` (`define`,
|
|
76
|
-
- `20-spec` (`spec`,
|
|
77
|
-
- `30-plan` (`plan`,
|
|
78
|
-
- `40-implement` (`implement`,
|
|
79
|
-
- `50-verify` (`verify`,
|
|
80
|
-
- `60-report` (`report`,
|
|
81
|
-
- `70-release` (`release`,
|
|
74
|
+
- `00-discover` (`discover`, `00-discover`, `$00-discover`) - Explore request, route inquiries, go/no-go under Discovery ID
|
|
75
|
+
- `10-define` (`define`, `10-define`, `$10-define`) - Lock delivery boundaries and allocate Running ID (`devflow/runs/{ID}`)
|
|
76
|
+
- `20-spec` (`spec`, `20-spec`, `$20-spec`) - Formalize markdown-first specifications and acceptance criteria
|
|
77
|
+
- `30-plan` (`plan`, `30-plan`, `$30-plan`) - Transform spec into executable task breakdown with test decisions
|
|
78
|
+
- `40-implement` (`implement`, `40-implement`, `$40-implement`) - Execute planned tasks incrementally with evidence
|
|
79
|
+
- `50-verify` (`verify`, `50-verify`, `$50-verify`) - Senior QA review, validation checks, and pass/fail gate
|
|
80
|
+
- `60-report` (`report`, `60-report`, `$60-report`) - Generate standardized markdown and HTML summary report
|
|
81
|
+
- `70-release` (`release`, `70-release`, `$70-release`) - Package verified work for PR merge or deployment
|
|
82
82
|
|
|
83
83
|
### 2. Public Companion Commands
|
|
84
|
-
- `devflow` (`status`,
|
|
85
|
-
- `onboard` (
|
|
86
|
-
- `adopt` (
|
|
87
|
-
- `doctor` (
|
|
88
|
-
- `try` (
|
|
89
|
-
- `rollback` (
|
|
90
|
-
- `ci` (
|
|
91
|
-
- `brief` (
|
|
92
|
-
- `autopilot` (
|
|
84
|
+
- `devflow` (`status`, `devflow`, `$devflow`) - Guide, state inspector, and intent router
|
|
85
|
+
- `onboard` (`onboard`, `$onboard`) - Baseline stack setup for freshly scaffolded projects
|
|
86
|
+
- `adopt` (`adopt`, `$adopt`) - Survey and bootstrap DevFlow into existing brownfield projects
|
|
87
|
+
- `doctor` (`doctor`, `$doctor`) - Read-only health check for setup, scripts, and workflow drift
|
|
88
|
+
- `try` (`try`, `$try`) - Step-by-step human manual QA review guide (where to go, what to click, what to expect)
|
|
89
|
+
- `rollback` (`rollback`, `$rollback`) - Safe feature/run reversal planner with dependency risk analysis
|
|
90
|
+
- `ci` (`ci`, `$ci`) - Automatic GitHub Actions workflow (`.github/workflows/verify.yml`) setup
|
|
91
|
+
- `brief` (`brief`, `$brief`) - Read-only scope, dependency, and size pre-briefing before speccing
|
|
92
|
+
- `autopilot` (`autopilot`, `$autopilot`) - Optional bounded autonomous loop (spec -> plan -> implement -> verify -> report)
|
|
93
93
|
- `goal` - Route broad goals before Discovery
|
|
94
94
|
- `brainstorm` - Ideate without allocating running IDs
|
|
95
95
|
- `research` - Conduct codebase or web research
|
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: diagnosing-bugs
|
|
3
|
-
description: "[Devflow] Diagnosis loop for hard bugs and performance regressions. Use inside Debug,
|
|
3
|
+
description: "[Devflow] Diagnosis loop for hard bugs and performance regressions. Use inside Debug, 40-implement, or 50-verify when behavior is broken, throwing, failing, flaky, or slow."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Diagnosing Bugs
|
|
7
7
|
|
|
8
8
|
Use this support skill when the active DevFlow owner needs a disciplined root-cause loop.
|
|
9
9
|
|
|
10
|
-
Do not let this skill replace `Debug`,
|
|
10
|
+
Do not let this skill replace `Debug`, `40-implement`, or `50-verify`. It supplies the method; the owning workflow records the artifact.
|
|
11
11
|
|
|
12
12
|
## Phase 1: Build A Tight Feedback Loop
|
|
13
13
|
|
|
@@ -79,7 +79,7 @@ When a correct test seam exists:
|
|
|
79
79
|
4. Watch it pass.
|
|
80
80
|
5. Re-run the original feedback loop.
|
|
81
81
|
|
|
82
|
-
If no correct seam exists, record that architecture finding and route to `codebase-design` or
|
|
82
|
+
If no correct seam exists, record that architecture finding and route to `codebase-design` or `30-plan` after the bug is fixed.
|
|
83
83
|
|
|
84
84
|
## Phase 6: Cleanup And Post-Mortem
|
|
85
85
|
|