@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.
Files changed (122) hide show
  1. package/package.json +1 -1
  2. package/template/.agents/skills/00-discover/SKILL.md +12 -12
  3. package/template/.agents/skills/10-define/SKILL.md +15 -15
  4. package/template/.agents/skills/20-spec/SKILL.md +13 -13
  5. package/template/.agents/skills/30-plan/SKILL.md +12 -12
  6. package/template/.agents/skills/40-implement/SKILL.md +13 -13
  7. package/template/.agents/skills/50-verify/SKILL.md +24 -24
  8. package/template/.agents/skills/60-report/SKILL.md +10 -9
  9. package/template/.agents/skills/70-release/SKILL.md +33 -14
  10. package/template/.agents/skills/adopt/SKILL.md +4 -4
  11. package/template/.agents/skills/agent/SKILL.md +3 -3
  12. package/template/.agents/skills/autopilot/SKILL.md +19 -19
  13. package/template/.agents/skills/brainstorm/SKILL.md +9 -9
  14. package/template/.agents/skills/brief/SKILL.md +8 -8
  15. package/template/.agents/skills/changelog/SKILL.md +3 -3
  16. package/template/.agents/skills/ci/SKILL.md +1 -1
  17. package/template/.agents/skills/ci-cd-and-automation/SKILL.md +3 -3
  18. package/template/.agents/skills/codebase-design/SKILL.md +5 -5
  19. package/template/.agents/skills/commit/SKILL.md +3 -3
  20. package/template/.agents/skills/competitor-analysis/SKILL.md +2 -2
  21. package/template/.agents/skills/debug/SKILL.md +10 -10
  22. package/template/.agents/skills/deploy/SKILL.md +3 -3
  23. package/template/.agents/skills/devflow/SKILL.md +24 -24
  24. package/template/.agents/skills/diagnosing-bugs/SKILL.md +3 -3
  25. package/template/.agents/skills/doctor/SKILL.md +3 -3
  26. package/template/.agents/skills/followup/SKILL.md +9 -9
  27. package/template/.agents/skills/goal/SKILL.md +10 -10
  28. package/template/.agents/skills/help/SKILL.md +17 -17
  29. package/template/.agents/skills/human-review-decisions/SKILL.md +5 -5
  30. package/template/.agents/skills/insight/SKILL.md +7 -7
  31. package/template/.agents/skills/insight-capture/SKILL.md +3 -3
  32. package/template/.agents/skills/intelligent-routing/SKILL.md +22 -22
  33. package/template/.agents/skills/issue-triage/SKILL.md +4 -4
  34. package/template/.agents/skills/merge/SKILL.md +4 -4
  35. package/template/.agents/skills/onboard/SKILL.md +7 -7
  36. package/template/.agents/skills/parallel-agents/SKILL.md +1 -1
  37. package/template/.agents/skills/planning-and-task-breakdown/SKILL.md +1 -1
  38. package/template/.agents/skills/pr/SKILL.md +7 -7
  39. package/template/.agents/skills/pr-review/SKILL.md +6 -6
  40. package/template/.agents/skills/pr-review-analysis/SKILL.md +2 -2
  41. package/template/.agents/skills/prd/SKILL.md +10 -10
  42. package/template/.agents/skills/preview/SKILL.md +7 -7
  43. package/template/.agents/skills/preview-local-check/SKILL.md +5 -5
  44. package/template/.agents/skills/prototype/SKILL.md +1 -1
  45. package/template/.agents/skills/release-git-operations/SKILL.md +5 -5
  46. package/template/.agents/skills/research/SKILL.md +9 -9
  47. package/template/.agents/skills/review/SKILL.md +3 -3
  48. package/template/.agents/skills/review-followup-routing/SKILL.md +3 -3
  49. package/template/.agents/skills/roadmap-strategy/SKILL.md +3 -3
  50. package/template/.agents/skills/rollback/SKILL.md +5 -5
  51. package/template/.agents/skills/security-review/SKILL.md +3 -3
  52. package/template/.agents/skills/shipping-and-launch/SKILL.md +1 -1
  53. package/template/.agents/skills/simplify/SKILL.md +6 -6
  54. package/template/.agents/skills/spec-orchestration/SKILL.md +5 -5
  55. package/template/.agents/skills/specialist-agent-routing/SKILL.md +7 -7
  56. package/template/.agents/skills/test/SKILL.md +3 -3
  57. package/template/.agents/skills/test-execution-and-coverage/SKILL.md +4 -4
  58. package/template/.agents/skills/try/SKILL.md +3 -3
  59. package/template/.agents/skills/verification-orchestration/SKILL.md +4 -4
  60. package/template/.agents/skills/wiki/SKILL.md +6 -6
  61. package/template/.agents/skills/workflow-documentation-sync/SKILL.md +1 -1
  62. package/template/.claude/skills/00-discover/SKILL.md +12 -12
  63. package/template/.claude/skills/10-define/SKILL.md +15 -15
  64. package/template/.claude/skills/20-spec/SKILL.md +13 -13
  65. package/template/.claude/skills/30-plan/SKILL.md +12 -12
  66. package/template/.claude/skills/40-implement/SKILL.md +13 -13
  67. package/template/.claude/skills/50-verify/SKILL.md +24 -24
  68. package/template/.claude/skills/60-report/SKILL.md +10 -9
  69. package/template/.claude/skills/70-release/SKILL.md +33 -14
  70. package/template/.claude/skills/adopt/SKILL.md +4 -4
  71. package/template/.claude/skills/agent/SKILL.md +3 -3
  72. package/template/.claude/skills/autopilot/SKILL.md +19 -19
  73. package/template/.claude/skills/brainstorm/SKILL.md +9 -9
  74. package/template/.claude/skills/brief/SKILL.md +8 -8
  75. package/template/.claude/skills/changelog/SKILL.md +3 -3
  76. package/template/.claude/skills/ci/SKILL.md +1 -1
  77. package/template/.claude/skills/ci-cd-and-automation/SKILL.md +3 -3
  78. package/template/.claude/skills/codebase-design/SKILL.md +5 -5
  79. package/template/.claude/skills/commit/SKILL.md +3 -3
  80. package/template/.claude/skills/competitor-analysis/SKILL.md +2 -2
  81. package/template/.claude/skills/debug/SKILL.md +10 -10
  82. package/template/.claude/skills/deploy/SKILL.md +3 -3
  83. package/template/.claude/skills/devflow/SKILL.md +24 -24
  84. package/template/.claude/skills/diagnosing-bugs/SKILL.md +3 -3
  85. package/template/.claude/skills/doctor/SKILL.md +3 -3
  86. package/template/.claude/skills/followup/SKILL.md +9 -9
  87. package/template/.claude/skills/goal/SKILL.md +10 -10
  88. package/template/.claude/skills/help/SKILL.md +17 -17
  89. package/template/.claude/skills/human-review-decisions/SKILL.md +5 -5
  90. package/template/.claude/skills/insight/SKILL.md +7 -7
  91. package/template/.claude/skills/insight-capture/SKILL.md +3 -3
  92. package/template/.claude/skills/intelligent-routing/SKILL.md +22 -22
  93. package/template/.claude/skills/issue-triage/SKILL.md +4 -4
  94. package/template/.claude/skills/merge/SKILL.md +4 -4
  95. package/template/.claude/skills/onboard/SKILL.md +7 -7
  96. package/template/.claude/skills/parallel-agents/SKILL.md +1 -1
  97. package/template/.claude/skills/planning-and-task-breakdown/SKILL.md +1 -1
  98. package/template/.claude/skills/pr/SKILL.md +7 -7
  99. package/template/.claude/skills/pr-review/SKILL.md +6 -6
  100. package/template/.claude/skills/pr-review-analysis/SKILL.md +2 -2
  101. package/template/.claude/skills/prd/SKILL.md +10 -10
  102. package/template/.claude/skills/preview/SKILL.md +7 -7
  103. package/template/.claude/skills/preview-local-check/SKILL.md +5 -5
  104. package/template/.claude/skills/prototype/SKILL.md +1 -1
  105. package/template/.claude/skills/release-git-operations/SKILL.md +5 -5
  106. package/template/.claude/skills/research/SKILL.md +9 -9
  107. package/template/.claude/skills/review/SKILL.md +3 -3
  108. package/template/.claude/skills/review-followup-routing/SKILL.md +3 -3
  109. package/template/.claude/skills/roadmap-strategy/SKILL.md +3 -3
  110. package/template/.claude/skills/rollback/SKILL.md +5 -5
  111. package/template/.claude/skills/security-review/SKILL.md +3 -3
  112. package/template/.claude/skills/shipping-and-launch/SKILL.md +1 -1
  113. package/template/.claude/skills/simplify/SKILL.md +6 -6
  114. package/template/.claude/skills/spec-orchestration/SKILL.md +5 -5
  115. package/template/.claude/skills/specialist-agent-routing/SKILL.md +7 -7
  116. package/template/.claude/skills/test/SKILL.md +3 -3
  117. package/template/.claude/skills/test-execution-and-coverage/SKILL.md +4 -4
  118. package/template/.claude/skills/try/SKILL.md +3 -3
  119. package/template/.claude/skills/verification-orchestration/SKILL.md +4 -4
  120. package/template/.claude/skills/wiki/SKILL.md +6 -6
  121. package/template/.claude/skills/workflow-documentation-sync/SKILL.md +1 -1
  122. package/template/AGENTS.md +43 -38
