export declare const AGENT_MD_TEMPLATE = "# Integration guide for external AI agents\n\nThis directory contains a claude4spec specification. Pages (`*.md`) reference\nentities stored in `.claude4spec/db.sqlite` through XML tags.\n\n## Resolving a tag\n\nInstall `claude4spec` (Node 20+) and use the `c4s` CLI. Subcommand names\nmatch XML tag names 1:1.\n\n| XML tag | CLI equivalent |\n|---------|----------------|\n| `<inline_mention type=\"endpoint\" slug=\"X\"/>` | `c4s inline_mention --type endpoint --slug X` |\n| `<single_element type=\"dto\" slug=\"X\"/>` | `c4s single_element --type dto --slug X` |\n| `<element_list type=\"endpoint\" slugs=\"a,b,c\"/>` | `c4s element_list --type endpoint --slugs a,b,c` |\n| `<tagged_list type=\"dto\" tags=\"auth\" filter=\"and\"/>` | `c4s tagged_list --type dto --tags auth --filter and` |\n| `<tagged_list_mixed tags=\"public\"/>` | `c4s tagged_list_mixed --tags public` |\n\n## Expanding a whole page\n\n```sh\nc4s resolve some-page.md              # writes markdown with tags expanded inline\nc4s resolve some-page.md --format json   # writes { content, resolved: [...] }\n```\n\n## Discovery\n\n- `c4s catalog` \u2014 entity types, versions, and JSON Schema per view.\n- `c4s list-tags` \u2014 all tags with per-type counts.\n- `c4s list-slugs --type endpoint` \u2014 all slugs for a given type.\n\nAll output is JSON (pretty) by default. Use `--compact` for pipelines and\n`--format text` for terminal-friendly output. Errors go to stderr as JSON with\nan exit code > 0.\n\nThe database is opened **read-only** \u2014 `c4s` never mutates the project.\n\n## MCP server (for MCP-aware agents)\n\nAgents that prefer typed MCP tools over shell-out (Claude Code, Cursor,\nWindsurf, ...) can register `c4s-reader` as an MCP server. Add to your\neditor's MCP config (`.mcp.json` for Claude Code, `~/.cursor/mcp.json` for\nCursor, ...):\n\n```json\n{\n  \"mcpServers\": {\n    \"c4s-reader\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"claude4spec\", \"c4s-mcp\", \"--project\", \"/path/to/this/project\"]\n    }\n  }\n}\n```\n\nOr, with a global install (`npm i -g claude4spec`):\n\n```json\n{\n  \"mcpServers\": {\n    \"c4s-reader\": {\n      \"command\": \"c4s-mcp\",\n      \"args\": [\"--project\", \"/path/to/this/project\"]\n    }\n  }\n}\n```\n\nThe server exposes 8 readonly tools: `get_entity`, `get_entities`,\n`find_by_tag`, `get_section`, `resolve_page`, `catalog`, `list_tags`,\n`list_slugs`. Each tool that returns serialized entities accepts a `view`\nparameter (`inline_mention`, `single_element`, `element_list_item`,\n`tagged_list_item`, `detail`). Like the CLI, the database is opened\n**read-only** \u2014 writes always go through the main `claude4spec` server.\n";
