bigpowers 2.86.6 → 2.86.8

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 (210) hide show
  1. package/.agents/skills/guard-git/SKILL.md +8 -8
  2. package/.agents/skills/kickoff-branch/SKILL.md +1 -1
  3. package/.agents/skills/migrate-spec/SKILL.md +52 -6
  4. package/.agents/skills/plan-work/SKILL.md +17 -5
  5. package/.agents/skills/publish-package/SKILL.md +15 -5
  6. package/.agents/skills/release-branch/SKILL.md +12 -8
  7. package/.agents/skills/seed-conventions/SKILL.md +20 -10
  8. package/.agents/skills/smoke-test/SKILL.md +9 -5
  9. package/.agents/skills/validate-contracts/SKILL.md +15 -6
  10. package/.agents/skills/wire-ci/SKILL.md +12 -5
  11. package/.agents/skills/write-document/SKILL.md +31 -5
  12. package/.cline/skills/guard-git/SKILL.md +8 -8
  13. package/.cline/skills/kickoff-branch/SKILL.md +1 -1
  14. package/.cline/skills/migrate-spec/SKILL.md +52 -6
  15. package/.cline/skills/plan-work/SKILL.md +17 -5
  16. package/.cline/skills/publish-package/SKILL.md +15 -5
  17. package/.cline/skills/release-branch/SKILL.md +12 -8
  18. package/.cline/skills/seed-conventions/SKILL.md +20 -10
  19. package/.cline/skills/smoke-test/SKILL.md +9 -5
  20. package/.cline/skills/validate-contracts/SKILL.md +15 -6
  21. package/.cline/skills/wire-ci/SKILL.md +12 -5
  22. package/.cline/skills/write-document/SKILL.md +31 -5
  23. package/.codebuddy/skills/guard-git/SKILL.md +8 -8
  24. package/.codebuddy/skills/kickoff-branch/SKILL.md +1 -1
  25. package/.codebuddy/skills/migrate-spec/SKILL.md +52 -6
  26. package/.codebuddy/skills/plan-work/SKILL.md +17 -5
  27. package/.codebuddy/skills/publish-package/SKILL.md +15 -5
  28. package/.codebuddy/skills/release-branch/SKILL.md +12 -8
  29. package/.codebuddy/skills/seed-conventions/SKILL.md +20 -10
  30. package/.codebuddy/skills/smoke-test/SKILL.md +9 -5
  31. package/.codebuddy/skills/validate-contracts/SKILL.md +15 -6
  32. package/.codebuddy/skills/wire-ci/SKILL.md +12 -5
  33. package/.codebuddy/skills/write-document/SKILL.md +31 -5
  34. package/.codex/skills/guard-git/SKILL.md +8 -8
  35. package/.codex/skills/kickoff-branch/SKILL.md +1 -1
  36. package/.codex/skills/migrate-spec/SKILL.md +52 -6
  37. package/.codex/skills/plan-work/SKILL.md +17 -5
  38. package/.codex/skills/publish-package/SKILL.md +15 -5
  39. package/.codex/skills/release-branch/SKILL.md +12 -8
  40. package/.codex/skills/seed-conventions/SKILL.md +20 -10
  41. package/.codex/skills/smoke-test/SKILL.md +9 -5
  42. package/.codex/skills/validate-contracts/SKILL.md +15 -6
  43. package/.codex/skills/wire-ci/SKILL.md +12 -5
  44. package/.codex/skills/write-document/SKILL.md +31 -5
  45. package/.copilot/skills/guard-git/SKILL.md +8 -8
  46. package/.copilot/skills/kickoff-branch/SKILL.md +1 -1
  47. package/.copilot/skills/migrate-spec/SKILL.md +52 -6
  48. package/.copilot/skills/plan-work/SKILL.md +17 -5
  49. package/.copilot/skills/publish-package/SKILL.md +15 -5
  50. package/.copilot/skills/release-branch/SKILL.md +12 -8
  51. package/.copilot/skills/seed-conventions/SKILL.md +20 -10
  52. package/.copilot/skills/smoke-test/SKILL.md +9 -5
  53. package/.copilot/skills/validate-contracts/SKILL.md +15 -6
  54. package/.copilot/skills/wire-ci/SKILL.md +12 -5
  55. package/.copilot/skills/write-document/SKILL.md +31 -5
  56. package/.hermes/skills/guard-git/SKILL.md +8 -8
  57. package/.hermes/skills/kickoff-branch/SKILL.md +1 -1
  58. package/.hermes/skills/migrate-spec/SKILL.md +52 -6
  59. package/.hermes/skills/plan-work/SKILL.md +17 -5
  60. package/.hermes/skills/publish-package/SKILL.md +15 -5
  61. package/.hermes/skills/release-branch/SKILL.md +12 -8
  62. package/.hermes/skills/seed-conventions/SKILL.md +20 -10
  63. package/.hermes/skills/smoke-test/SKILL.md +9 -5
  64. package/.hermes/skills/validate-contracts/SKILL.md +15 -6
  65. package/.hermes/skills/wire-ci/SKILL.md +12 -5
  66. package/.hermes/skills/write-document/SKILL.md +31 -5
  67. package/.kilocode/rules/guard-git.md +8 -8
  68. package/.kilocode/rules/kickoff-branch.md +1 -1
  69. package/.kilocode/rules/migrate-spec.md +52 -6
  70. package/.kilocode/rules/plan-work.md +17 -5
  71. package/.kilocode/rules/publish-package.md +15 -5
  72. package/.kilocode/rules/release-branch.md +12 -8
  73. package/.kilocode/rules/seed-conventions.md +20 -10
  74. package/.kilocode/rules/smoke-test.md +9 -5
  75. package/.kilocode/rules/validate-contracts.md +15 -6
  76. package/.kilocode/rules/wire-ci.md +12 -5
  77. package/.kilocode/rules/write-document.md +31 -5
  78. package/.mimocode/skills/guard-git/SKILL.md +8 -8
  79. package/.mimocode/skills/kickoff-branch/SKILL.md +1 -1
  80. package/.mimocode/skills/migrate-spec/SKILL.md +52 -6
  81. package/.mimocode/skills/plan-work/SKILL.md +17 -5
  82. package/.mimocode/skills/publish-package/SKILL.md +15 -5
  83. package/.mimocode/skills/release-branch/SKILL.md +12 -8
  84. package/.mimocode/skills/seed-conventions/SKILL.md +20 -10
  85. package/.mimocode/skills/smoke-test/SKILL.md +9 -5
  86. package/.mimocode/skills/validate-contracts/SKILL.md +15 -6
  87. package/.mimocode/skills/wire-ci/SKILL.md +12 -5
  88. package/.mimocode/skills/write-document/SKILL.md +31 -5
  89. package/.opencode/skills/guard-git/SKILL.md +8 -8
  90. package/.opencode/skills/kickoff-branch/SKILL.md +1 -1
  91. package/.opencode/skills/migrate-spec/SKILL.md +52 -6
  92. package/.opencode/skills/plan-work/SKILL.md +17 -5
  93. package/.opencode/skills/publish-package/SKILL.md +15 -5
  94. package/.opencode/skills/release-branch/SKILL.md +12 -8
  95. package/.opencode/skills/seed-conventions/SKILL.md +20 -10
  96. package/.opencode/skills/smoke-test/SKILL.md +9 -5
  97. package/.opencode/skills/validate-contracts/SKILL.md +15 -6
  98. package/.opencode/skills/wire-ci/SKILL.md +12 -5
  99. package/.opencode/skills/write-document/SKILL.md +31 -5
  100. package/.pi/package.json +1 -1
  101. package/.pi/prompts/guard-git.md +8 -8
  102. package/.pi/prompts/kickoff-branch.md +1 -1
  103. package/.pi/prompts/migrate-spec.md +52 -6
  104. package/.pi/prompts/plan-work.md +17 -5
  105. package/.pi/prompts/publish-package.md +15 -5
  106. package/.pi/prompts/release-branch.md +12 -8
  107. package/.pi/prompts/seed-conventions.md +20 -10
  108. package/.pi/prompts/smoke-test.md +9 -5
  109. package/.pi/prompts/validate-contracts.md +15 -6
  110. package/.pi/prompts/wire-ci.md +12 -5
  111. package/.pi/prompts/write-document.md +31 -5
  112. package/.pi/skills/guard-git/SKILL.md +8 -8
  113. package/.pi/skills/kickoff-branch/SKILL.md +1 -1
  114. package/.pi/skills/migrate-spec/SKILL.md +52 -6
  115. package/.pi/skills/plan-work/SKILL.md +17 -5
  116. package/.pi/skills/publish-package/SKILL.md +15 -5
  117. package/.pi/skills/release-branch/SKILL.md +12 -8
  118. package/.pi/skills/seed-conventions/SKILL.md +20 -10
  119. package/.pi/skills/smoke-test/SKILL.md +9 -5
  120. package/.pi/skills/validate-contracts/SKILL.md +15 -6
  121. package/.pi/skills/wire-ci/SKILL.md +12 -5
  122. package/.pi/skills/write-document/SKILL.md +31 -5
  123. package/.qwen/skills/guard-git/SKILL.md +8 -8
  124. package/.qwen/skills/kickoff-branch/SKILL.md +1 -1
  125. package/.qwen/skills/migrate-spec/SKILL.md +52 -6
  126. package/.qwen/skills/plan-work/SKILL.md +17 -5
  127. package/.qwen/skills/publish-package/SKILL.md +15 -5
  128. package/.qwen/skills/release-branch/SKILL.md +12 -8
  129. package/.qwen/skills/seed-conventions/SKILL.md +20 -10
  130. package/.qwen/skills/smoke-test/SKILL.md +9 -5
  131. package/.qwen/skills/validate-contracts/SKILL.md +15 -6
  132. package/.qwen/skills/wire-ci/SKILL.md +12 -5
  133. package/.qwen/skills/write-document/SKILL.md +31 -5
  134. package/.trae/skills/guard-git/SKILL.md +8 -8
  135. package/.trae/skills/kickoff-branch/SKILL.md +1 -1
  136. package/.trae/skills/migrate-spec/SKILL.md +52 -6
  137. package/.trae/skills/plan-work/SKILL.md +17 -5
  138. package/.trae/skills/publish-package/SKILL.md +15 -5
  139. package/.trae/skills/release-branch/SKILL.md +12 -8
  140. package/.trae/skills/seed-conventions/SKILL.md +20 -10
  141. package/.trae/skills/smoke-test/SKILL.md +9 -5
  142. package/.trae/skills/validate-contracts/SKILL.md +15 -6
  143. package/.trae/skills/wire-ci/SKILL.md +12 -5
  144. package/.trae/skills/write-document/SKILL.md +31 -5
  145. package/.windsurf/rules/guard-git.md +8 -8
  146. package/.windsurf/rules/kickoff-branch.md +1 -1
  147. package/.windsurf/rules/migrate-spec.md +52 -6
  148. package/.windsurf/rules/plan-work.md +17 -5
  149. package/.windsurf/rules/publish-package.md +15 -5
  150. package/.windsurf/rules/release-branch.md +12 -8
  151. package/.windsurf/rules/seed-conventions.md +20 -10
  152. package/.windsurf/rules/smoke-test.md +9 -5
  153. package/.windsurf/rules/validate-contracts.md +15 -6
  154. package/.windsurf/rules/wire-ci.md +12 -5
  155. package/.windsurf/rules/write-document.md +31 -5
  156. package/.zcode/skills/guard-git/SKILL.md +8 -8
  157. package/.zcode/skills/kickoff-branch/SKILL.md +1 -1
  158. package/.zcode/skills/migrate-spec/SKILL.md +52 -6
  159. package/.zcode/skills/plan-work/SKILL.md +17 -5
  160. package/.zcode/skills/publish-package/SKILL.md +15 -5
  161. package/.zcode/skills/release-branch/SKILL.md +12 -8
  162. package/.zcode/skills/seed-conventions/SKILL.md +20 -10
  163. package/.zcode/skills/smoke-test/SKILL.md +9 -5
  164. package/.zcode/skills/validate-contracts/SKILL.md +15 -6
  165. package/.zcode/skills/wire-ci/SKILL.md +12 -5
  166. package/.zcode/skills/write-document/SKILL.md +31 -5
  167. package/CHANGELOG.md +15 -0
  168. package/CONVENTIONS.md +2 -0
  169. package/package.json +1 -1
  170. package/scripts/check-skill-links.py +2 -1
  171. package/scripts/generate-context-bundle.sh +6 -0
  172. package/scripts/generate-reference-nav.sh +89 -0
  173. package/scripts/generate-viz-graph.sh +4 -0
  174. package/scripts/golden-g13-script-orphans.sh +167 -0
  175. package/scripts/golden-g15-compliance-runner-selftest.sh +126 -0
  176. package/scripts/golden-g16-spec-version-gap.sh +72 -0
  177. package/scripts/lib/__pycache__/link_utils.cpython-312.pyc +0 -0
  178. package/scripts/lib/__pycache__/srp_engine_links.cpython-312.pyc +0 -0
  179. package/scripts/lib/audit-compliance-report.sh +32 -7
  180. package/scripts/lib/audit-compliance-runner.sh +14 -1
  181. package/scripts/lib/golden-suite-gates.sh +23 -7
  182. package/scripts/lib/test-assertions.sh +4 -0
  183. package/scripts/snapshot-catalog-baseline.sh +4 -0
  184. package/scripts/test-adapter-render.sh +19 -21
  185. package/scripts/test-completeness-critic-scope.sh +18 -19
  186. package/scripts/test-generate-epics-wiki-zero-stories.sh +12 -13
  187. package/scripts/test-golden-g11-worktree-venv.sh +16 -18
  188. package/scripts/test-install-distribute-only.sh +27 -26
  189. package/scripts/test-install-hub.sh +25 -23
  190. package/scripts/test-setup-no-pyyaml.sh +16 -17
  191. package/scripts/test-target-contracts.sh +15 -13
  192. package/scripts/test-tombstone-mechanism.sh +31 -33
  193. package/skills/guard-git/REFERENCE.md +8 -8
  194. package/skills/kickoff-branch/SKILL.md +1 -1
  195. package/skills/migrate-spec/REFERENCE.md +52 -6
  196. package/skills/plan-work/REFERENCE.md +17 -5
  197. package/skills/publish-package/REFERENCE.md +15 -5
  198. package/skills/release-branch/REFERENCE.md +12 -8
  199. package/skills/seed-conventions/REFERENCE.md +20 -10
  200. package/skills/smoke-test/REFERENCE.md +9 -5
  201. package/skills/validate-contracts/REFERENCE.md +15 -6
  202. package/skills/wire-ci/REFERENCE.md +12 -5
  203. package/skills/write-document/REFERENCE.md +30 -4
  204. package/skills/write-document/SKILL.md +1 -1
  205. package/skills-lock.json +2 -2
  206. package/scripts/add-model-frontmatter.sh +0 -32
  207. package/scripts/golden-g13-test-orphans.sh +0 -70
  208. package/scripts/install-cursor-skills-local.sh +0 -15
  209. package/scripts/install-cursor-skills.sh +0 -24
  210. package/scripts/project-survey.sh +0 -63
