Skip to content

docs(gh-aw): pin verified bootstrap snapshot #2039

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
bradygaster merged 1 commit into from
Sep 14, 2026
Merged

docs(gh-aw): pin verified bootstrap snapshot #2039

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 13 additions & 7 deletions docs/src/content/docs/guide/gh-aw.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,14 +41,15 @@ gh api --method PUT "repos/${owner_repo}/actions/permissions/workflow" \
# 3. Create a bootstrap branch
git switch -c chore/squad-gh-aw-bootstrap

# 4. Add the Squad workflows to your repo
# 4. Add the Squad workflows from the verified dev snapshot
SQUAD_WORKFLOW_SHA="9fa83c5f00109bda25e93acf16648d0c67817b26"
gh aw add \
bradygaster/squad/workflows/squad.md@dev \
bradygaster/squad/workflows/squad-implement-worker.md@dev \
bradygaster/squad/workflows/squad-review.md@dev \
bradygaster/squad/workflows/squad-deps-worker.md@dev \
bradygaster/squad/workflows/squad-retro.md@dev \
bradygaster/squad/workflows/squad-improvement-worker.md@dev
bradygaster/squad/workflows/squad.md@${SQUAD_WORKFLOW_SHA} \
bradygaster/squad/workflows/squad-implement-worker.md@${SQUAD_WORKFLOW_SHA} \
bradygaster/squad/workflows/squad-review.md@${SQUAD_WORKFLOW_SHA} \
bradygaster/squad/workflows/squad-deps-worker.md@${SQUAD_WORKFLOW_SHA} \
bradygaster/squad/workflows/squad-retro.md@${SQUAD_WORKFLOW_SHA} \
bradygaster/squad/workflows/squad-improvement-worker.md@${SQUAD_WORKFLOW_SHA}

# 5. On first install, review the safe-update report.
# If it contains only the documented Squad secrets and init action, approve it:
Expand Down Expand Up @@ -92,6 +93,11 @@ gh pr edit --add-reviewer @copilot
gh pr checks --watch
```

The quick start pins the merged `dev` snapshot containing the bootstrap fixes so
a demo or one-time setup cannot change between runs. For the normal supported
development-channel install, use the `@dev` command in
[Install the workflows](#install-the-workflows).

> Step 7 stages `.github/skills/` because `gh aw add` installs the Squad skills
> alongside the workflows, and it deliberately does not stage `.github/aw/logs/`.
> Downloaded workflow logs are local diagnostic output — see [ignoring downloaded
Expand Down
Loading