export const AGENT_MD_TEMPLATE = `# Integration guide for external AI agents

This directory contains a claude4spec specification. Pages (\`*.md\`) reference
entities stored in \`.claude4spec/db.sqlite\` through XML tags.

## Resolving a tag

Install \`claude4spec\` (Node 20+) and use the \`c4s\` CLI. Subcommand names
match XML tag names 1:1.

| XML tag | CLI equivalent |
|---------|----------------|
| \`<inline_mention type="endpoint" slug="X"/>\` | \`c4s inline_mention --type endpoint --slug X\` |
| \`<single_element type="dto" slug="X"/>\` | \`c4s single_element --type dto --slug X\` |
| \`<element_list type="endpoint" slugs="a,b,c"/>\` | \`c4s element_list --type endpoint --slugs a,b,c\` |
| \`<tagged_list type="dto" tags="auth" filter="and"/>\` | \`c4s tagged_list --type dto --tags auth --filter and\` |
| \`<tagged_list_mixed tags="public"/>\` | \`c4s tagged_list_mixed --tags public\` |

## Expanding a whole page

\`\`\`sh
c4s resolve some-page.md              # writes markdown with tags expanded inline
c4s resolve some-page.md --format json   # writes { content, resolved: [...] }
\`\`\`

## Discovery

- \`c4s catalog\` — entity types, versions, and JSON Schema per view.
- \`c4s list-tags\` — all tags with per-type counts.
- \`c4s list-slugs --type endpoint\` — all slugs for a given type.

All output is JSON (pretty) by default. Use \`--compact\` for pipelines and
\`--format text\` for terminal-friendly output. Errors go to stderr as JSON with
an exit code > 0.

The database is opened **read-only** — \`c4s\` never mutates the project.

## MCP server (for MCP-aware agents)

Agents that prefer typed MCP tools over shell-out (Claude Code, Cursor,
Windsurf, ...) can register \`c4s-reader\` as an MCP server. Add to your
editor's MCP config (\`.mcp.json\` for Claude Code, \`~/.cursor/mcp.json\` for
Cursor, ...):

\`\`\`json
{
  "mcpServers": {
    "c4s-reader": {
      "command": "npx",
      "args": ["-y", "claude4spec", "c4s-mcp", "--project", "/path/to/this/project"]
    }
  }
}
\`\`\`

Or, with a global install (\`npm i -g claude4spec\`):

\`\`\`json
{
  "mcpServers": {
    "c4s-reader": {
      "command": "c4s-mcp",
      "args": ["--project", "/path/to/this/project"]
    }
  }
}
\`\`\`

The server exposes 8 readonly tools: \`get_entity\`, \`get_entities\`,
\`find_by_tag\`, \`get_section\`, \`resolve_page\`, \`catalog\`, \`list_tags\`,
\`list_slugs\`. Each tool that returns serialized entities accepts a \`view\`
parameter (\`inline_mention\`, \`single_element\`, \`element_list_item\`,
\`tagged_list_item\`, \`detail\`). Like the CLI, the database is opened
**read-only** — writes always go through the main \`claude4spec\` server.
`;
//# sourceMappingURL=agent-md-template.js.map