@@ -147,15 +147,19 @@ Report: "Branch released."
147
147
 
148
148
  | Lines | Section |
149
149
  |-------|---------|
150
- | 1–3 | Title |
151
- | 5–16 | Navigation |
152
- | 18–41 | PR body template |
153
- | 43–54 | Worktree cleanup |
154
- | 56–96 | Cycle-time recording |
155
- | 98–119 | CI verification |
156
- | 121–126 | Solo-local fallback |
150
+ | 1 | Title |
151
+ | 3–22 | Navigation |
152
+ | 23–31 | PR body template (team-pr mode) |
153
+ | 32–35 | Summary |
154
+ | 36–41 | Verify |
155
+ | 42–47 | specs/ artifacts |
156
+ | 48–58 | Worktree cleanup details |
157
+ | 59–81 | Cycle-time recording |
158
+ | 82–100 | Why not story_start minus story_end? |
159
+ | 101–121 | CI verification |
160
+ | 122–127 | Solo-local fallback detail |
157
161
  | 128–134 | Handoff |
158
- | 136–155 | Reference block 1 (manual squash) |
162
+ | 135–159 | Reference block 1 |
159
163
 
160
164
  # Release Branch — Reference
161
165
 
@@ -128,16 +128,26 @@ Emit these fences in `AGENTS.md` (and therefore `CLAUDE.md` symlink) from `docs/
128
128
 
129
129
  | Lines | Section |
130
130
  |-------|---------|
131
- | 1–4 | Title + story tags |
132
- | 6–22 | Navigation (this table) |
133
- | 24–35 | AGENTS.md spine |
134
- | 37–76 | Agent config template |
135
- | 78–85 | opencode.json template |
136
- | 87–96 | Aider bridge |
137
- | 98–108 | Codex CLI wiring |
138
- | 110–118 | CONVENTIONS.md |
139
- | 120–122 | Stack profile fragments |
140
- | 124–153 | Local tool wiring |
131
+ | 1 | Title |
132
+ | 5–29 | Navigation |
133
+ | 30–53 | Fenced markers (e45s21) |
134
+ | 54–65 | AGENTS.md spine (Reach Template — e37s01) |
135
+ | 66–77 | Agent config template (legacy — prefer AGENTS.md spine) |
136
+ | 78–81 | Project |
137
+ | 82–91 | Commands |
138
+ | 92–94 | Architecture |
139
+ | 95–98 | Conventions |
140
+ | 99–104 | Never |
141
+ | 105–114 | Agent Rules |
142
+ | 115–123 | opencode.json template |
143
+ | 124–133 | Aider — `.aider.conf.yml` bridge (e37s03) |
144
+ | 134–146 | Codex CLI — project-local `.codex/config.toml` + AGENTS.md (e37s14) |
145
+ | 147–156 | CONVENTIONS.md |
146
+ | 157–160 | Stack profile fragments |
147
+ | 161–164 | Local tool wiring (optional interview step 8) |
148
+ | 165–173 | Cursor — project-local `.cursor/rules` symlink |
149
+ | 174–187 | OpenCode — project-local `opencode.json` + `AGENTS.md` |
150
+ | 188–190 | When to offer |
141
151
 
142
152
  ## Fenced markers (e45s21)
143
153
 
@@ -89,11 +89,15 @@ Part of **★ VERIFY ★**: `verify-work` → `validate-contracts` → `smoke-te
89
89
  | Lines | Section |