@@ -13,12 +13,12 @@ Package approved work for delivery after the report stage has captured the final
13
13
  ## Usage
14
14
 
15
15
  ```text
16
- /70-Release {running-id or workspace path}
16
+ 70-release {running-id or workspace path}
17
17
  ```
18
18
 
19
19
  Use this when:
20
20
 
21
- - `/60-Report` is complete
21
+ - `60-report` is complete
22
22
  - the work needs release execution or a release-facing handoff packet
23
23
  - downstream stakeholders need delivery notes instead of raw implementation detail
24
24
 
@@ -27,7 +27,7 @@ Use this when:
27
27
  Write the primary stage artifact to:
28
28
 
29
29
  ```text
30
- devflow/runs/{ID}-{slug}/70-release.md
30
+ devflow/runs/{ID}-{slug}70-release.md
31
31
  ```
32
32
 
33
33
  using:
@@ -60,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 `/50-Verify`; if fixes are required, return to `/40-Implement`; if context must transfer, use `handoff`.
63
+ - **Adjustment**: if release readiness becomes uncertain, return to `50-verify`; if fixes are required, return to `40-implement`; if context must transfer, use `handoff`.
64
64
  - **Stop Condition**: stop when the release state is explicit, evidence supports readiness, residual risks and follow-ups are named, and the next delivery or reporting route is clear.
