[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7APM3627ZRFB28RGGNG4WZB":3,"skill-same:01M7APM3627ZRFB28RGGNG4WZB":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},"01M7APM3627ZRFB28RGGNG4WZB","check-api-boundaries",null,"Creates and verifies source contracts for HTTP route and middleware boundaries. Use when checking root probes, timeout\u002Fauth\u002FCORS groups, streaming exceptions, route mounters, or production wiring split across router and server bootstrap files.","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-api-boundaries\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: check-api-boundaries\ndescription: Creates and verifies source contracts for HTTP route and middleware boundaries. Use when checking root probes, timeout\u002Fauth\u002FCORS groups, streaming exceptions, route mounters, or production wiring split across router and server bootstrap files.\n---\n\n# Check API Boundaries\n\n## Outcome\n\nEncode a route\u002Fmiddleware architecture boundary as grounded facts: which routes are at the root, which registrations bypass middleware, which registrations remain inside it, and how production bootstrap supplies those groups.\n\n## Existing Contract Fast Path\n\nWhen the user supplies an existing contract, do not begin with broad repository search.\n\nThe commands below are authoritative. Do not search for the skill, checker, or source before running the preflight.\n\n1. Run `shepherd check \"$REPO\" --contract \"$CONTRACT\" --json`.\n2. If the installed bin is unavailable in this checkout, run `node src\u002Fshepherd-cli.ts check \"$REPO\" --contract \"$CONTRACT\" --json` from the repository root.\n3. Do not invent flags such as `--context`.\n4. On PASS, use returned grounded facts and inspect only source paths needed for the requested risk review.\n5. On FAIL, inspect only failed facts and their bounded source paths before changing the contract.\n6. Treat `check-source-contract` as the deterministic authority. If the user also requests an answer, hand the passing contract to `query-large-source`; do not reconstruct the answer in this skill.\n\n## Use When\n\n- Route placement relative to middleware is part of the architecture.\n- Streaming\u002FSSE routes must bypass a request timeout.\n- Health probes must remain outside normal route groups.\n- Production wiring lives in a separate bootstrap file.\n\nDo not use source shape as a substitute for runtime behavior tests. Keep timeout cancellation, auth behavior, CORS behavior, and streaming behavior covered by normal tests.\n\n## Workflow\n\n1. Identify the config-aware router constructor, not a test-only wrapper.\n2. Read the bounded router function and mark exact middleware boundaries.\n3. Identify root routes, bypass groups, and protected groups as separate facts.\n4. Read the production config wiring for list-valued route mounters.\n5. Use explicit `afterLiteral` and `beforeLiteral` scope anchors around middleware groups.\n6. Set exact cardinality from current source, without embedding expected captured values.\n7. Render a compact boundary answer from grounded facts.\n8. Run `shepherd check` locally before `\u002Fshepherd query` and in CI on relevant route\u002Fconfig changes.\n\n## Contract Patterns\n\nRoot quoted paths:\n\n```json\n{\n  \"source\": {\"kind\": \"symbol\", \"name\": \"NewRouterWithConfig\", \"before\": 0, \"after\": 80},\n  \"select\": {\"kind\": \"contains-all\", \"literals\": [\"r.Get(\", \"health.Handler()\"]},\n  \"capture\": {\"kind\": \"quoted-string\", \"index\": 0},\n  \"reduce\": {\"kind\": \"join\", \"exactCount\": 2, \"separator\": \",\"}\n}\n```\n\nMiddleware-scoped config field:\n\n```json\n{\n  \"source\": {\"kind\": \"symbol\", \"name\": \"NewRouterWithConfig\", \"before\": 0, \"after\": 80},\n  \"scope\": {\n    \"afterLiteral\": \"api.Use(middleware.Timeout(cfg.RequestTimeout))\",\n    \"beforeLiteral\": \"\\t})\",\n    \"maxLines\": 12\n  },\n  \"select\": {\"kind\": \"contains-all\", \"literals\": [\"range cfg.\"]},\n  \"capture\": {\"kind\": \"identifier-after\", \"literal\": \"cfg.\"},\n  \"reduce\": {\"kind\": \"single\", \"exactCount\": 1}\n}\n```\n\nProduction list wiring:\n\n```json\n{\n  \"source\": {\n    \"kind\": \"search-open\",\n    \"literal\": \"SSEMounts:\",\n    \"path\": \"cmd\u002Fserver\u002Fmain.go\",\n    \"before\": 5,\n    \"after\": 12\n  },\n  \"scope\": {\"afterLiteral\": \"SSEMounts:\", \"beforeLiteral\": \"},\", \"maxLines\": 8},\n  \"select\": {\"kind\": \"identifier-chain-line\", \"trailingDelimiter\": \",\"},\n  \"capture\": {\"kind\": \"identifier-chain\", \"stripTrailingDelimiter\": true},\n  \"reduce\": {\"kind\": \"join\", \"exactCount\": 2, \"separator\": \",\"}\n}\n```\n\n## Failure Policy\n\n- A missing middleware anchor is an architecture change, not a reason to drop scope.\n- A changed route count requires inspection of root\u002Fgroup placement.\n- If multiple groups use the same literal, narrow the source\u002Fscope rather than selecting the first match.\n- Never infer that a route bypasses middleware from its name; require source placement evidence.\n\n## Acceptance\n\n- Every boundary fact is grounded in the owning router\u002Fbootstrap source.\n- Root, bypass, and protected groups are represented separately.\n- Source drift fails before any model call.\n- Runtime API\u002FE2E tests remain the authority for actual request behavior.\n","# Check API Boundaries\n\n## Outcome\n\nEncode a route\u002Fmiddleware architecture boundary as grounded facts: which routes are at the root, which registrations bypass middleware, which registrations remain inside it, and how production bootstrap supplies those groups.\n\n## Existing Contract Fast Path\n\nWhen the user supplies an existing contract, do not begin with broad repository search.\n\nThe commands below are authoritative. Do not search for the skill, checker, or source before running the preflight.\n\n1. Run `shepherd check \"$REPO\" --contract \"$CONTRACT\" --json`.\n2. If the installed bin is unavailable in this checkout, run `node src\u002Fshepherd-cli.ts check \"$REPO\" --contract \"$CONTRACT\" --json` from the repository root.\n3. Do not invent flags such as `--context`.\n4. On PASS, use returned grounded facts and inspect only source paths needed for the requested risk review.\n5. On FAIL, inspect only failed facts and their bounded source paths before changing the contract.\n6. Treat `check-source-contract` as the deterministic authority. If the user also requests an answer, hand the passing contract to `query-large-source`; do not reconstruct the answer in this skill.\n\n## Use When\n\n- Route placement relative to middleware is part of the architecture.\n- Streaming\u002FSSE routes must bypass a request timeout.\n- Health probes must remain outside normal route groups.\n- Production wiring lives in a separate bootstrap file.\n\nDo not use source shape as a substitute for runtime behavior tests. Keep timeout cancellation, auth behavior, CORS behavior, and streaming behavior covered by normal tests.\n\n## Workflow\n\n1. Identify the config-aware router constructor, not a test-only wrapper.\n2. Read the bounded router function and mark exact middleware boundaries.\n3. Identify root routes, bypass groups, and protected groups as separate facts.\n4. Read the production config wiring for list-valued route mounters.\n5. Use explicit `afterLiteral` and `beforeLiteral` scope anchors around middleware groups.\n6. Set exact cardinality from current source, without embedding expected captured values.\n7. Render a compact boundary answer from grounded facts.\n8. Run `shepherd check` locally before `\u002Fshepherd query` and in CI on relevant route\u002Fconfig changes.\n\n## Contract Patterns\n\nRoot quoted paths:\n\n```json\n{\n  \"source\": {\"kind\": \"symbol\", \"name\": \"NewRouterWithConfig\", \"before\": 0, \"after\": 80},\n  \"select\": {\"kind\": \"contains-all\", \"literals\": [\"r.Get(\", \"health.Handler()\"]},\n  \"capture\": {\"kind\": \"quoted-string\", \"index\": 0},\n  \"reduce\": {\"kind\": \"join\", \"exactCount\": 2, \"separator\": \",\"}\n}\n```\n\nMiddleware-scoped config field:\n\n```json\n{\n  \"source\": {\"kind\": \"symbol\", \"name\": \"NewRouterWithConfig\", \"before\": 0, \"after\": 80},\n  \"scope\": {\n    \"afterLiteral\": \"api.Use(middleware.Timeout(cfg.RequestTimeout))\",\n    \"beforeLiteral\": \"\\t})\",\n    \"maxLines\": 12\n  },\n  \"select\": {\"kind\": \"contains-all\", \"literals\": [\"range cfg.\"]},\n  \"capture\": {\"kind\": \"identifier-after\", \"literal\": \"cfg.\"},\n  \"reduce\": {\"kind\": \"single\", \"exactCount\": 1}\n}\n```\n\nProduction list wiring:\n\n```json\n{\n  \"source\": {\n    \"kind\": \"search-open\",\n    \"literal\": \"SSEMounts:\",\n    \"path\": \"cmd\u002Fserver\u002Fmain.go\",\n    \"before\": 5,\n    \"after\": 12\n  },\n  \"scope\": {\"afterLiteral\": \"SSEMounts:\", \"beforeLiteral\": \"},\", \"maxLines\": 8},\n  \"select\": {\"kind\": \"identifier-chain-line\", \"trailingDelimiter\": \",\"},\n  \"capture\": {\"kind\": \"identifier-chain\", \"stripTrailingDelimiter\": true},\n  \"reduce\": {\"kind\": \"join\", \"exactCount\": 2, \"separator\": \",\"}\n}\n```\n\n## Failure Policy\n\n- A missing middleware anchor is an architecture change, not a reason to drop scope.\n- A changed route count requires inspection of root\u002Fgroup placement.\n- If multiple groups use the same literal, narrow the source\u002Fscope rather than selecting the first match.\n- Never infer that a route bypasses middleware from its name; require source placement evidence.\n\n## Acceptance\n\n- Every boundary fact is grounded in the owning router\u002Fbootstrap source.\n- Root, bypass, and protected groups are represented separately.\n- Source drift fails before any model call.\n- Runtime API\u002FE2E tests remain the authority for actual request behavior.\n",{"name":5,"description":7},"main","fdbd9818a5ac8a0ab084eab8b9eda2c2c20f3baa","skills\u002Fcheck-api-boundaries","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-api-boundaries",{"tool":37,"command":38},"bunx","bunx skills add reoring\u002Fshepherd --skill check-api-boundaries",{"tool":40,"command":41},"pnpm","pnpm dlx skills add reoring\u002Fshepherd --skill check-api-boundaries","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Freoring\u002Fshepherd\u002Fblob\u002Fmain\u002Fskills\u002Fcheck-api-boundaries\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},"01M7APMN62J2KPG4T2AMR4ZHR5","check-source-contract","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.","https:\u002F\u002Fgithub.com\u002Freoring\u002Fshepherd\u002Fblob\u002Fmain\u002Fskills\u002Fcheck-source-contract\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},"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":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},"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":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},"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":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},"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",[],[]]