90
90
  |-------|---------|
91
91
  | 1 | Title |
92
- | 3–12 | Navigation |
93
- | 14–31 | Runner script |
94
- | 33–42 | Configuration reference |
95
- | 44–53 | Verification |
96
- | 55–160 | Reference blocks 1–5 |
92
+ | 3–17 | Navigation |
93
+ | 18–34 | Runner script |
94
+ | 35–46 | Configuration reference |
95
+ | 47–55 | Verification |
96
+ | 56–89 | Reference block 1 |
97
+ | 90–107 | Reference block 2 |
98
+ | 108–122 | Reference block 3 |
99
+ | 123–159 | Reference block 4 |
100
+ | 160–177 | Reference block 5 |
97
101
 
98
102
  ## Runner script
99
103
 
@@ -87,12 +87,21 @@ Part of **★ VERIFY ★**: `verify-work` → `validate-contracts` → `smoke-te
87
87
  | Lines | Section |
88
88
  |-------|---------|
89
89
  | 1 | Title |
90
- | 3–14 | Navigation |
91
- | 16–24 | Integration |
92
- | 26–35 | Configuration |
93
- | 37–46 | Verification |
94
- | 48–170 | Reference blocks + Examples 1–6 |
95
- | 172–190 | Integration (duplicate) + Configuration + Verification |
90
+ | 3–23 | Navigation |
91
+ | 24–32 | Integration |
92
+ | 33–44 | Configuration |
93
+ | 45–54 | Verification |
94
+ | 55–71 | Reference block 1 |
95
+ | 72–92 | Reference block 2 |
96
+ | 93–104 | Example 1 |
97
+ | 105–121 | Example 2 |
98
+ | 122–133 | Example 3 |
99
+ | 134–144 | Example 4 |
100
+ | 145–165 | Example 5 |
101
+ | 166–176 | Example 6 |
102
+ | 177–185 | Integration |
103
+ | 186–197 | Configuration |
104
+ | 198–204 | Verification |
96
105
 
97
106
  ## Integration
98
107
 
@@ -118,11 +118,18 @@ See [REFERENCE.md](REFERENCE.md).
118
118
  | Lines | Section |
119
119
  |-------|---------|
120
120
  | 1 | Title |
121
- | 3–14 | Navigation |
122
- | 16–38 | Examples |
123
- | 40–52 | Options |
124
- | 54–62 | Integration with build-epic |
125
- | 64–270 | Reference blocks 1–8 |
121
+ | 3–20 | Navigation |
122
+ | 21–22 | Examples |
123
+ | 23–39 | Create CI for a Go project (TBR + optional deploy) |
124
+ | 40–49 | Create CI for a CLI tool (TBR only, no deploy) |
125
+ | 50–57 | Validate existing workflows (no generation) |
126
+ | 58–70 | Options |
127
+ | 71–79 | Integration with build-epic |
128
+ | 80–154 | Reference block 1 — test-build-release.yml (Go, excerpt) |
129
+ | 155–204 | Reference block 2 — deploy.yml (generic web app, excerpt) |
130
+ | 205–232 | Reference block 3 — CLI dogfood (big-release pattern) |
131
+ | 233–257 | Reference block 4 — validate script |
132
+ | 258–268 | Reference block 5 — dry-run |
126
133
 
127
134
  ## Examples
128
135
 
@@ -47,7 +47,7 @@ Write the document focusing on "Expert Collaboration":
47
47
 
48
48
  1. Ask: "Project name? One-sentence description?"
49
49
  2. Generate `README.md` at project root using the template in [REFERENCE.md](REFERENCE.md) — no TOC, no second interview round.
50
- 3. Fill gaps from `CLAUDE.md` commands if available; use `TODO` markers otherwise.
50
+ 3. Fill gaps from `CLAUDE.md` / `AGENTS.md` commands if available (prefer `AGENTS.md`); use `TODO` markers otherwise.
51
51
  4. Output and suggest `edit-document` for polish.
52
52
 
53
53
  → verify: `test -f README.md && [ "$(grep -c '^## ' README.md)" -ge 7 ]`
@@ -86,10 +86,36 @@ Combined from dbader/readme-template and jehna/readme-best-practices. No TOC.
86
86
  | Lines | Section |
87
87
  |-------|---------|
88
88
  | 1 | Title |
89
- | 5–16 | Navigation |
90
- | 18–24 | Sections intro |
91
- | 26–178 | README section templates (1–15) |
92
- | 180–183 | Verify |
89
+ | 5–40 | Navigation |
90
+ | 41–42 | Sections |
91
+ | 43–54 | 1. Title + Badges |
92
+ | 55–60 | 2. Tagline |
93
+ | 61–64 | 3. Description |
94
+ | 65–67 | 4. Prerequisites |
95
+ | 68–75 | Prerequisites |
96
+ | 76–78 | 5. Installation |
97
+ | 79–89 | Installation |
98
+ | 90–92 | 6. Usage |
99
+ | 93–102 | Usage |
100
+ | 103–105 | 7. Features |
101
+ | 106–113 | Features |
102
+ | 114–116 | 8. Configuration |
103
+ | 117–125 | Configuration |
104
+ | 126–128 | 9. Development Setup |
105
+ | 129–139 | Development |
106
+ | 140–142 | 10. Running Tests |
107
+ | 143–152 | Tests |
108
+ | 153–155 | 11. Contributing |
109
+ | 156–164 | Contributing |
110
+ | 165–167 | 12. Changelog |
111
+ | 168–172 | Changelog |
112
+ | 173–175 | 13. Links |
113
+ | 176–181 | Links |
114
+ | 182–184 | 14. License |
115
+ | 185–191 | License |
116
+ | 192–194 | 15. Credits (optional) |
117
+ | 195–199 | Credits |
118
+ | 200–202 | Verify |
93
119
 
94
120
  ## Sections
95
121
 
@@ -56,14 +56,14 @@ Full JSON examples, merge rules, Antigravity deny-list entries, and test command
56
56
  | Lines | Section |
57
57
  |-------|---------|
58
58
  | 1 | Title |
59
- | 3–14 | Navigation |
60
- | 16–24 | Secret patterns |
61
- | 26–44 | Copy layout |
62
- | 46–72 | Claude Code |
63
- | 74–92 | Cursor and Cursor CLI |
64
- | 94–120 | Gemini CLI |
65
- | 122–135 | Google Antigravity |
66
- | 137–178 | Verify (local tests) |
59
+ | 3–16 | Navigation |
60
+ | 17–28 | Secret patterns (audit + pre-commit) |
61
+ | 29–46 | Copy layout |
62
+ | 47–72 | Claude Code |
63
+ | 73–94 | Cursor and Cursor CLI |
64
+ | 95–122 | Gemini CLI |
65
+ | 123–137 | Google Antigravity |
66
+ | 138–180 | Verify (local tests) |
67
67
 
68
68
  ## Secret patterns (audit + pre-commit)
69
69
 
@@ -81,7 +81,7 @@ git worktree list | grep "<task-slug>"
81
81
  **Handling Conflicts:**
82
82
  - **Directory exists:** If `../<task-slug>` already exists, ask the user if they want to use it or delete it.
83
83
  - **Branch exists:** If the branch exists but no worktree is attached, ask to use the existing branch (`git worktree add ../<task-slug> <task-slug>`) or delete it.
84
- - **Ghost worktree:** If `git worktree list` shows the path but the directory is missing, run `git worktree prune` to clear the stale metadata.
84
+ - **Ghost worktree:** If `git worktree list` shows the path but the directory is missing, run `git worktree prune` to clear the stale metadata. `bash scripts/cleanup-worktrees.sh` does this plus reports any worktree whose branch is already merged or deleted — advisory only, it prints the `git worktree remove`/`git branch -d` commands rather than running them, so review before acting.
85
85
 
86
86
  ### 4. Create worktree + branch
87
87
 
@@ -253,12 +253,58 @@ These GSD artifacts are not migrated — they are execution records, not plannin
253
253
  | Lines | Section |
254
254
  |-------|---------|
255
255
  | 1 | Title |
256
- | 3–22 | Navigation |
257
- | 24–62 | spec-kit → bigpowers Mapping |
258
- | 64–130 | BMAD → bigpowers Mapping |
259
- | 132–154 | Learnings to Adopt |
260
- | 156–350 | Output Formats + state.yaml template |
261
- | 352–620 | Reference blocks 1–2 + extended mappings |
256
+ | 3–68 | Navigation |
257
+ | 69–70 | spec-kit → bigpowers Mapping |
258
+ | 71–84 | Artifact Locations |
259
+ | 85–94 | `spec.md` → `specs/product/SCOPE_LATEST.yaml` + `specs/tech-architecture/TECH_STACK_LATEST.md` |
260
+ | 95–105 | `plan.md` → `specs/tech-architecture/TECH_STACK_LATEST.md` + `specs/release-plan.yaml` + `specs/epics/` |
261
+ | 106–114 | `tasks.md` → `specs/epics/` (via slice-tasks) |
262
+ | 115–120 | `.specify/` state |
263
+ | 121–122 | BMAD → bigpowers Mapping |
264
+ | 123–141 | Artifact Locations |
265
+ | 142–148 | `product-brief.md` / `prfaq-{project}.md` → `specs/product/VISION_LATEST.yaml` |
266
+ | 149–160 | `prd.md` → `specs/product/SCOPE_LATEST.yaml` + `GLOSSARY_LATEST.yaml` |
267
+ | 161–167 | `addendum.md` + `decision-log.md` → `specs/adr/` + `specs/DECISION-LOG_LATEST.md` |
268
+ | 168–174 | `architecture.md` → `specs/tech-architecture/TECH_STACK_LATEST.md` + `specs/adr/` |
269
+ | 175–178 | `epic-*.md` → `specs/release-plan.yaml` + `specs/epics/eNN-*.yaml` |
270
+ | 179–182 | `story-*.md` → `specs/epics/` stories |
271
+ | 183–188 | `project-context.md` → `CLAUDE.md` |
272
+ | 189–192 | Learnings to Adopt |
273
+ | 193–198 | From GSD |
274
+ | 199–204 | From spec-kit |
275
+ | 205–212 | From BMAD |
276
+ | 213–214 | Output Formats |
277
+ | 215–224 | ADR format (bigpowers) |
278
+ | 225–227 | Context |
279
+ | 228–230 | Decision |
280
+ | 231–234 | Consequences |
281
+ | 235–246 | DECISION-LOG.md format |
282
+ | 247–257 | MIGRATION-AUDIT.md format |
283
+ | 258–264 | Summary |
284
+ | 265–274 | High Priority Findings |
285
+ | 275–278 | Information |
286
+ | 279–285 | Next Steps |
287
+ | 286–306 | in_scope format with ID tracking |
288
+ | 307–341 | REQUIREMENTS_TRACE.yaml format |
289
+ | 342–397 | `specs/state.yaml` template format |
290
+ | 398–416 | Reference block 1 |
291
+ | 417–432 | Reference block 2 |
292
+ | 433–451 | Reference block 3 |
293
+ | 452–474 | Reference block 4 |
294
+ | 475–482 | Reference block 5 |
295
+ | 483–484 | Findings |
296
+ | 485–489 | High Priority |
297
+ | 490–495 | Information |
298
+ | 496–509 | Reference block 6 |
299
+ | 510–542 | Step 7 — Post-migration: Optional two-pass spec writing gate |
300
+ | 543–574 | Step 8 — Post-migration: Optional methodology doc template |
301
+ | 575–600 | Artifact Mapping Summary |
302
+ | 601–610 | Rules |
303
+ | 611–621 | Step 5 — Surface learnings (optional) |
304
+ | 622–644 | Step 6 — Adversarial review (optional) |
305
+ | 645–646 | Findings |
306
+ | 647–651 | High Priority |
307
+ | 652–660 | Information |
262
308
 
263
309
  # migrate-spec Reference — spec-kit, BMAD, Learnings
264
310
 
@@ -108,11 +108,23 @@ Writes: state.yaml handoff.next_skill = kickoff-branch
108
108
  | Lines | Section |
109
109
  |-------|---------|
110
110
  | 1 | Title |
111
- | 3–14 | Navigation |
112
- | 16–38 | Output file formats |
113
- | 40–71 | Plan template |
114
- | 73–91 | Verify step format rules |
115
- | 93–131 | Sub-operations (risk, define-success, zoom-out, slopcheck, delta tags) |
111
+ | 3–25 | Navigation |
112
+ | 26–27 | Output file formats |
113
+ | 28–31 | Story spec: `specs/epics/<capsule>/eNNsYY-<slug>.md` |
114
+ | 32–61 | Task checklist: `specs/epics/<capsule>/eNNsYY-tasks.yaml` |
115
+ | 62–64 | Plan template |
116
+ | 65–71 | Story [X.Y]: [title] — Implementation Steps |
117
+ | 72–77 | Steps |
118
+ | 78–85 | Verification Script (Step-by-Step) |
119
+ | 86–89 | Out of scope |
120
+ | 90–94 | Risks |
121
+ | 95–114 | Verify step format rules |
122
+ | 115–116 | Sub-operations |
123
+ | 117–127 | Risk Assignment Heuristics |
124
+ | 128–143 | Requirement delta tags (e45s29) |
125
+ | 144–152 | Define Success |
126
+ | 153–161 | Zoom-Out Check |
127
+ | 162–169 | Slopcheck |
116
128
 
117
129
  ## Output file formats
118
130
 
@@ -83,11 +83,21 @@ See [REFERENCE.md](REFERENCE.md)
83
83
  | Lines | Section |
84
84
  |-------|---------|
85
85
  | 1 | Title |
86
- | 3–18 | Navigation |
87
- | 20–28 | Options |
88
- | 30–60 | Examples |
89
- | 62–72 | Integration with release-branch |
90
- | 74–252 | Reference blocks 1–8 |
86
+ | 3–23 | Navigation |
87
+ | 24–35 | Options |
88
+ | 36–37 | Examples |
89
+ | 38–51 | Publish an npm package |
90
+ | 52–59 | Publish a Rust crate |
91
+ | 60–69 | Missing token scenario |
92
+ | 70–80 | Integration with release-branch |
93
+ | 81–121 | Reference block 1 |
94
+ | 122–143 | Reference block 2 |
95
+ | 144–162 | Reference block 3 |
96
+ | 163–180 | Reference block 4 |
97
+ | 181–195 | Reference block 5 |
98
+ | 196–230 | Reference block 6 |
99
+ | 231–248 | Reference block 7 |
100
+ | 249–260 | Reference block 8 |
91
101
 
92
102
  ## Options
93
103
 
@@ -147,15 +147,19 @@ Report: "Branch released."
147
147
 
148
148
  | Lines | Section |
149
149
  |-------|---------|
150
- | 1–3 | Title |
151
- | 5–16 | Navigation |
152
- | 18–41 | PR body template |
153
- | 43–54 | Worktree cleanup |
154
- | 56–96 | Cycle-time recording |
155
- | 98–119 | CI verification |
156
- | 121–126 | Solo-local fallback |
150
+ | 1 | Title |
151
+ | 3–22 | Navigation |
152
+ | 23–31 | PR body template (team-pr mode) |
153
+ | 32–35 | Summary |
154
+ | 36–41 | Verify |
155
+ | 42–47 | specs/ artifacts |
156
+ | 48–58 | Worktree cleanup details |
157
+ | 59–81 | Cycle-time recording |
158
+ | 82–100 | Why not story_start minus story_end? |
159
+ | 101–121 | CI verification |
160
+ | 122–127 | Solo-local fallback detail |
157
161
  | 128–134 | Handoff |
158
- | 136–155 | Reference block 1 (manual squash) |
162
+ | 135–159 | Reference block 1 |
159
163
 
160
164
  # Release Branch — Reference
161
165
 
@@ -128,16 +128,26 @@ Emit these fences in `AGENTS.md` (and therefore `CLAUDE.md` symlink) from `docs/
128
128
 