65
65
  - **Handoff**: `70-release.md` must close the mainline run or tell the next reader what shipped, what did not ship, what evidence supports readiness, and what follow-ups remain.
66
66
 
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 `/50-Verify` or `/40-Implement`
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
- 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.
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: `/60-Report`
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: `/60-Report`, `Commit`, `PR`, `Deploy`, `Changelog`, `Merge`, `Wiki`
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
- - `/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.
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 `/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.
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 -> /00-discover or /10-define
11
+ existing codebase -> [adopt] -> project-overview + coding-standards -> 00-discover or 10-define
12
12
  (already has code) (survey + (seeded from the real code; (first feature / refactoring
13
13
  interview) shipped architecture documented) delivery lifecycle)
14
14
  ```
15
15
 
16
16
  Standard onboarding assumes a freshly scaffolded, near-empty app. That does not fit a codebase that already has thousands of lines of working code.
17
17
 
18
- `/adopt` is the brownfield on-ramp for Nexus-DevFlow: it reads what is already there, asks only for what the code cannot reveal (the *intent*, the *why*, and the *upcoming roadmap*), and produces the exact context files the rest of the DevFlow lifecycle expects (`project-overview.md`, `coding-standards.md`, `AGENTS.md` commands).
18
+ `adopt` is the brownfield on-ramp for Nexus-DevFlow: it reads what is already there, asks only for what the code cannot reveal (the *intent*, the *why*, and the *upcoming roadmap*), and produces the exact context files the rest of the DevFlow lifecycle expects (`project-overview.md`, `coding-standards.md`, `AGENTS.md` commands).
19
19
 
20
20
  ---
21
21
 
@@ -91,5 +91,5 @@ Present the adoption summary for review:
91
91
  - Inferred conventions and coding standards
92
92
  - Available verified commands in `AGENTS.md`
93
93
  - Recommended next step:
94
- - Run `00-discover` (or `/00-discover`, `$00-discover`) to explore the next major initiative or feature
95
- - Run `10-define` (or `/10-define`, `$10-define`) to immediately scope a delivery run for known roadmap items
94
+ - Run `00-discover` (or `00-discover`, `$00-discover`) to explore the next major initiative or feature
95
+ - Run `10-define` (or `10-define`, `$10-define`) to immediately scope a delivery run for known roadmap items
@@ -17,7 +17,7 @@ Agent {AGENT_NAME} {TARGET}
17
17
  Examples:
18
18
 
19
19
  ```text
