## What
Adds `--only <skill[,skill,...]>` to `scripts/regen-codex-hashes.sh` and
threads it through `scripts/regen-all.sh` (`--skills` arg /
`REGEN_SKILLS` env), so an agent can regenerate codex hashes for **only
the skills it touched**.
## Why
From `.agents/retro/2026-05-31-bead-crank-postmortem.md` §5 (#1-2): the
codex hash regen rewrites every drifted manifest entry, sweeping ~8-9
pre-existing drifts into every skill PR and forcing a manual
`jq`-splice. Scoping the loop kills that toil.
## Changes
- **`regen-codex-hashes.sh`**: `--only` parses a skill set; the
per-skill loop `continue`s when a skill isn't in the set. `--check`
honors the same scope. Default (no flag) = all skills, unchanged.
`SKILLS_ROOT` is now env-overridable (enables hermetic testing).
- **`regen-all.sh`**: `--skills a,b` / `REGEN_SKILLS=a,b` threads
`--only` into the codex-hash step in both regen and `--check` modes;
trailing NOTE instructs passing scope when only some skills changed.
- **`tests/scripts/regen-codex-hashes-only.bats`**: hermetic — `--only
foo` regenerates only foo and leaves a simulated pre-existing-drift
sibling untouched; no-`--only` regenerates all; `--check` scoping;
comma-list; arg-required.
## Verification
- `bats tests/scripts/regen-codex-hashes-only.bats` — 5/5 pass
- `shellcheck -S warning` clean on both scripts
- `git diff origin/main --stat` scope-only (2 scripts + 1 bats)
- The 9 manifest drifts on `main` (deps, post-mortem, provenance,
red-team, release, scenario, ship-loop, skill-builder, trace) are
**pre-existing**; this PR touches zero `skills-codex/` files.
Closes-scenario: ag-fbe9#regen-scoping
Bounded-context: BC2-Validation
Evidence: scripts/regen-codex-hashes.sh
The regen-codex-hashes.sh auto-copy feature copied reference files
containing Claude-specific primitives (TeamCreate, backend-claude-teams)
into codex skills, causing parity audit failures. Revert the script
change and remove all auto-copied files. Keep only the reviewer-config
example that was intentionally created.
- Auto-copy references to skills-codex in regen-codex-hashes.sh
- Add line-count check and codex parity step to plan template
- Add --fast-path flag to plan Flags table
- Create reviewer-config-example.md for council
- Major rewrite of vs-gsd.md (GSD v1.27 is no longer lightweight)
- Moderate update of vs-compound-engineer.md (ideation, refresh, 10 runtimes)
Automates the manual Python snippet needed after any skills-codex/ change.
Reuses the exact hash_tree() from validate-codex-generated-manifest.sh.
Supports --check (dry-run) mode for CI use.