129
129
  | Lines | Section |
130
130
  |-------|---------|
131
- | 1–4 | Title + story tags |
132
- | 6–22 | Navigation (this table) |
133
- | 24–35 | AGENTS.md spine |
134
- | 37–76 | Agent config template |
135
- | 78–85 | opencode.json template |
136
- | 87–96 | Aider bridge |
137
- | 98–108 | Codex CLI wiring |
138
- | 110–118 | CONVENTIONS.md |
139
- | 120–122 | Stack profile fragments |
140
- | 124–153 | Local tool wiring |
131
+ | 1 | Title |
132
+ | 5–29 | Navigation |
133
+ | 30–53 | Fenced markers (e45s21) |
134
+ | 54–65 | AGENTS.md spine (Reach Template — e37s01) |
135
+ | 66–77 | Agent config template (legacy — prefer AGENTS.md spine) |
136
+ | 78–81 | Project |
137
+ | 82–91 | Commands |
138
+ | 92–94 | Architecture |
139
+ | 95–98 | Conventions |
140
+ | 99–104 | Never |
141
+ | 105–114 | Agent Rules |
142
+ | 115–123 | opencode.json template |
143
+ | 124–133 | Aider — `.aider.conf.yml` bridge (e37s03) |
144
+ | 134–146 | Codex CLI — project-local `.codex/config.toml` + AGENTS.md (e37s14) |
145
+ | 147–156 | CONVENTIONS.md |
146
+ | 157–160 | Stack profile fragments |
147
+ | 161–164 | Local tool wiring (optional interview step 8) |
148
+ | 165–173 | Cursor — project-local `.cursor/rules` symlink |
149
+ | 174–187 | OpenCode — project-local `opencode.json` + `AGENTS.md` |
150
+ | 188–190 | When to offer |
141
151
 