20
- Agent requirements-engineer devflow/runs/007-auth-refactor/20-spec.md
20
+ Agent requirements-engineer devflow/runs/007-auth-refactor20-spec.md
21
21
  Agent codebase-explorer src/services/
22
22
  Agent code-reviewer devflow/runs/007-auth-refactor
23
23
  ```
@@ -145,7 +145,7 @@ Short reports can be returned directly in chat.
145
145
  - Classification: Companion command
146
146
  - Mainline status: Specialist invocation command, not a numbered stage
147
147
  - Typical entry points: any stage that needs focused specialist judgment
148
- - Typical handoff targets: return to the owning workflow such as `/10-Define`, `/20-Spec`, `/30-Plan`, `/40-Implement`, `/50-Verify`, `/60-Report`, `/70-Release`
148
+ - Typical handoff targets: return to the owning workflow such as `10-define`, `20-spec`, `30-plan`, `40-implement`, `50-verify`, `60-report`, `70-release`
149
149
 
150
150
  ## Sources
151
151
 
@@ -156,7 +156,7 @@ Short reports can be returned directly in chat.
156
156
 
157
157
  ## Next Workflow Recommendation
158
158
 
159
- - **Primary**: the workflow that owns the target's lifecycle, such as `/10-Define`, `/20-Spec`, `/30-Plan`, `/40-Implement`, `/50-Verify`, `/60-Report`, `/70-Release`, or `PR-Review`.
159
+ - **Primary**: the workflow that owns the target's lifecycle, such as `10-define`, `20-spec`, `30-plan`, `40-implement`, `50-verify`, `60-report`, `70-release`, or `PR-Review`.
160
160
  - **Why**: `Agent` supplies specialist judgment; the owning workflow should execute the next lifecycle step.
161
161
  - **Alternatives**:
162
162
  - `Research` when the specialist work uncovered unresolved external uncertainty
@@ -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
- /devflow -> [autopilot] -> review packet -> /70-release
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 (`/20-spec`, `/30-plan`, `/40-implement`, `/50-verify`, `/60-report`, `/70-release`) remain the conservative default.
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. `/autopilot RUN-004` or `/autopilot "add user authentication"`.
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 `/rollback` and reviewed `/40-implement`. Reversing completed work requires explicit dependency and human review gates.
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}/20-spec.md` already exists, resume it.
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}/30-plan.md`.
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}/40-implement.md`.
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}/50-verify.md` with QA verdict (`PASS` / `FAIL`).
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}/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`.
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}/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`
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 `/try {running-id}` for human review guide
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 `/try` walkthrough, then run `/70-release {running-id}` to package, merge, or create PR.
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 `/00-Discover` when the request is still fuzzy
28
- - from `/10-Define` when the direction is still unstable
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 `/00-Discover {discovery_id}` for synthesis. Do not allocate a Running ID or jump directly from a discovery-owned brainstorm into Define.
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: `/00-Discover -> /10-Define -> /20-Spec -> /30-Plan -> /40-Implement -> /50-Verify -> /60-Report -> /70-Release`
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: `/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
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: `/00-Discover`, `/10-Define`, `Research`, `PRD`, `/20-Spec`
161
+ - Related commands: `00-discover`, `10-define`, `Research`, `PRD`, `20-spec`
162
162
 
