Menu
Use when changing the router's tool-search / discovery surface — the search_tools or call_tool meta-tools, the BM25 index, entrypoint pinning, or hint/normalization rewriting.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Use when `make ci-local` fails locally or a GitHub Actions run reports a CI failure (format, lint, line-budget, typecheck, or test errors).
Use when reviewing a diff, PR, or change set for correctness and quality before merge or handoff. For a deep security-only pass, use security-review instead.
Use when bringing this repo into compliance with a GeneFoundry fleet standard (tool-naming, response-envelope, container-hardening, versioning, MCP transport, or logging) or closing its tracking issue.
Use when preparing to tag, publish, or deploy a genefoundry-router build.
Use when reviewing genefoundry-router security before deploy, when touching auth/proxy/logging/limits config, or when answering an infosec/DSB question.
Use when changing the router's authentication or authorization — JWT/OAuth modes, verifiers, resource/audience metadata, the secure-by-default bind guard, or the no-token-passthrough boundary.
| name | tool-search-change |
| description | Use when changing the router's tool-search / discovery surface — the search_tools or call_tool meta-tools, the BM25 index, entrypoint pinning, or hint/normalization rewriting. |
Follow AGENTS.md first. The router doesn't author backend tools; it exposes two synthetic meta-tools over the federated fleet — search_tools (BM25 discovery, token-lean serialization) and call_tool (invoke a discovered tool by name) — in tool_search.py, plus discovery hints/normalization in hints.py / normalization.py / discovery.py.
tool_search.py (search_tools / call_tool), and discovery.py / hints.py / normalization.py for the catalog and rewrites.search_tools output token-lean (the default serialization drops _meta and trims to a one-line returns); don't regress payload size.search_tools -> call_tool contract in the tool descriptions.make snapshot-catalog) and keep golden-task / guard tests green; make list-tools to sanity-check the surface.GF_SEARCH_MAX_RESULTS / GF_REWRITE_HINTS via config, not hard-coded values. Run make ci-local.search_tools results with full schemas/_meta — it's the token-lean discovery path.search_tools -> call_tool handshake the tool descriptions promise.