142
152
  ## Fenced markers (e45s21)
143
153
 
@@ -89,11 +89,15 @@ Part of **★ VERIFY ★**: `verify-work` → `validate-contracts` → `smoke-te
89
89
  | Lines | Section |
90
90
  |-------|---------|
91
91
  | 1 | Title |
92
- | 3–12 | Navigation |
93
- | 14–31 | Runner script |
94
- | 33–42 | Configuration reference |
95
- | 44–53 | Verification |
96
- | 55–160 | Reference blocks 1–5 |
92
+ | 3–17 | Navigation |
93
+ | 18–34 | Runner script |
94
+ | 35–46 | Configuration reference |
95
+ | 47–55 | Verification |
96
+ | 56–89 | Reference block 1 |
97
+ | 90–107 | Reference block 2 |
98
+ | 108–122 | Reference block 3 |
99
+ | 123–159 | Reference block 4 |
100
+ | 160–177 | Reference block 5 |
97
101
 
98
102
  ## Runner script
99
103
 
@@ -87,12 +87,21 @@ Part of **★ VERIFY ★**: `verify-work` → `validate-contracts` → `smoke-te
87
87
  | Lines | Section |
88
88
  |-------|---------|
89
89
  | 1 | Title |
90
- | 3–14 | Navigation |
91
- | 16–24 | Integration |
92
- | 26–35 | Configuration |
93
- | 37–46 | Verification |
94
- | 48–170 | Reference blocks + Examples 1–6 |
95
- | 172–190 | Integration (duplicate) + Configuration + Verification |
90
+ | 3–23 | Navigation |
91
+ | 24–32 | Integration |
92
+ | 33–44 | Configuration |
93
+ | 45–54 | Verification |
94
+ | 55–71 | Reference block 1 |
95
+ | 72–92 | Reference block 2 |
96
+ | 93–104 | Example 1 |
97
+ | 105–121 | Example 2 |
98
+ | 122–133 | Example 3 |
99
+ | 134–144 | Example 4 |
100
+ | 145–165 | Example 5 |
101
+ | 166–176 | Example 6 |
102
+ | 177–185 | Integration |
103
+ | 186–197 | Configuration |
104
+ | 198–204 | Verification |
96
105
 