163
163
  ## Next Workflow Recommendation
164
164
 
165
- - Default: return to `/00-Discover {discovery_id}` when Discover requested the work; otherwise return to the stage that requested it
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: `/10-Define` or `/20-Spec` only when the work was not opened from a pending discovery
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] -> /20-spec -> /30-plan -> /40-implement
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. `/brief RUN-003`, `/brief "OAuth Login"`.
26
- - **topic / concern**: e.g. `/brief "database migration"`.
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 `/00-discover` or `/10-define`.
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 `/10-define`).
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 `/20-spec`.
62
+ - **Key Risks & Open Questions**: Technical or product unknowns that must be settled in `20-spec`.
63
63
 
64
64
  ---
65
- 👉 **Next Recommended Action**: `/20-spec {running-id}` (or resolve prerequisite blocker first).
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 `/20-spec`.
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: `/70-Release`, `Deploy`, `PR`
100
- - Typical handoff targets: `/60-Report`, `Wiki`
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: `/70-Release`, `Deploy`, `PR`, `/60-Report`, `Wiki`
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
- /onboard or /adopt -> [ci] -> Verify locally -> GitHub Actions runs Verify on PR & Push
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/workflows/ci.yml
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://ci_user:${{ secrets.CI_DB_PASSWORD }}@localhost:5432/testdb
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://ci_user:${{ secrets.CI_DB_PASSWORD }}@localhost:5432/testdb
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 `/20-Spec`, `/30-Plan`, `/40-Implement`, or `/50-Verify` needs better module shape.
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
- - `/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.
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: `/70-Release` after the report is aligned and release execution is ready
54
- - Typical handoff targets: `PR`, `Deploy`, `/70-Release`
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: `/70-Release`, `PR`, `Deploy`, `Merge`
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
- - `/10-Define` for scope and decision shaping
54
+ - `10-define` for scope and decision shaping
55
55
  - `Roadmap` for prioritization
56
- - `/20-Spec` when a selected opportunity becomes actionable
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 `/00-Discover` when a new request begins with a failure whose root cause is unknown
31
- - from `/40-Implement`
32
- - from `/50-Verify`
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 `/00-Discover {discovery_id}` for the delivery decision. Do not allocate a Running ID for an unapproved fix during Debug.
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: `/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`
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: `/40-Implement`, `/50-Verify`, `Test`, `Insight`, `Wiki`, `Agent`
124
+ - Related commands: `40-implement`, `50-verify`, `Test`, `Insight`, `Wiki`, `Agent`
125
125
 
126
126
  ## Next Workflow Recommendation
127
127
 
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
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: `/70-Release` after the report is aligned and packaging is ready to execute
80
- - Typical handoff targets: `/60-Report`, `Changelog`, `Wiki`
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: `/70-Release`, `Commit`, `PR`, `Changelog`, `/60-Report`
89
+ - Related commands: `70-release`, `Commit`, `PR`, `Changelog`, `60-report`
90
90
 
91
91