Skip to content

Commit cec83b6

Browse files
bradygasterCopilot
andcommitted
docs: pin Agents-tab workflow topology
Closes #2048 Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
1 parent 18f24e7 commit cec83b6

1 file changed

Lines changed: 26 additions & 11 deletions

File tree

‎docs/src/content/docs/guide/gh-aw.md‎

Lines changed: 26 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -153,14 +153,14 @@ it must not depend on the previous session remaining open.
153153
> maintain, or admin access because Squad authorizes planning commands from
154154
> `github.actor`.
155155
156-
Replace the two placeholder values at the top. Optionally customize
157-
`INSTALL_BRANCH`, then paste the complete prompt into the Agents tab:
156+
Replace `TARGET_REPO` at the top. Optionally customize `INSTALL_BRANCH`, then
157+
paste the complete prompt into the Agents tab:
158158

159159
```text
160160
You are coordinating the supported Squad GitHub Agentic Workflows journey.
161161
162162
TARGET_REPO="<OWNER/REPOSITORY>"
163-
SQUAD_SHA="<FINAL_PINNED_40_CHARACTER_SQUAD_COMMIT_SHA>"
163+
SQUAD_SHA="da7861de22483b83c0321ad534954e637a11dbdf"
164164
INSTALL_BRANCH="chore/squad-gh-aw-bootstrap"
165165
166166
Work only in TARGET_REPO. Verify that SQUAD_SHA is exactly 40 lowercase
@@ -309,16 +309,34 @@ At every pause, give the human exact URLs and the one action required. Never
309309
promise automatic resume after this Agents session completes.
310310
```
311311

312-
### Evidence required before replacing the placeholders
312+
### Pinned package topology and remaining hosted evidence
313313

314314
The prompt above documents the intended source and compiled contracts. Do not
315-
describe the end-to-end hosted behavior as observed until the final workflow
316-
changes are merged and all three hosted journeys provide the evidence below.
315+
describe the end-to-end hosted behavior as observed until all three hosted
316+
journeys provide the evidence below.
317+
318+
The immutable package revision is
319+
`da7861de22483b83c0321ad534954e637a11dbdf`. Its authoritative
320+
`workflows/squad-workflows.manifest.json` declares this exact topology:
321+
322+
- **8 workflows:** `squad`, `squad-implement-worker`, `squad-review`,
323+
`squad-deps-worker`, `squad-retro`, `squad-improvement-worker`,
324+
`squad-bootstrap`, and `squad-command-router`.
325+
- **17 shared runtime resources:** `shared/squad-review-guard.mjs`,
326+
`shared/squad-install-verifier.mjs`, `shared/squad-command-contract.mjs`,
327+
`shared/squad-cast-validator.mjs`, `shared/squad-bootstrap-validator.mjs`,
328+
`shared/squad-improvement-gate.mjs`, `shared/squad-retro-evidence.mjs`,
329+
`shared/squad-retro-provenance.mjs`,
330+
`shared/squad-implementation-provenance.mjs`, `shared/squad.md`,
331+
`shared/squad-planning-ontology.md`, `shared/squad-planning-policy.md`,
332+
`shared/implementation-provenance-v1.schema.json`,
333+
`shared/builtins/scribe-charter.md`, `shared/builtins/ralph-charter.md`,
334+
`shared/builtins/rai-charter.md`, and
335+
`shared/builtins/fact-checker-charter.md`.
336+
- **1 skill:** `gh-aw-enlistment`.
317337

318338
| Evidence | Required placeholder |
319339
|----------|----------------------|
320-
| Final immutable Squad package revision | `<FINAL_PINNED_40_CHARACTER_SQUAD_COMMIT_SHA>` |
321-
| Final manifest topology: workflow count/names, runtime count/names, skill names | `<FINAL_MANIFEST_TOPOLOGY>` |
322340
| Hosted backend clean-bootstrap set: pinned install, human installation merge, automatic bootstrap, exactly one draft Cast PR and one research-proposals issue, run-owned cleanup | `<HOSTED_RUN_1_URLS>` |
323341
| Hosted frontend full-lifecycle set: granular research, triage, plan acceptance and activation, implementation dispatch, automatic exact-head Squad Review required-check blocking and satisfaction, manual relay dedupe, human approval and merge, cleanup | `<HOSTED_RUN_2_URLS>` |
324342
| Hosted queue-worker negative/recovery set: malformed and unknown command fail-closed diagnostics, no-command non-event, reviewer equality, stale-verdict and relay blocking, recovery and idempotency, cleanup | `<HOSTED_RUN_3_URLS>` |
@@ -328,9 +346,6 @@ from durable GitHub state, exact bootstrap output cardinality and provenance,
328346
the granular planning artifacts, and accepted-plan-to-created-issue
329347
reconciliation. Until then, the recovery and end-to-end statements above are
330348
contract-based instructions, not a claim that the final hosted runs succeeded.
331-
The final topology placeholder is also intentional: the workflow implementation
332-
changes must merge first, then the workflow names and counts must be copied from
333-
the manifest at the same immutable SHA used by the hosted runs.
334349

335350
---
336351

0 commit comments

Comments
 (0)