97
106
  ## Integration
98
107
 
@@ -118,11 +118,18 @@ See [REFERENCE.md](REFERENCE.md).
118
118
  | Lines | Section |
119
119
  |-------|---------|
120
120
  | 1 | Title |
121
- | 3–14 | Navigation |
122
- | 16–38 | Examples |
123
- | 40–52 | Options |
124
- | 54–62 | Integration with build-epic |
125
- | 64–270 | Reference blocks 1–8 |
121
+ | 3–20 | Navigation |
122
+ | 21–22 | Examples |
123
+ | 23–39 | Create CI for a Go project (TBR + optional deploy) |
124
+ | 40–49 | Create CI for a CLI tool (TBR only, no deploy) |
125
+ | 50–57 | Validate existing workflows (no generation) |
126
+ | 58–70 | Options |
127
+ | 71–79 | Integration with build-epic |
128
+ | 80–154 | Reference block 1 — test-build-release.yml (Go, excerpt) |
129
+ | 155–204 | Reference block 2 — deploy.yml (generic web app, excerpt) |
130
+ | 205–232 | Reference block 3 — CLI dogfood (big-release pattern) |
131
+ | 233–257 | Reference block 4 — validate script |
132
+ | 258–268 | Reference block 5 — dry-run |
126
133
 
