synrepolisted

--- name: synrepo description: Use synrepo in repositories with a .synrepo/ directory. Prefer synrepo cards, compact search, and bounded task contexts before reading source files cold. --- # synrepo context synrepo is a local, deterministic code-context compiler. It compiles repository files into observed graph facts, code artifacts, task contexts, and cards/MCP packets before agents read source cold. ## Codex setup This skill belongs at `.agents/skills/synrepo/SKILL.md`. Project-scoped setup writes trusted project `.codex/config.toml`. Global Codex MCP registration is not automated by `synrepo setup`; if you configure `~/.codex/config.toml` manually, launch `synrepo mcp` and pass `repo_root` to repo-addressable tools. To add local non-blocking Codex nudges, run `synrepo setup codex --agent-hooks`. For project-scoped manual setup, edit trusted project `.codex/config.toml` directly: ```toml [mcp_servers.synrepo] command = "synrepo" args = ["mcp", "--repo", "."] ``` ## Agent doctrine synrepo is a local, deterministic code-context compiler: `repo files -> graph facts -> code artifacts -> task contexts -> cards/MCP`. In `.synrepo/` repos, prefer MCP/CLI over cold reads for questions, reviews, search, impact, and edits. ### Default path For questions, reviews, search routing, and edits: orient, ask or search, cards, impact or risks, edit, tests, changed. 1. Start with `synrepo_orient` before reading the repo cold. 2. Use `synrepo_ask` for broad plain-language tasks nee