@jakkrichm/create-nexus-devflow 2.0.9 → 2.0.11
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 +24 -24
- package/template/.agents/skills/60-report/SKILL.md +10 -9
- package/template/.agents/skills/70-release/SKILL.md +33 -14
- 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 +24 -24
- package/template/.claude/skills/60-report/SKILL.md +10 -9
- package/template/.claude/skills/70-release/SKILL.md +33 -14
- 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,10 +60,24 @@ 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
|
|
|
67
|
+
### 0. Step 0 Safety Pass & Findings Ledger Gate
|
|
68
|
+
|
|
69
|
+
Before packaging, merging, or releasing:
|
|
70
|
+
|
|
71
|
+
1. **Findings Ledger Blockers**:
|
|
72
|
+
- ตรวจสอบ `devflow/context/findings.md`
|
|
73
|
+
- ต้องไม่มี Finding ระดับ P0 หรือ P1 ในสถานะ `open` หรือ `fixed` ค้างอยู่
|
|
74
|
+
- สถานะ `fixed` ยังคงบล็อก release เสมอจนกว่าจะผ่านการ Review ใน `50-verify` เพื่อเลื่อนเป็น `closed`
|
|
75
|
+
2. **2-Stage Approval Separation**:
|
|
76
|
+
- การขออนุมัติ Merge เข้า `main` หรือ `master` เป็นการอนุมัติขั้นแรก
|
|
77
|
+
- **การ Push ไปยัง Remote หรือ Deploy จะต้องขออนุมัติแยกต่างหากอย่างชัดเจน (Merge approval DOES NOT equal Push approval)**
|
|
78
|
+
3. **Archive Resolved Findings**:
|
|
79
|
+
- ย้ายรายการ Findings ที่ปิดแล้ว (`closed`, `accepted`, `invalid`) ไปบันทึกในเอกสาร Release และรีเซ็ต `findings.md` ให้สะอาด
|
|
80
|
+
|
|
67
81
|
### 1. Load Verified Context
|
|
68
82
|
|
|
69
83
|
Read:
|
|
@@ -72,6 +86,7 @@ Read:
|
|
|
72
86
|
- `50-verify.md`
|
|
73
87
|
- `40-implement.md`
|
|
74
88
|
- `20-spec.md`
|
|
89
|
+
- `devflow/context/findings.md`
|
|
75
90
|
- any PR, deploy, merge, or handoff notes already captured
|
|
76
91
|
|
|
77
92
|
### 2. Package The Release Outcome
|
|
@@ -81,6 +96,7 @@ Summarize:
|
|
|
81
96
|
- what is being delivered
|
|
82
97
|
- what changed in user or system terms
|
|
83
98
|
- what state the work is in for PR, deploy, merge, or handoff
|
|
99
|
+
- resolved and archived findings
|
|
84
100
|
- what follow-up items remain
|
|
85
101
|
|
|
86
102
|
### 3. Write `70-release.md`
|
|
@@ -94,15 +110,18 @@ Prefer clear release-note style wording:
|
|
|
94
110
|
- what changed
|
|
95
111
|
- what was fixed
|
|
96
112
|
- what is intentionally deferred
|
|
113
|
+
- archived findings summary
|
|
97
114
|
|
|
98
|
-
### 4. Confirm Readiness
|
|
115
|
+
### 4. Confirm Readiness & 2-Stage Execution
|
|
99
116
|
|
|
100
117
|
If release readiness changes because unresolved issues are found:
|
|
101
118
|
|
|
102
|
-
- route back to
|
|
119
|
+
- route back to `50-verify` or `40-implement`
|
|
103
120
|
|
|
104
121
|
Do not package unfinished work as release-ready through wording tricks.
|
|
105
|
-
|
|
122
|
+
When executing git operations:
|
|
123
|
+
1. Obtain explicit user confirmation before merging.
|
|
124
|
+
2. Obtain separate explicit user confirmation before running `git push` or deployment.
|
|
106
125
|
|
|
107
126
|
### 5. Manual Review Soft Gate
|
|
108
127
|
|
|
@@ -125,7 +144,7 @@ Report:
|
|
|
125
144
|
## Relationship To DevFlow 2.0
|
|
126
145
|
|
|
127
146
|
- Classification: Mainline workflow
|
|
128
|
-
- Previous state:
|
|
147
|
+
- Previous state: `60-report`
|
|
129
148
|
- Next state: End of the mainline run when release packaging or handoff is complete
|
|
130
149
|
- Common companion commands: `Commit`, `PR`, `Deploy`, `Changelog`, `Merge`, `Wiki`
|
|
131
150
|
- Support skills: `resolving-merge-conflicts`, `handoff`, and `setup-pre-commit` when release packaging needs conflict resolution, transfer notes, or local quality gates
|
|
@@ -135,21 +154,21 @@ Report:
|
|
|
135
154
|
- `AGENTS.md`
|
|
136
155
|
- `docs/workspace-artifacts.md`
|
|
137
156
|
- `.agent/resources/schemas/release.template.md`
|
|
138
|
-
- Related commands:
|
|
157
|
+
- Related commands: `60-report`, `Commit`, `PR`, `Deploy`, `Changelog`, `Merge`, `Wiki`
|
|
139
158
|
|
|
140
159
|
## Next Workflow Recommendation
|
|
141
160
|
|
|
142
161
|
- **Primary**: End of Timeline flow
|
|
143
162
|
- **Why**: The report is already complete, and this phase is the final release-facing execution step.
|
|
144
163
|
- **Alternatives**:
|
|
145
|
-
-
|
|
146
|
-
-
|
|
147
|
-
-
|
|
164
|
+
- `60-report` - choose this when the release package diverges from the approved report and the summary must be refreshed first.
|
|
165
|
+
- `50-verify` - choose this when release readiness becomes uncertain.
|
|
166
|
+
- `40-implement` - choose this when additional fixes are needed before release can proceed.
|
|
148
167
|
- `handoff` - choose this when release-ready context must move to another session, agent, or stakeholder packet.
|
|
149
168
|
|
|
150
169
|
## Nexus Event
|
|
151
170
|
|
|
152
171
|
- Use `Commit`, `PR`, `Deploy`, `Merge`, or `Changelog` when release execution still needs a concrete lane.
|
|
153
|
-
- Return to
|
|
154
|
-
- Return to
|
|
172
|
+
- Return to `60-report` when release notes, scope, or handoff wording diverge from the approved summary.
|
|
173
|
+
- Return to `50-verify` or `40-implement` when release readiness changes because unresolved issues are discovered.
|
|
155
174
|
|
|
@@ -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
|
|