127
134
  ## Examples
128
135
 
@@ -47,7 +47,7 @@ Write the document focusing on "Expert Collaboration":
47
47
 
48
48
  1. Ask: "Project name? One-sentence description?"
49
49
  2. Generate `README.md` at project root using the template in [REFERENCE.md](REFERENCE.md) — no TOC, no second interview round.
50
- 3. Fill gaps from `CLAUDE.md` commands if available; use `TODO` markers otherwise.
50
+ 3. Fill gaps from `CLAUDE.md` / `AGENTS.md` commands if available (prefer `AGENTS.md`); use `TODO` markers otherwise.
51
51
  4. Output and suggest `edit-document` for polish.
52
52
 
53
53
  → verify: `test -f README.md && [ "$(grep -c '^## ' README.md)" -ge 7 ]`
@@ -86,10 +86,36 @@ Combined from dbader/readme-template and jehna/readme-best-practices. No TOC.
86
86
  | Lines | Section |
87
87
  |-------|---------|
88
88
  | 1 | Title |
89
- | 5–16 | Navigation |
90
- | 18–24 | Sections intro |
91
- | 26–178 | README section templates (1–15) |
92
- | 180–183 | Verify |
89
+ | 5–40 | Navigation |
90
+ | 41–42 | Sections |
91
+ | 43–54 | 1. Title + Badges |
92
+ | 55–60 | 2. Tagline |
93
+ | 61–64 | 3. Description |
94
+ | 65–67 | 4. Prerequisites |
95
+ | 68–75 | Prerequisites |
96
+ | 76–78 | 5. Installation |
97
+ | 79–89 | Installation |
98
+ | 90–92 | 6. Usage |
99
+ | 93–102 | Usage |
100
+ | 103–105 | 7. Features |
101
+ | 106–113 | Features |
102
+ | 114–116 | 8. Configuration |
103
+ | 117–125 | Configuration |
104
+ | 126–128 | 9. Development Setup |
105
+ | 129–139 | Development |
106
+ | 140–142 | 10. Running Tests |
107
+ | 143–152 | Tests |
108
+ | 153–155 | 11. Contributing |
109
+ | 156–164 | Contributing |
110
+ | 165–167 | 12. Changelog |
111
+ | 168–172 | Changelog |
112
+ | 173–175 | 13. Links |
113
+ | 176–181 | Links |
114
+ | 182–184 | 14. License |
115
+ | 185–191 | License |
116
+ | 192–194 | 15. Credits (optional) |
117
+ | 195–199 | Credits |
118
+ | 200–202 | Verify |
93
119
 
94
120
  ## Sections
95
121
 
@@ -56,14 +56,14 @@ Full JSON examples, merge rules, Antigravity deny-list entries, and test command
56
56
  | Lines | Section |
