1111 when : " Every step: preflight identity/auth, enabling Actions-created PRs, opening and watching the bootstrap PR."
1212 - name : " gh aw"
1313 description : " GitHub Agentic Workflows extension (github/gh-aw) — installs and strictly compiles the Squad workflow set."
14- when : " Installing the six @dev workflows and compiling them into deterministic .lock.yml files."
14+ when : " Installing the seven @dev workflows and compiling them into deterministic .lock.yml files."
1515---
1616
1717## Context
@@ -99,7 +99,7 @@ git switch -c chore/squad-gh-aw-bootstrap
9999 not part of the Squad set. ` gh aw add ` is additive; if you see it about to
100100 replace an unrelated workflow, ** STOP** .
101101
102- ### 3. Install the six supported workflows — in order, dispatcher first
102+ ### 3. Install the seven supported workflows — in order, dispatcher first
103103
104104``` bash
105105gh aw add \
@@ -108,24 +108,28 @@ gh aw add \
108108 bradygaster/squad/workflows/squad-review.md@dev \
109109 bradygaster/squad/workflows/squad-deps-worker.md@dev \
110110 bradygaster/squad/workflows/squad-retro.md@dev \
111- bradygaster/squad/workflows/squad-improvement-worker.md@dev
111+ bradygaster/squad/workflows/squad-improvement-worker.md@dev \
112+ bradygaster/squad/workflows/squad-bootstrap.md@dev
112113```
113114
114115Keep ` squad.md ` first: ` gh aw add ` discovers its worker/reviewer dependencies
115116while compiling it, and the explicit entries confirm the full surface without
116- creating duplicates. The installed top-level set is exactly:
117+ creating duplicates. Keep ` squad-bootstrap.md ` last because it is the dedicated
118+ post-install workflow rather than a dispatcher dependency. The installed
119+ top-level set is exactly:
117120
118121- ` squad.md ` + ` squad.lock.yml `
119122- ` squad-implement-worker.md ` + ` squad-implement-worker.lock.yml `
120123- ` squad-review.md ` + ` squad-review.lock.yml `
121124- ` squad-deps-worker.md ` + ` squad-deps-worker.lock.yml `
122125- ` squad-retro.md ` + ` squad-retro.lock.yml `
123126- ` squad-improvement-worker.md ` + ` squad-improvement-worker.lock.yml `
127+ - ` squad-bootstrap.md ` + ` squad-bootstrap.lock.yml `
124128
125129` squad-improvement-worker ` is part of the standard, coherent install above —
126130not a separate opt-in add-on. It stays dormant until a maintainer approves a
127131governance-scoped retrospective proposal (see the gh-aw guide's retrospective
128- auto-implementation section); installing it alongside the other five keeps the
132+ auto-implementation section); installing it alongside the other six keeps the
129133full stack consistent and avoids a second bootstrap pass later.
130134
131135Report/proposal-only is the default. Ordinary fixes require the explicit
@@ -179,22 +183,22 @@ gh aw compile --strict
179183This must run after any first-install approval and before committing. Success
180184criteria:
181185
182- - All six workflows compile successfully.
186+ - All seven workflows compile successfully.
183187- The ** only** permitted warning is the known ` squad.md ` bot-trigger warning: it
184188 configures both slash-command and ` github-actions[bot] ` triggers, and the bot
185189 trigger is required for controlled worker-continuation dispatches.
186190- ** STOP** on any error, or on ** any additional warning** beyond that single
187191 documented one.
188192
189- ### 6. Require all six source/lock pairs to exist
193+ ### 6. Require all seven source/lock pairs to exist
190194
191195``` bash
192- for workflow in squad squad-implement-worker squad-review squad-deps-worker squad-retro squad-improvement-worker; do
196+ for workflow in squad squad-implement-worker squad-review squad-deps-worker squad-retro squad-improvement-worker squad-bootstrap ; do
193197 test -f " .github/workflows/${workflow} .md" || { echo " MISSING ${workflow} .md" ; exit 1; }
194198 test -f " .github/workflows/${workflow} .lock.yml" || { echo " MISSING ${workflow} .lock.yml" ; exit 1; }
195199done
196200
197- for runtime_module in squad-cast-validator squad-improvement-gate squad-retro-evidence squad-retro-provenance; do
201+ for runtime_module in squad-cast-validator squad-bootstrap-validator squad- improvement-gate squad-retro-evidence squad-retro-provenance; do
198202 test -f " .github/workflows/shared/${runtime_module} .mjs" || {
199203 echo " MISSING shared/${runtime_module} .mjs"
200204 exit 1
210214```
211215
212216- ** STOP** and rerun ` gh aw compile --strict ` if any ` .lock.yml ` is missing. Do not
213- open or merge the bootstrap PR until all ** twelve ** files exist and strict
217+ open or merge the bootstrap PR until all ** fourteen ** files exist and strict
214218 compilation passes.
215219- ** STOP** if any required ` shared/*.mjs ` runtime module is missing. The
216220 dispatcher must install the complete transitive resource set; compile success
221225
222226> On Windows PowerShell, the ` for ` /` test -f ` loop above is POSIX. Use an
223227> equivalent guard (e.g. ` Test-Path ` ) or run it under Git Bash; the * logic* — all
224- > twelve files must exist — is what matters.
228+ > fourteen files must exist — is what matters.
225229
226230### 7. Inspect generated files, then stage only the documented surfaces
227231
@@ -275,12 +279,13 @@ gh pr checks --watch
275279
276280- ** Never** merge the bootstrap PR yourself. Merge happens ** only** after human
277281 approval.
278- - Make the two-PR flow explicit to the user: ` /squad cast ` runs ** only after the
279- bootstrap PR merges** . Casting analyzes the codebase and opens a ** separate,
280- human-reviewed Cast PR** containing the team, routing, charters, the Copilot
281- agent, and ` meet-the-squad.md ` . If a work command (` /squad implement ` ,
282- ` /squad review ` ) is run before a team exists, it auto-opens that Cast PR first —
283- merge it and rerun the original command; do not start a second cast.
282+ - Make the two-PR flow explicit to the user: after the workflow-installation PR
283+ reaches the default branch, ` squad-bootstrap ` automatically creates one
284+ ** draft, human-reviewed Cast PR** and one linked
285+ ` [Research Proposals] Agent-discovered repo opportunities ` issue from the same
286+ validated repository analysis. The user reviews and merges the Cast PR, then
287+ follows the issue's ` /squad research ` , ` /squad triage ` , ` /squad plan ` , and
288+ ` /squad activate ` instructions until assignable implementation issues exist.
284289
285290## Examples
286291
@@ -300,7 +305,8 @@ gh aw add \
300305 bradygaster/squad/workflows/squad-review.md@dev \
301306 bradygaster/squad/workflows/squad-deps-worker.md@dev \
302307 bradygaster/squad/workflows/squad-retro.md@dev \
303- bradygaster/squad/workflows/squad-improvement-worker.md@dev
308+ bradygaster/squad/workflows/squad-improvement-worker.md@dev \
309+ bradygaster/squad/workflows/squad-bootstrap.md@dev
304310
305311# Safe-update report shows ONLY the two documented secrets + squad-init → approve once
306312gh aw compile --strict --approve
@@ -361,6 +367,7 @@ gh pr merge --squash # auto-merge before human review. NEVER.
361367- ❌ ** Clobbering existing workflows.** The install is additive; preserve unrelated
362368 ` .github/workflows/ ` files.
363369- ❌ ** Widening the default token.** Keep ` default_workflow_permissions=read ` .
364- - ❌ ** Auto-merging.** The bootstrap PR and the later Cast PR are both
365- human-reviewed. ` /squad cast ` runs only after the bootstrap PR merges.
366- - ❌ ** Opening the PR before all twelve files exist and strict compile passes.**
370+ - ❌ ** Auto-merging.** The workflow-installation PR and automatic Cast PR are
371+ both human-reviewed. The dedicated bootstrap wakes only after installation
372+ lands on the default branch.
373+ - ❌ ** Opening the PR before all fourteen files exist and strict compile passes.**
0 commit comments