[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7APMN62J2KPG4T2AMR4ZHR5":3,"skill-same:01M7APMN62J2KPG4T2AMR4ZHR5":45},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":13,"repositoryHtmlUrl":26,"repositoryHomepageUrl":6,"ownerHtmlUrl":27,"ownerBlogUrl":28,"ownerDescription":29,"updatedAt":30,"install":31,"resources":44},"01M7APMN62J2KPG4T2AMR4ZHR5","check-source-contract",null,"Validates a versioned source-fact contract deterministically with zero model calls. Use in local development or CI to detect extraction, grounding, finalization, answer-pattern, and source drift failures.","reoring\u002Fshepherd","reoring","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F735890?v=4","01M7APHZAJGX99VWAZ856836G5","01M7APHZB3FNAJ4KRRN51D8DJ8",0,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Freoring\u002Fshepherd\u002Fblob\u002Fmain\u002Fskills\u002Fcheck-source-contract\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: check-source-contract\ndescription: Validates a versioned source-fact contract deterministically with zero model calls. Use in local development or CI to detect extraction, grounding, finalization, answer-pattern, and source drift failures.\n---\n\n# Check Source Contract\n\n## Outcome\n\nProve that a versioned RLM contract matches the current tracked source without invoking an LLM provider. Return grounded facts, failure codes, answer preview, source revision, and CI-compatible exit status.\n\n## Use When\n\n- Authoring or reviewing an RLM contract.\n- Editing source covered by a contract.\n- Preflighting a `query-large-source` call.\n- Running local or CI source-drift checks.\n- Separating source\u002Fcontract failures from model\u002Fprovider failures.\n\n## First Action\n\nThe checker and skill locations are already resolved. Do not run `ls`, `find`, `which`, or `cat SKILL.md`. When `src\u002Fshepherd-cli.ts` exists from the current repository root, run the `node src\u002Fshepherd-cli.ts check` command immediately; otherwise use `shepherd check`.\n\n## Command\n\nInstalled package:\n\n```bash\nshepherd check \"$REPO\" --contract \"$CONTRACT\" --json\n```\n\nThis repository checkout, from the repository root:\n\n```bash\nnode src\u002Fshepherd-cli.ts check \\\n  \"$REPO\" --contract \"$CONTRACT\" --json\n```\n\nUse `--isolation docker` only when worker-isolation parity is part of the check.\n\n## Exit Contract\n\n```text\n0: contract\u002Fsource check passed\n1: deterministic contract\u002Fsource mismatch\n2: usage, file, JSON, or runtime error\n```\n\nNever convert exit `1` into a warning when the user asked for a gate. Never retry with a model.\n\n## Result Review\n\nOn PASS verify:\n\n- all required facts are grounded\n- extractor failures are zero\n- runtime finalizer state matches the contract\n- answer pattern passes when configured\n- `modelCalls` is zero\n\nOn FAIL report:\n\n- failed fact ID\n- failure code\n- bounded source path\n- selected\u002Fcaptured counts\n- pending facts\n- answer\u002Ffinalizer state\n\nDo not change cardinality, anchors, or selectors only to make the check green. Read the owning source and decide whether source or contract should change.\n\n## Cross-Harness Use\n\nThe deterministic checker core remains the authority:\n\n- OMP and Pi: native `\u002Fshepherd check` executes immediately without an outer-agent model turn.\n- Claude: use the direct shell command for an explicit check; use `\u002Fcheck-source-contract` only when Claude must select the workflow.\n- CI: use the headless command without provider credentials.\n\nAutomatic skill selection necessarily spends an outer-agent decision; explicit checks should use the native or shell fast path.\n\n## Working Tree\n\nTracked-file content is read from the current working tree, so staged and unstaged edits are checked. Untracked files are absent until added to the Git index. Current source revision display is HEAD-based and may not identify dirty content uniquely.\n\n## Acceptance\n\n- Check performs zero model calls.\n- PASS\u002FFAIL is deterministic for the same source and contract.\n- Contract drift exits `1`.\n- Config\u002Fruntime errors exit `2`.\n- Query execution is not attempted after a failed check.\n","# Check Source Contract\n\n## Outcome\n\nProve that a versioned RLM contract matches the current tracked source without invoking an LLM provider. Return grounded facts, failure codes, answer preview, source revision, and CI-compatible exit status.\n\n## Use When\n\n- Authoring or reviewing an RLM contract.\n- Editing source covered by a contract.\n- Preflighting a `query-large-source` call.\n- Running local or CI source-drift checks.\n- Separating source\u002Fcontract failures from model\u002Fprovider failures.\n\n## First Action\n\nThe checker and skill locations are already resolved. Do not run `ls`, `find`, `which`, or `cat SKILL.md`. When `src\u002Fshepherd-cli.ts` exists from the current repository root, run the `node src\u002Fshepherd-cli.ts check` command immediately; otherwise use `shepherd check`.\n\n## Command\n\nInstalled package:\n\n```bash\nshepherd check \"$REPO\" --contract \"$CONTRACT\" --json\n```\n\nThis repository checkout, from the repository root:\n\n```bash\nnode src\u002Fshepherd-cli.ts check \\\n  \"$REPO\" --contract \"$CONTRACT\" --json\n```\n\nUse `--isolation docker` only when worker-isolation parity is part of the check.\n\n## Exit Contract\n\n```text\n0: contract\u002Fsource check passed\n1: deterministic contract\u002Fsource mismatch\n2: usage, file, JSON, or runtime error\n```\n\nNever convert exit `1` into a warning when the user asked for a gate. Never retry with a model.\n\n## Result Review\n\nOn PASS verify:\n\n- all required facts are grounded\n- extractor failures are zero\n- runtime finalizer state matches the contract\n- answer pattern passes when configured\n- `modelCalls` is zero\n\nOn FAIL report:\n\n- failed fact ID\n- failure code\n- bounded source path\n- selected\u002Fcaptured counts\n- pending facts\n- answer\u002Ffinalizer state\n\nDo not change cardinality, anchors, or selectors only to make the check green. Read the owning source and decide whether source or contract should change.\n\n## Cross-Harness Use\n\nThe deterministic checker core remains the authority:\n\n- OMP and Pi: native `\u002Fshepherd check` executes immediately without an outer-agent model turn.\n- Claude: use the direct shell command for an explicit check; use `\u002Fcheck-source-contract` only when Claude must select the workflow.\n- CI: use the headless command without provider credentials.\n\nAutomatic skill selection necessarily spends an outer-agent decision; explicit checks should use the native or shell fast path.\n\n## Working Tree\n\nTracked-file content is read from the current working tree, so staged and unstaged edits are checked. Untracked files are absent until added to the Git index. Current source revision display is HEAD-based and may not identify dirty content uniquely.\n\n## Acceptance\n\n- Check performs zero model calls.\n- PASS\u002FFAIL is deterministic for the same source and contract.\n- Contract drift exits `1`.\n- Config\u002Fruntime errors exit `2`.\n- Query execution is not attempted after a failed check.\n",{"name":5,"description":7},"main","fdbd9818a5ac8a0ab084eab8b9eda2c2c20f3baa","skills\u002Fcheck-source-contract","https:\u002F\u002Fgithub.com\u002Freoring\u002Fshepherd","https:\u002F\u002Fgithub.com\u002Freoring","http:\u002F\u002Fwww.craftsman-software.com\u002F","Founder of @appthrust. Building platforms with Rust and Kubernetes to enhance app development. Passionate about open-source and developer tools.\r\n","2026-08-18 15:14:28",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add reoring\u002Fshepherd --skill check-source-contract",{"tool":37,"command":38},"bunx","bunx skills add reoring\u002Fshepherd --skill check-source-contract",{"tool":40,"command":41},"pnpm","pnpm dlx skills add reoring\u002Fshepherd --skill check-source-contract","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Freoring\u002Fshepherd\u002Fblob\u002Fmain\u002Fskills\u002Fcheck-source-contract\u002FSKILL.md",true,[],[46,53,60,67,74,81],{"skillNo":47,"name":48,"nameZh":6,"description":49,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":50,"categories":51,"keywords":52,"publishedAt":18},"01M7APMR40H7JBMZ3NVDWCNRN4","query-large-source","Orchestrates conversational questions over large source through direct inspection tools and bounded Shepherd evidence queries.","https:\u002F\u002Fgithub.com\u002Freoring\u002Fshepherd\u002Fblob\u002Fmain\u002Fskills\u002Fquery-large-source\u002FSKILL.md",[],[],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":18},"01M7APMHB56BF0N3VHQ6VAC117","check-sdk-wiring","Creates and verifies cross-file source contracts from handwritten SDK services to generated request builders. Use when preserving validation labels, client method wiring, HTTP methods, URL templates, headers, or idempotency behavior.","https:\u002F\u002Fgithub.com\u002Freoring\u002Fshepherd\u002Fblob\u002Fmain\u002Fskills\u002Fcheck-sdk-wiring\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":18},"01M7APMEHDSQCED821C6P8D317","check-registration-inventory","Creates and verifies source contracts for plugin, controller, route, provider, or handler inventories. Use when an exact registration list, order, or cardinality is an architectural invariant checked locally or in CI.","https:\u002F\u002Fgithub.com\u002Freoring\u002Fshepherd\u002Fblob\u002Fmain\u002Fskills\u002Fcheck-registration-inventory\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":18},"01M7APMBR6T4AAEPT2C2WNWDT2","check-generated-code","Creates bounded source contracts for important facts inside large generated files. Use when verifying request shapes, route tables, bindings, operation names, or headers without loading the full generated artifact into model context.","https:\u002F\u002Fgithub.com\u002Freoring\u002Fshepherd\u002Fblob\u002Fmain\u002Fskills\u002Fcheck-generated-code\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":18},"01M7APM92A4GMQT43JXD803ZBG","check-config-mappings","Creates and verifies source contracts for configuration defaults and constructor wiring. Use when checking zero-value defaults, config field assignments, timeout\u002Fretry settings, environment option mapping, or production constructor fields.","https:\u002F\u002Fgithub.com\u002Freoring\u002Fshepherd\u002Fblob\u002Fmain\u002Fskills\u002Fcheck-config-mappings\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":18},"01M7APM5YV6Z5X2ZB25TGWZ74N","check-cli-registrations","Creates and verifies source contracts for CLI root and subcommand registrations. Use when preserving constructor wiring, source order, exact registration cardinality, or detecting command additions, removals, renames, and duplicates.","https:\u002F\u002Fgithub.com\u002Freoring\u002Fshepherd\u002Fblob\u002Fmain\u002Fskills\u002Fcheck-cli-registrations\u002FSKILL.md",[],[]]