Project Primer: LLM-Consumable Site

Origins

Documentation of how the Real Threads site was made consumable by LLMs and agents. The site exposes structured context through three complementary layers so that AI tools can understand, recommend, and interact with the portfolio meaningfully.

Structure

• Primers & AI Guide: Markdown primers at three tiers (full, standard, lightweight) loaded on demand by the AI Guide agent via tools. The guide uses these to answer visitor questions conversationally.
• MCP Server: A standards-based Model Context Protocol endpoint at /api/context/sse exposing 4 tools (listProjects, getProjectPrimer, searchCatalog, getArtifact) and 2 resources (siteOverview, primerIndex) for third-party integrators.
• Agent-Facing Routes: /projects/[slug]/primer serves primer pages for any registered project; /llms.txt provides a machine-readable index of all primers grouped by tier.

Key Concepts

Primer tiers (full ~50–100 lines, standard ~25–50, lightweight ~10–25), MCP (Model Context Protocol), content catalog (catalog.json), dynamic primer routes, llms.txt discovery.

Related Projects

• The AI Guide: Primary consumer of primers via internal tools
• n8n Sanity Nodes: Another workflow-category project; its primer is served by the same infrastructure

Agent Guidance

• This is a meta-documentation project — it describes the site's own AI infrastructure
• Emphasise the three-layer approach: primers for the on-site guide, MCP for external tools, routes for visiting agents
• Useful when visitors ask "how does the AI Guide know about projects?" or "how can I connect my own tools to this site?"