57
57
  |-------|---------|
58
58
  | 1 | Title |
59
- | 3–14 | Navigation |
60
- | 16–24 | Secret patterns |
61
- | 26–44 | Copy layout |
62
- | 46–72 | Claude Code |
63
- | 74–92 | Cursor and Cursor CLI |
64
- | 94–120 | Gemini CLI |
65
- | 122–135 | Google Antigravity |
66
- | 137–178 | Verify (local tests) |
59
+ | 3–16 | Navigation |
60
+ | 17–28 | Secret patterns (audit + pre-commit) |
61
+ | 29–46 | Copy layout |
62
+ | 47–72 | Claude Code |
63
+ | 73–94 | Cursor and Cursor CLI |
64
+ | 95–122 | Gemini CLI |
65
+ | 123–137 | Google Antigravity |
66
+ | 138–180 | Verify (local tests) |
67
67
 
68
68
  ## Secret patterns (audit + pre-commit)
69
69
 
@@ -81,7 +81,7 @@ git worktree list | grep "<task-slug>"
81
81
  **Handling Conflicts:**
82
82
  - **Directory exists:** If `../<task-slug>` already exists, ask the user if they want to use it or delete it.
83
83
  - **Branch exists:** If the branch exists but no worktree is attached, ask to use the existing branch (`git worktree add ../<task-slug> <task-slug>`) or delete it.
84
- - **Ghost worktree:** If `git worktree list` shows the path but the directory is missing, run `git worktree prune` to clear the stale metadata.
84
+ - **Ghost worktree:** If `git worktree list` shows the path but the directory is missing, run `git worktree prune` to clear the stale metadata. `bash scripts/cleanup-worktrees.sh` does this plus reports any worktree whose branch is already merged or deleted — advisory only, it prints the `git worktree remove`/`git branch -d` commands rather than running them, so review before acting.
85
85
 
86
86
  ### 4. Create worktree + branch
87
87
 
@@ -253,12 +253,58 @@ These GSD artifacts are not migrated — they are execution records, not plannin
253
253
  | Lines | Section |
254
254
  |-------|---------|
255
255
  | 1 | Title |
256
- | 3–22 | Navigation |
257
- | 24–62 | spec-kit → bigpowers Mapping |
258
- | 64–130 | BMAD → bigpowers Mapping |
259
- | 132–154 | Learnings to Adopt |
260
- | 156–350 | Output Formats + state.yaml template |
261
- | 352–620 | Reference blocks 1–2 + extended mappings |
256
+ | 3–68 | Navigation |
257
+ | 69–70 | spec-kit → bigpowers Mapping |
258
+ | 71–84 | Artifact Locations |
259
+ | 85–94 | `spec.md` → `specs/product/SCOPE_LATEST.yaml` + `specs/tech-architecture/TECH_STACK_LATEST.md` |
260
+ | 95–105 | `plan.md` → `specs/tech-architecture/TECH_STACK_LATEST.md` + `specs/release-plan.yaml` + `specs/epics/` |
261
+ | 106–114 | `tasks.md` → `specs/epics/` (via slice-tasks) |
262
+ | 115–120 | `.specify/` state |
263
+ | 121–122 | BMAD → bigpowers Mapping |
264
+ | 123–141 | Artifact Locations |
265
+ | 142–148 | `product-brief.md` / `prfaq-{project}.md` → `specs/product/VISION_LATEST.yaml` |
266
+ | 149–160 | `prd.md` → `specs/product/SCOPE_LATEST.yaml` + `GLOSSARY_LATEST.yaml` |
267
+ | 161–167 | `addendum.md` + `decision-log.md` → `specs/adr/` + `specs/DECISION-LOG_LATEST.md` |
268
+ | 168–174 | `architecture.md` → `specs/tech-architecture/TECH_STACK_LATEST.md` + `specs/adr/` |
269
+ | 175–178 | `epic-*.md` → `specs/release-plan.yaml` + `specs/epics/eNN-*.yaml` |
270
+ | 179–182 | `story-*.md` → `specs/epics/` stories |
271
+ | 183–188 | `project-context.md` → `CLAUDE.md` |
272
+ | 189–192 | Learnings to Adopt |
273
+ | 193–198 | From GSD |
274
+ | 199–204 | From spec-kit |
275
+ | 205–212 | From BMAD |
276
+ | 213–214 | Output Formats |
277
+ | 215–224 | ADR format (bigpowers) |
278
+ | 225–227 | Context |
279
+ | 228–230 | Decision |
280
+ | 231–234 | Consequences |
281
+ | 235–246 | DECISION-LOG.md format |
282
+ | 247–257 | MIGRATION-AUDIT.md format |
283
+ | 258–264 | Summary |
284
+ | 265–274 | High Priority Findings |
285
+ | 275–278 | Information |
286
+ | 279–285 | Next Steps |
287
+ | 286–306 | in_scope format with ID tracking |
288
+ | 307–341 | REQUIREMENTS_TRACE.yaml format |
289
+ | 342–397 | `specs/state.yaml` template format |
290
+ | 398–416 | Reference block 1 |
291
+ | 417–432 | Reference block 2 |
292
+ | 433–451 | Reference block 3 |
293
+ | 452–474 | Reference block 4 |
294
+ | 475–482 | Reference block 5 |
295
+ | 483–484 | Findings |
296
+ | 485–489 | High Priority |
297
+ | 490–495 | Information |
298
+ | 496–509 | Reference block 6 |
299
+ | 510–542 | Step 7 — Post-migration: Optional two-pass spec writing gate |
300
+ | 543–574 | Step 8 — Post-migration: Optional methodology doc template |
301
+ | 575–600 | Artifact Mapping Summary |
302
+ | 601–610 | Rules |
303
+ | 611–621 | Step 5 — Surface learnings (optional) |
304
+ | 622–644 | Step 6 — Adversarial review (optional) |
305
+ | 645–646 | Findings |
306
+ | 647–651 | High Priority |
307
+ | 652–660 | Information |
262
308
 
263
309
  # migrate-spec Reference — spec-kit, BMAD, Learnings
264
310