docs(pipeline-crew): drop dead {#id} anchors from EXPLANATION.md, repoint HOW-TO links to GitHub auto-slugs (#3613)#3617
Conversation
…md, repoint HOW-TO links to GitHub auto-slugs (#3613) GitHub's markdown renderer does not honor Kramdown `{#id}` custom-anchor syntax — it drops the token and auto-generates a heading slug from the heading text — so every in-repo deep link of the form `EXPLANATION.md#<id>` resolved the file but jumped nowhere (silent dead fragment). Drop the four `{#id}` tokens from EXPLANATION.md and repoint the four sibling links in HOW-TO.md to GitHub's real auto-generated heading slugs (computed with github-slugger, the algorithm GitHub uses). No `{#id}` custom-anchor syntax remains in the pipeline-crew doc set. Doc navigation only; no code path affected. Fixes #3613 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
|
review-code: PASS @ 5902c5e — merge-ready Verified PR #3617 against the acceptance criteria of #3613, one at a time (docs-only diff:
Run-evidence bundle: N/A — docs-only diff, no build/test surface; verified from the head files + github-slugger auto-slug computation. Non-control-plane crew doc surface (founder ruling: all crew surfaces are non-§CP). All criteria pass. This PR is merge-ready. review-code does not merge — |
What & why
claude-plugins/pipeline-crew/EXPLANATION.mddeclared four section anchors with Kramdown{#id}custom-anchor syntax. GitHub's markdown renderer does not honor{#id}— it drops the token and auto-generates its own slug from the heading text — so every in-repo deep link of the formEXPLANATION.md#<custom-id>resolved the file but jumped nowhere on GitHub (silent dead fragment). Scope is doc navigation only; no code path is affected.Changes
EXPLANATION.md— dropped the{#id}token from all four headings (roster law, §CP hard gate, verify-don't-relay, single-owner comms). GitHub now generates its own heading slugs.HOW-TO.md— repointed the four sibling deep links (landed via PR docs(pipeline-crew): plugin How-to — add a role · configure personalization · reboot · carry a §CP PR · retire a crew #3611) to GitHub's real auto-generated slugs, computed withgithub-slugger(the algorithm GitHub's renderer uses), not hand-guessed:#roster-law→#the-roster-law--singleton-bridges-vs-a-fungible-engine(2 links)#cp-gate→#the-cp-hard-gate--the-engine-banks-a-human-approves-the-pipeline-enqueues#verify-dont-relay→#verify-dont-relay--a-claim-is-not-evidence-until-you-read-the-artifactThe fourth heading (single-owner comms) has no inbound link in the doc set, so no link update was needed for it.
Acceptance criteria
EXPLANATION.mdno longer carry{#id}tokens.{#id}custom-anchor syntax remains in the pipeline-crew doc set (grep clean).Non-control-plane crew doc surface (founder ruling: all crew surfaces are non-§CP) — ship-on-green.
Fixes #3613