Update to Linchpin

{
  "description": "Route PRD creation, upgrade, and execution requests through the linchpin intake contract.",
  "included_files": [],
  "name": "linchpin",
  "skill_md_contents": "---\nname: linchpin\ndescription: Route PRD creation, upgrade, and execution requests through the linchpin intake contract.\n---\n\n# linchpin router\n\nThe `references/`, `scripts/`, and `skills/` directories all sit at the plugin\nroot, so from this file the plugin root is `../..`. Resolve every path in this\nskill against that root — never against a path you assemble from the plugin\nname and version. The installed layout nests the marketplace above the plugin\n(`.../cache/<marketplace>/<plugin>/<version>/`), so a guessed absolute path is\nwrong by one segment and the first read fails. If you do not already know this\nfile's absolute path, discover the root once:\n\n```sh\nfind \"${CODEX_HOME:-$HOME/.codex}/plugins\" -type f -path '*/linchpin/*/references/intake.md' | head -1\n```\n\nRead `references/intake.md` before dispatch. This skill is a thin entry point;\nthe intake reference owns the rules. The runtime pins are in\n`references/runtime.md`, and the manager uses `scripts/linchpin.sh` for the\nmachine-checkable preflight, contract, and mode decisions.\n\n## Dispatch table\n\n| Route id | User intent | Precondition | Dispatch |\n|---|---|---|---|\n| `ROUTE-WRITE-PRD` | \"write/draft/author a PRD for X\" | none | `prd-creator` |\n| `ROUTE-BUILD-SMALL` | \"build/implement X\" | complexity score <= 2 | refuse pipeline; offer direct edit |\n| `ROUTE-BUILD-LARGE` | \"build/implement X\" | complexity score >= 3 | `prd-creator`, then stop for confirmation |\n| `ROUTE-EXECUTE-CONFORMING` | \"run/execute/start/begin/launch/resume\" | every supplied PRD path exists | `prd-swarm-coordinator` |\n| `ROUTE-EXECUTE-UPGRADE` | user explicitly asks to standardize a PRD | any | `migrate`, then `prd-creator` upgrade mode |\n| `ROUTE-EXECUTE-NONE` | \"run/execute/start\" | no PRD supplied, or a supplied path is not on disk | ask once for the PRD path |\n| `ROUTE-AMBIGUOUS` | intent cannot be classified | any | ask one short question; never guess |\n\n## Dispatch procedure\n\n1. Run `scripts/linchpin.sh route \"<intent>\" <prd-path>...` **before** you plan\n   or announce anything. `start`, `begin`, `launch`, and `resume` are execution\n   verbs. A request naming PRDs that already exist is never an authoring\n   request; do not draft a new PRD, a companion, or a corrected copy of one.\n   Normalize the argv first: split quoted paths that ran together, and read a\n   bare `.` or other directory as the target repository, not as a missing PRD.\n   A path that is missing blocks itself, not the batch — route the survivors and\n   ask once about the one that is gone.\n2. Compute the complexity score for build/implement requests. Route scores 1–2\n   to a direct edit refusal; route scores 3+ to creator and stop for explicit\n   confirmation.\n3. For execute requests, **run the PRDs the user pointed at, as written.** The\n   `prd_contract: v1` standard applies to PRDs Linchpin authors, not to the\n   user's own document. A missing marker, a legacy heading, a prose file list, or\n   an absent ledger is an `ADVISORY` line — not a blocker, and not a reason to\n   rewrite, migrate, or re-draft anything. Hand every supplied path to the\n   coordinator. Only run `scripts/linchpin.sh migrate` when the user explicitly\n   asks to standardize an artifact. The one real blocker is a path that is not on\n   disk: report it and ask once. Never answer an execution request with a\n   standards complaint.\n4. For conforming inputs, invoke `prd-swarm-coordinator` with all PRDs. One\n   input is still one coordinator lane; there is no separate single path.\n5. Announce any sequential worktree or delivery fallback before it takes effect.\n\nThe direct creator and coordinator skills remain independently discoverable if\nthis router is removed. The router is not a gate.\n"
}