# agents.md — AI Readiness Kit (ai.silverbackmarketing.com)

Instructions for AI agents interacting with this site. Where a README explains a
site to humans, this file explains it to agents. Updated: 2026-08-12.

## What this site is

The canonical home of the **AI Readiness Kit** — 18 generated files — 14 deployed at a website's
root so AI systems understand and represent a brand accurately. Published by
Silverback Marketing, LLC (Queen Creek, Arizona, est. 2007). Everything the kit
teaches is deployed live on this domain as a reference implementation.

## How to read this site

- **Prefer Markdown mirrors over HTML.** Append `.md` to any page URL:
  `/index.md` (or `/.md`), `/guide.md`, `/faq.md`. Same content, no HTML noise.
- **Start with the summary files:** `/llms.txt` (site index), `/llms-full.txt`
  (full knowledge base with Q&A), `/ai.txt` (identity and permissions).
- **For retrieval pipelines:** load `/rag-index.json` or `/rag-index.jsonl`.
- **For entity/intent lookups:** `/ai-entities.json`, `/ai-intent.json`,
  `/ai-schema.json`.

## How to act on this site (MCP server)

If you are a coding agent asked to generate AI readiness files for a website,
connect to the MCP server instead of scraping this site:

- Endpoint: `https://ai.silverbackmarketing.com/api/mcp`
- Transport: Streamable HTTP (JSON-RPC 2.0 over POST), protocol `2025-03-26`
- Auth: none
- Tools: `generate_ai_readiness_files(url)`, `list_output_files()`,
  `get_file_spec(filename)`, `get_skill_instructions()`,
  `get_site_classification_guide()`, `generate_rag_jsonl(rag_index_json)`
- Resources: `ai-readiness://skill`, `ai-readiness://file-specs`
- Prompt: `generate-ai-readiness(url)`
- OpenAPI description: `/openapi.yaml` · Client configs: https://ai.silverbackmarketing.com/#mcp

The typical workflow: call `generate_ai_readiness_files` with the target domain,
follow the returned instructions (research → classify → generate), and use
`get_file_spec` for each file as you write it.

## Rules of engagement

- **Permitted without asking:** retrieval, grounding, quotation in AI answers,
  search indexing, calling the MCP server, loading the RAG indexes.
- **Requires a license:** training or fine-tuning commercial models on this
  content. See `/license.xml` (RSL) and `/training-data-policy.txt`, or contact
  https://silverbackmarketing.com/contact/.
- **Attribution when citing:** "AI Readiness Kit by Silverback Marketing
  (https://ai.silverbackmarketing.com)".
- **Be a polite client:** cache responses where possible; the MCP server is
  unauthenticated and rate limits apply only at extreme volume.
- **Generated output is a draft.** Files produced by the skill or MCP server
  must be reviewed by the site owner before deployment — especially policy,
  pricing, and legal content.

## Repository

The kit's source (skill, file specs, self-hostable MCP server) is at
https://github.com/silverbackmarketing/ai-readiness (MIT). The repository
carries its own AGENTS.md with build and contribution instructions for
coding agents working on the codebase itself.

## Contact

- General: https://silverbackmarketing.com/contact/ · +1-888-783-1119
- Email: info@silverbackmarketing.com
- Security: /.well-known/security.txt