Skip to content

Commit 079618a

Browse files
cliffhallclaude
andcommitted
docs: S9 and S12 after S5; advisory exceptions and audit carve-out; pin guard tests
- S9 and S12 depend on S5, whose board-ops and issue-create they use - S9 adds the GHSA draft-card and Incoming-to-Todo exceptions to AGENTS.md; whichever of S7 and S9 lands second adds the audit carve-out - The verify-action-pins template includes its test file Co-Authored-By: Claude Opus 5.5 <[email protected]>
1 parent 9ec8ec2 commit 079618a

1 file changed

Lines changed: 13 additions & 5 deletions

File tree

‎docs/agent-guidance-inception.md‎

Lines changed: 13 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -334,7 +334,7 @@ Inspector files that can be copied in as starting points (paths on its
334334
| `scripts/gate-lease.mjs` (+ test) | `scripts/` | Env var rename (`SERVERS_SKIP_GATE_LEASE`). Imports `lib/win-shell-args.mjs`, which S2 already ports | S10 |
335335
| `scripts/lib/workflow-gate.mjs` (+ test) | `scripts/lib/` | Our workflow list and `local:*` scripts; drop the browser-engine rationale and its `lib/headless-browser.mjs` import | S10 |
336336
| `scripts/verify-format-coverage.mjs`, `scripts/verify-typecheck-coverage.mjs`, and `scripts/lib/tsc-program.mjs` (+ tests), which the latter imports | `scripts/` | Workspace globs instead of `clients/*`. Both also import S2's `lib/npm-scripts.mjs` | S3 |
337-
| `scripts/verify-action-pins.mjs` | `scripts/` | Workflow list. It imports `SHA_REF` from `dependency-refresh.mjs`, which doesn't land until S13, so **extract the SHA matcher into `scripts/lib/action-refs.mjs`** in S12; S13's `dependency-refresh` then imports it from there | S12 |
337+
| `scripts/verify-action-pins.mjs` (+ `verify-action-pins.test.mjs`, covering credential detection, transitive artifact producers and fail-closed workflow parsing) | `scripts/` | Workflow list. It imports `SHA_REF` from `dependency-refresh.mjs`, which doesn't land until S13, so **extract the SHA matcher into `scripts/lib/action-refs.mjs`** in S12; S13's `dependency-refresh` then imports it from there | S12 |
338338
| `scripts/dependency-refresh.mjs`, `scripts/dependabot-alerts.mjs`, `scripts/sdk-watch.mjs` + workflows | `scripts/`, `.github/workflows/` | Add the uv/PyPI ecosystem; SDK groups for TS and Python; board #43; labels | S13 |
339339
| `docs/skill-authoring.md` | `docs/` | Paths only | S2 |
340340
| `docs/quality-gate.md` | `docs/` | Rewrite for two languages; keep the structure (tiers table, local-only steps, lease) | S10 |
@@ -400,9 +400,9 @@ the Servers V2 board (#43). "After" means the listed issue must merge first.
400400
```
401401
W1 #4859 inception (this doc)
402402
W2 S1 AGENTS.md · S2 skills harness · S4 Py validate · then S3 TS validate (after S2)
403-
W3 S5 board-ops + issue-create · S8 contribution model · S9 security-advisory · then S6 pr-flow (after S5) and S7 issue-triage (after S5, S8)
403+
W3 S5 board-ops + issue-create · S8 contribution model · then S6 pr-flow (after S5), S9 security-advisory (after S5) and S7 issue-triage (after S5, S8)
404404
W4 S10 local:gate + coverage + pre-push-gate (after S2, S3, S4, #4854, #4855) · S11 knowledge skills (after S2)
405-
W5 #4472 changesets + Release-triggered publish → S12 milestone release flow + release skill (after #4472, S10, S11)
405+
W5 #4472 changesets + Release-triggered publish → S12 milestone release flow + release skill (after #4472, S5, S10, S11)
406406
W6 S13 dependency & SDK sweeps replace Dependabot PRs; closing factory overview (after S5, S12)
407407
```
408408

@@ -561,9 +561,16 @@ S5 and S8)
561561
next milestone merge to `main`).
562562

563563
**S9 (#4870). `security-advisory` skill; reconcile `SECURITY.md` and the advisory backlog**
564+
(after S5: the flow uses `board-ops` for the draft card and `issue-create` for
565+
public tracking)
564566
- Scope: adapt §6: draft `[GHSA-…]` card, ownership check (this server vs the
565567
SDK), accept/reject, private fork, fix, publish, public tracking. **Accept
566-
and publish stay human-only.** Rewrite `SECURITY.md` so it matches the
568+
and publish stay human-only.** Add the two narrow advisory exceptions to
569+
`AGENTS.md`'s board rules, as the Inspector does: a `[GHSA-…]` **draft
570+
card** is the one allowed non-issue card, and accepting an advisory moves
571+
its (necessarily unmilestoned) draft from Incoming to Todo. Give the board
572+
audit the matching `[GHSA-` carve-out; **whichever of S7 and S9 lands
573+
second** adds it. Rewrite `SECURITY.md` so it matches the
567574
enabled private reporting. Plan how the 61-advisory triage backlog is worked
568575
(the plan only, not the triage itself).
569576
- Acceptance:
@@ -616,7 +623,8 @@ with its scope unchanged (§7). Its two bump PRs are why S12's preparation step
616623
is more than one PR.
617624

618625
**S12 (#4873). `v2/main` → `main` milestone release flow and `release` skill** (after
619-
#4472, S10, S11; the ledger uses S11's `client-smoke`)
626+
#4472, S5, S10, S11; the release issue is filed through S5's `issue-create`,
627+
and the ledger uses S11's `client-smoke`)
620628
- Scope:
621629
- **A release issue per milestone** (`Release vX.Y.Z`), filed through
622630
`issue-create`. Every preparation PR (on `v2/main`, where closing

0 commit comments

Comments
 (0)