You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 2b0ac27
Browse filesBrowse the repository at this point in the historyBrowse files
Remove gh-aw's generated mutable `agentic-workflows` router during Squad enlistment and fail installation verification when that unowned skill remains.
Copy file name to clipboardExpand all lines: .github/agents.md
+13Lines changed: 13 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -50,8 +50,21 @@ The quick start installs this workflow set:
50
50
```bash
51
51
SQUAD_SHA="<40-character-commit-sha>"# explicit, maintainer-approved; never `commits/dev`
52
52
gh aw add "bradygaster/squad/workflows@${SQUAD_SHA}"
53
+
rm -f .github/skills/agentic-workflows/SKILL.md
53
54
```
54
55
56
+
The removal is intentional: gh-aw v0.89.22 generates that generic tool-owned
57
+
router, which loads mutable prompts from the current `github/gh-aw` repository.
58
+
It is not Squad-owned or bound to `SQUAD_SHA`. Keep the exact
59
+
`.github/skills/gh-aw-enlistment/SKILL.md` installed by Squad.
60
+
This repository routes gh-aw work directly through the
61
+
`agentic-workflows-dev` specialist in `.squad/routing.md`, with the local
62
+
`agentic-workflow-designer` and `gh-aw-reliability` skills for design and
63
+
contract validation. None depends on the deleted router. Retaining a rewritten
64
+
or pinned copy would make Squad the owner of a forked generic gh-aw prompt
65
+
router and its upstream corpus; removal preserves the package boundary without
66
+
vendoring or synchronizing that mutable scaffold.
67
+
55
68
This command:
56
69
57
70
1. Fetches the Squad dispatcher, general and dependency workers, independent reviewer with a required-check gate, retrospective, and approval-gated improvement worker
Copy file name to clipboardExpand all lines: README.md
+6-1Lines changed: 6 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -588,6 +588,7 @@ test "$(gh api "repos/${owner_repo}" --jq '.has_issues')" = "true" || {
588
588
589
589
SQUAD_SHA="<40-character-commit-sha>"# explicit, maintainer-approved; never `commits/dev`
590
590
gh aw add "bradygaster/squad/workflows@${SQUAD_SHA}"
591
+
rm -f .github/skills/agentic-workflows/SKILL.md
591
592
git add -- \
592
593
.github/aw/ \
593
594
.github/skills/ \
@@ -606,12 +607,16 @@ Review the complete generated diff before you commit:
606
607
|------|-------------------|---------|
607
608
|`.github/workflows/`| The Squad workflow sources, shared imports, compiled lock files, and `agentics-maintenance.yml`| Yes |
608
609
|`.github/aw/`| Supporting gh-aw state, including pinned action versions and SHAs | Yes |
609
-
|`.github/skills/`| The agentic-workflows dispatcher skill| Yes |
610
+
|`.github/skills/`| The exact Squad-owned `gh-aw-enlistment` skill; remove gh-aw's generated mutable `agentic-workflows` router before staging| Yes |
610
611
|`.gitattributes`| Marks compiled `.lock.yml` workflows as generated | Yes |
611
612
|`.vscode/`| Workspace settings that enable GitHub Copilot for Markdown files in VS Code | Optional — commit only if you want to share this workspace setting |
612
613
613
614
`agentics-maintenance.yml` is a second installed workflow. Squad configures its created pull request safe output to expire after 14 days, so this workflow runs scheduled expiration cleanup and also exposes manual maintenance operations. To omit it, create `.github/workflows/aw.json` with `{"maintenance": false}` before installing. gh-aw then warns that expiration is disabled and removes the maintenance workflow.
614
615
616
+
Unlike the mutable router skill, `agentics-maintenance.yml` is compiled runtime
617
+
output required for the configured 14-day safe-output expiration behavior. Keep
618
+
it unless you explicitly disable maintenance before installation.
@@ -495,6 +513,10 @@ state under `.github/aw/`, the installed skills, and `.gitattributes`. Review
495
513
the complete generated diff in the bootstrap PR, address Copilot review
496
514
feedback, and wait for required checks. Merge only after human approval.
497
515
516
+
The exact router deletion above is the only permitted staged deletion, for an
517
+
upgrade from a repository that previously committed it. Any other deletion is
518
+
a hard stop.
519
+
498
520
Consumer ignore rules such as `packages/` can silently omit the required
499
521
`.github/aw/packages/` ownership JSON from directory staging. The staged verifier
500
522
force-adds only the exact native package ownership JSON when ignored and
@@ -575,7 +597,7 @@ Use this checklist for the initial bootstrap and after any workflow update:
575
597
| Stage | Action | Expected evidence |
576
598
|-------|--------|-------------------|
577
599
| Repository readiness | Confirm `.has_issues` is `true`;if it is `false`, enable it before installing workflows | GitHub Issues are available for`/squad` comments and the bootstrap research/proposals issue; insufficient administration permission stops the install before a bootstrap PR is created |
578
-
| Install | Run the eight-workflow `gh aw add`command on a bootstrap branch| All eight `.md`/`.lock.yml` pairs exist, with shared imports, `.github/aw/`, installed skills, and `.gitattributes` included in the diff |
600
+
| Install | Run the eight-workflow `gh aw add`command on a bootstrap branch, then remove the exact tool-owned mutable router | All eight `.md`/`.lock.yml` pairs exist, with shared imports, `.github/aw/`, the exact Squad-owned `gh-aw-enlistment` skill, and `.gitattributes` included in the diff;`.github/skills/agentic-workflows/SKILL.md` is absent|
579
601
| Compile | Review any first-install safe-update report, approve only the documented entries, then run `gh aw compile --strict` without approval | All eight workflows succeed, only documented warnings remain, and all sixteen source/lock files exist |
580
602
| Bootstrap review | Open the installation PR, request `@copilot`, inspect verifier/compile evidence, and merge only after human approval | The run reports the explicit first-install manual boundary; no `Squad-Review-Verdict:` record or PR-controlled check is treated as trusted |
581
603
| Activation canary | Merge the workflow-installation PR and inspect the Cast PR — automatically opened, or manually opened by a human from the bootstrap fallback issue's compare-URL link when `can_approve_pull_request_reviews=false` blocks direct creation | `Squad Review / review` succeeds with reserved bootstrap roles only after loading the guard and manifest from the exact base commit and validating the default-branch bootstrap run — including, for a manually opened PR, the signed fallback-issue provenance record |
@@ -1919,6 +1941,7 @@ same native package as one unit:
1919
1941
SQUAD_SHA="<40-character-commit-sha>"
1920
1942
1921
1943
gh aw add "bradygaster/squad/workflows@${SQUAD_SHA}" --force
0 commit comments