# Katailyst Docs for LLMs

Compact navigation index for Katailyst. Use linked docs for explanation; canonical rules live in `docs/RULES.md` and canonical vision lives in `docs/VISION.md`.

## Fast Start

- [Well-known alias](/.well-known/llms.txt) — Standard discovery location for clients that probe well-known paths.
- [Rules](/api/docs/page.md?path=RULES.md) — Canonical guardrails for how this system should be used and evolved.
- [Vision](/api/docs/page.md?path=VISION.md) — Canonical operating intent and system posture.
- [Agent Quick Start (Katailyst)](/api/docs/page.md?path=QUICK_START_AGENTS.md) — Small-surface-area onboarding for runtime choice, MCP, Vault, and write-back behavior.
- [Katailyst System Guide](/api/docs/page.md?path=runbooks%2Finterop%2Fsystem-guide.md) — High-level orientation for agents connecting over MCP.
- [Context Vs Execution](/api/docs/page.md?path=runbooks%2Finterop%2Fcontext-vs-execution.md) — How to treat KB context differently from execution skills and playbooks.
- [Atomic Unit Rules](/api/docs/page.md?path=atomic-units%2FREADME.md) — Front door for unit classification, package rules, and decision helpers.
- [Mirrors and Packs](/api/docs/page.md?path=references%2Fcontracts%2FMIRRORS_AND_PACKS.md) — Canonical vs mirror vs export surface behavior.
- [Runtime Ownership and Consumption](/api/docs/page.md?path=references%2Fcontracts%2FRUNTIME_OWNERSHIP_AND_CONSUMPTION.md) — Repo vs OpenClaw HQ vs Render runtime boundary model.
- [Core Agent Shared Foundation](/api/docs/page.md?path=references%2Fai-agents%2FCORE_AGENT_SHARED_FOUNDATION.md) — Shared read order, fallback standards, and ownership split for Victoria, Julius, and Lila.
- [Endpoint inventory JSON](/api/endpoints) — Machine-readable API route catalog and error contract.
- [MCP Tools Reference](/api/docs/page.md?path=api%2FMCP_TOOLS_REFERENCE.md) — Live `/mcp` transport, auth modes, capability profiles, prompts, and resources.
- [Agent Quick Start - MCP Setup](/api/docs/page.md?path=QUICK_START_AGENTS.md) — MCP setup for Claude Code and Codex (section 4a).
- [Vault + Tool Execution (End-to-End Guide)](/api/docs/page.md?path=references%2Fcontracts%2FVAULT_TOOL_EXECUTION.md) — Vault-backed tool execution, secret pointers, and runtime rules.
- [Integration Contract - Multimedia Mastery](/api/docs/page.md?path=references%2Fintegrations%2FINTEGRATION_CONTRACT_MULTIMEDIA_MASTERY.md) — Multimedia discovery surfaces, remote MCP contract, and current readiness truth.
- [Per-page markdown export](/api/docs/page.md?path=QUICK_START_AGENTS.md) — Fetch any curated docs page as markdown (authenticated).
- [Full curated corpus](/llms-full.txt) — Concatenated markdown corpus for broad context ingestion.
- [Compatibility alias](/llm.txt) — Backwards-compatible entrypoint for older clients.
- `AGENTS.md` and `CATALYST.md` are repo-root primers and appear first in the compact index/full corpus.

## Core

- `AGENTS.md` — repo-root primer
- `CATALYST.md` — repo-root primer
- [Rules & Guidelines (Agent Operating Rules)](/api/docs/page.md?path=RULES.md) — `docs/RULES.md`
- [Katailyst Vision](/api/docs/page.md?path=VISION.md) — `docs/VISION.md`
- [Agent Quick Start (Katailyst)](/api/docs/page.md?path=QUICK_START_AGENTS.md) — `docs/QUICK_START_AGENTS.md`
- [Agent Readiness Checklist (Execution-Grade)](/api/docs/page.md?path=AGENT_READINESS_CHECKLIST.md) — `docs/AGENT_READINESS_CHECKLIST.md`
- [Taxonomy (Namespaced Tags + Coverage Rules)](/api/docs/page.md?path=TAXONOMY.md) — `docs/TAXONOMY.md`
- [Catalyst: Atomic Units for AI Agents](/api/docs/page.md?path=BLUEPRINT.md) — `docs/BLUEPRINT.md`
- [Atomic Unit Quality: Design Document](/api/docs/page.md?path=atomic-unit-quality.md) — `docs/atomic-unit-quality.md`
- [CEO Vision: Strategy, Team, and Architecture](/api/docs/page.md?path=CEO_VISION.md) — `docs/CEO_VISION.md`
- [Deliberation Engine](/api/docs/page.md?path=deliberation-engine.md) — `docs/deliberation-engine.md`
- [Discovery System](/api/docs/page.md?path=discovery-system.md) — `docs/discovery-system.md`
- [00-START-HERE](/api/docs/page.md?path=ecosystem-map%2F00-START-HERE.md) — `docs/ecosystem-map/00-START-HERE.md`
- [01-ecosystem-atlas-master](/api/docs/page.md?path=ecosystem-map%2F01-ecosystem-atlas-master.md) — `docs/ecosystem-map/01-ecosystem-atlas-master.md`
- [02-content-media-publishing-atlas](/api/docs/page.md?path=ecosystem-map%2F02-content-media-publishing-atlas.md) — `docs/ecosystem-map/02-content-media-publishing-atlas.md`
- [03-repo-runtime-ledger](/api/docs/page.md?path=ecosystem-map%2F03-repo-runtime-ledger.md) — `docs/ecosystem-map/03-repo-runtime-ledger.md`
- [04-integration-schema-reference](/api/docs/page.md?path=ecosystem-map%2F04-integration-schema-reference.md) — `docs/ecosystem-map/04-integration-schema-reference.md`
- [HLT Ecosystem Index for Agents](/api/docs/page.md?path=ecosystem-map%2F05-llms-ecosystem-master.md) — `docs/ecosystem-map/05-llms-ecosystem-master.md`
- [Pipeline Eval Spec v1 — Testing the Complete Agent Thinking Pipeline](/api/docs/page.md?path=eval-pipeline-spec.md) — `docs/eval-pipeline-spec.md`
- [Eval System](/api/docs/page.md?path=eval-system.md) — `docs/eval-system.md`
- [Agent Eval Use Cases v1](/api/docs/page.md?path=eval-use-cases.md) — `docs/eval-use-cases.md`
- [Browserbase Templates Catalog](/api/docs/page.md?path=kb%2Fbrowserbase-templates-catalog-2026.md) — `docs/kb/browserbase-templates-catalog-2026.md`
- [Browserbase Case Studies](/api/docs/page.md?path=kb%2Fcase-studies%2Fbrowserbase-case-studies-2026.md) — `docs/kb/case-studies/browserbase-case-studies-2026.md`
- [MCP Content Loading Architecture -- Analysis & Proposal](/api/docs/page.md?path=mcp-content-loading.md) — `docs/mcp-content-loading.md`
- [Katailyst Operating Principles](/api/docs/page.md?path=PRINCIPLES.md) — `docs/PRINCIPLES.md`
- [docs/ -- Documentation Index](/api/docs/page.md?path=README.md) — `docs/README.md`
- [Katailyst: Vision, Architecture & Roadmap](/api/docs/page.md?path=ROADMAP.md) — `docs/ROADMAP.md`
- [Katailyst: Vision & System Guide](/api/docs/page.md?path=SYSTEM_GUIDE.md) — `docs/SYSTEM_GUIDE.md`

## API

- [API Endpoints](/api/docs/page.md?path=api%2FENDPOINTS.md) — `docs/api/ENDPOINTS.md`
- [MCP Tools Reference](/api/docs/page.md?path=api%2FMCP_TOOLS_REFERENCE.md) — `docs/api/MCP_TOOLS_REFERENCE.md`

## Atomic Units

- [Atomic Unit Rules (Index)](/api/docs/page.md?path=atomic-units%2FREADME.md) — `docs/atomic-units/README.md`
- [Actions (Launchpad Cards)](/api/docs/page.md?path=atomic-units%2FACTIONS.md) — `docs/atomic-units/ACTIONS.md`
- [Agent Doc (Rules + Expectations)](/api/docs/page.md?path=atomic-units%2FAGENT_DOCS.md) — `docs/atomic-units/AGENT_DOCS.md`
- [Agents (Rules + Expectations)](/api/docs/page.md?path=atomic-units%2FAGENTS.md) — `docs/atomic-units/AGENTS.md`
- [Artifact Model (Shared Across Units)](/api/docs/page.md?path=atomic-units%2FARTIFACTS.md) — `docs/atomic-units/ARTIFACTS.md`
- [Assets (Rules + Expectations)](/api/docs/page.md?path=atomic-units%2FASSETS.md) — `docs/atomic-units/ASSETS.md`
- [Automations (Scheduled Action Runs)](/api/docs/page.md?path=atomic-units%2FAUTOMATIONS.md) — `docs/atomic-units/AUTOMATIONS.md`
- [Bundles (Rules + Expectations)](/api/docs/page.md?path=atomic-units%2FBUNDLES.md) — `docs/atomic-units/BUNDLES.md`
- [Canonical Examples (One Place to Copy the Pattern)](/api/docs/page.md?path=atomic-units%2FCANONICAL_EXAMPLES.md) — `docs/atomic-units/CANONICAL_EXAMPLES.md`
- [Channels (Rules + Expectations)](/api/docs/page.md?path=atomic-units%2FCHANNELS.md) — `docs/atomic-units/CHANNELS.md`
- [Content Types (Rules + Expectations)](/api/docs/page.md?path=atomic-units%2FCONTENT_TYPES.md) — `docs/atomic-units/CONTENT_TYPES.md`
- [Data Viz Contract](/api/docs/page.md?path=atomic-units%2FDATA_VIZ_CONTRACT.md) — `docs/atomic-units/DATA_VIZ_CONTRACT.md`
- [Atomic Unit Decision Matrix](/api/docs/page.md?path=atomic-units%2FDECISION_MATRIX.md) — `docs/atomic-units/DECISION_MATRIX.md`
- [Eval Cases (Rules + Expectations)](/api/docs/page.md?path=atomic-units%2FEVAL_CASES.md) — `docs/atomic-units/EVAL_CASES.md`
- [KB (Rules + Expectations)](/api/docs/page.md?path=atomic-units%2FKB.md) — `docs/atomic-units/KB.md`
- [Link Rules (Shared Across Units)](/api/docs/page.md?path=atomic-units%2FLINKS.md) — `docs/atomic-units/LINKS.md`
- [Lint Rules (Rules + Expectations)](/api/docs/page.md?path=atomic-units%2FLINT_RULES.md) — `docs/atomic-units/LINT_RULES.md`
- [Lint Rulesets (Rules + Expectations)](/api/docs/page.md?path=atomic-units%2FLINT_RULESETS.md) — `docs/atomic-units/LINT_RULESETS.md`
- [Metrics (Rules + Expectations)](/api/docs/page.md?path=atomic-units%2FMETRICS.md) — `docs/atomic-units/METRICS.md`
- [Operational Log (Rules + Expectations)](/api/docs/page.md?path=atomic-units%2FOPERATIONAL_LOGS.md) — `docs/atomic-units/OPERATIONAL_LOGS.md`
- [Playbooks (Rules + Expectations)](/api/docs/page.md?path=atomic-units%2FPLAYBOOKS.md) — `docs/atomic-units/PLAYBOOKS.md`
- [Prompts (Rules + Expectations)](/api/docs/page.md?path=atomic-units%2FPROMPTS.md) — `docs/atomic-units/PROMPTS.md`
- [Recipes (Rules + Expectations)](/api/docs/page.md?path=atomic-units%2FRECIPES.md) — `docs/atomic-units/RECIPES.md`
- [Rubrics (Rules + Expectations)](/api/docs/page.md?path=atomic-units%2FRUBRICS.md) — `docs/atomic-units/RUBRICS.md`
- [Schemas (Rules + Expectations)](/api/docs/page.md?path=atomic-units%2FSCHEMAS.md) — `docs/atomic-units/SCHEMAS.md`
- [Shared Unit Package Contract](/api/docs/page.md?path=atomic-units%2FSHARED_CONTRACT.md) — `docs/atomic-units/SHARED_CONTRACT.md`
- [Skills (Rules + Expectations)](/api/docs/page.md?path=atomic-units%2FSKILLS.md) — `docs/atomic-units/SKILLS.md`
- [Styles (Rules + Expectations)](/api/docs/page.md?path=atomic-units%2FSTYLES.md) — `docs/atomic-units/STYLES.md`
- [Tools (Rules + Expectations)](/api/docs/page.md?path=atomic-units%2FTOOLS.md) — `docs/atomic-units/TOOLS.md`

## Runbooks

- [Katailyst System Guide](/api/docs/page.md?path=runbooks%2Finterop%2Fsystem-guide.md) — `docs/runbooks/interop/system-guide.md`
- [Context Bundles Vs Execution Skills](/api/docs/page.md?path=runbooks%2Finterop%2Fcontext-vs-execution.md) — `docs/runbooks/interop/context-vs-execution.md`
- [FNP Article Shipping — First Ship Runbook](/api/docs/page.md?path=runbooks%2Fcontent-creator%2Ffnp-article-shipping.md) — `docs/runbooks/content-creator/fnp-article-shipping.md`
- [Content Creator Pipeline — Sidecar → Katailyst → Publish](/api/docs/page.md?path=runbooks%2Fcontent-creator%2Fsidecar-to-publish.md) — `docs/runbooks/content-creator/sidecar-to-publish.md`
- [Framer CMS Content Pipeline Runbook](/api/docs/page.md?path=runbooks%2Ffactory%2Fframer-cms-content-pipeline.md) — `docs/runbooks/factory/framer-cms-content-pipeline.md`
- [Factory Runbook: Import + Normalization](/api/docs/page.md?path=runbooks%2Ffactory%2Fimport-normalization.md) — `docs/runbooks/factory/import-normalization.md`
- [Factory Runbook: Incident Response (Failed Runs + Export Breakage)](/api/docs/page.md?path=runbooks%2Ffactory%2Fincident-response-failed-runs-exports.md) — `docs/runbooks/factory/incident-response-failed-runs-exports.md`
- [Factory Operator Quickstart](/api/docs/page.md?path=runbooks%2Ffactory%2Foperator-quickstart.md) — `docs/runbooks/factory/operator-quickstart.md`
- [Factory Runbook: Optimization + A/B Validation](/api/docs/page.md?path=runbooks%2Ffactory%2Foptimization-ab-validation.md) — `docs/runbooks/factory/optimization-ab-validation.md`
- [Factory Runbook: Promotion + Rollback](/api/docs/page.md?path=runbooks%2Ffactory%2Fpromotion-rollback.md) — `docs/runbooks/factory/promotion-rollback.md`
- [Factory Runbooks Index](/api/docs/page.md?path=runbooks%2Ffactory%2FREADME.md) — `docs/runbooks/factory/README.md`
- [External Runtime Onboarding](/api/docs/page.md?path=runbooks%2Finterop%2Fexternal-runtime-onboarding.md) — `docs/runbooks/interop/external-runtime-onboarding.md`
- [MCP + AI SDK Adapter — Interop Runbook](/api/docs/page.md?path=runbooks%2Finterop%2Fmcp-ai-sdk-adapter.md) — `docs/runbooks/interop/mcp-ai-sdk-adapter.md`
- [External Orchestrator Workflow Reference](/api/docs/page.md?path=runbooks%2Finterop%2Forchestrator-workflow.md) — `docs/runbooks/interop/orchestrator-workflow.md`
- [Interop Runbooks](/api/docs/page.md?path=runbooks%2Finterop%2FREADME.md) — `docs/runbooks/interop/README.md`
- [Registry API Contract](/api/docs/page.md?path=runbooks%2Finterop%2Fregistry-api-contract.md) — `docs/runbooks/interop/registry-api-contract.md`
- [Morning brief runbook](/api/docs/page.md?path=runbooks%2Fmorning-brief%2Fmorning-brief.md) — `docs/runbooks/morning-brief/morning-brief.md`
- [Runbook — HLT Content Factory (Paperclip company setup)](/api/docs/page.md?path=runbooks%2Fpaperclip%2Fhlt-content-factory-company.md) — `docs/runbooks/paperclip/hlt-content-factory-company.md`
- [Runbook — Nurse Recruiting Pilot (end-to-end on the wired stack)](/api/docs/page.md?path=runbooks%2Fpaperclip%2Fnurse-recruiting-pilot.md) — `docs/runbooks/paperclip/nurse-recruiting-pilot.md`
- [Design — Rubric-Scored Paperclip Approvals (pilot v1.1)](/api/docs/page.md?path=runbooks%2Fpaperclip%2Frubric-scored-approval-design.md) — `docs/runbooks/paperclip/rubric-scored-approval-design.md`
- [Runbook — Verify Paperclip Approval API Shape (B1)](/api/docs/page.md?path=runbooks%2Fpaperclip%2Fverify-approval-api.md) — `docs/runbooks/paperclip/verify-approval-api.md`
- [Runbooks](/api/docs/page.md?path=runbooks%2FREADME.md) — `docs/runbooks/README.md`

## References

- [Mirrors and Packs](/api/docs/page.md?path=references%2Fcontracts%2FMIRRORS_AND_PACKS.md) — `docs/references/contracts/MIRRORS_AND_PACKS.md`
- [Runtime Ownership and Consumption](/api/docs/page.md?path=references%2Fcontracts%2FRUNTIME_OWNERSHIP_AND_CONSUMPTION.md) — `docs/references/contracts/RUNTIME_OWNERSHIP_AND_CONSUMPTION.md`
- [Agent Autonomy + Deep Discovery Charter](/api/docs/page.md?path=references%2Fcontracts%2FAGENT_AUTONOMY_DISCOVERY.md) — `docs/references/contracts/AGENT_AUTONOMY_DISCOVERY.md`
- [Core Agent Shared Foundation](/api/docs/page.md?path=references%2Fai-agents%2FCORE_AGENT_SHARED_FOUNDATION.md) — `docs/references/ai-agents/CORE_AGENT_SHARED_FOUNDATION.md`
- [Agent Doc Map](/api/docs/page.md?path=references%2Fai-agents%2FAGENT_DOC_MAP.md) — `docs/references/ai-agents/AGENT_DOC_MAP.md`
- [Agent Doc Role Templates](/api/docs/page.md?path=references%2Fai-agents%2FAGENT_DOC_ROLE_TEMPLATES.md) — `docs/references/ai-agents/AGENT_DOC_ROLE_TEMPLATES.md`
- [Agent Stack Fleet Matrix](/api/docs/page.md?path=references%2Fai-agents%2FAGENT_STACK_FLEET_MATRIX.md) — `docs/references/ai-agents/AGENT_STACK_FLEET_MATRIX.md`
- [Cookbook & Agent Patterns Reference](/api/docs/page.md?path=references%2Fai-agents%2FCOOKBOOK_AND_AGENT_PATTERNS.md) — `docs/references/ai-agents/COOKBOOK_AND_AGENT_PATTERNS.md`
- [Discovery Rerank (Cohere + Voyage)](/api/docs/page.md?path=references%2Fai-agents%2FDISCOVERY_RERANK.md) — `docs/references/ai-agents/DISCOVERY_RERANK.md`
- [Eval Harness Adapter (Promptfoo Baseline)](/api/docs/page.md?path=references%2Fai-agents%2FEVAL_HARNESS_ADAPTER.md) — `docs/references/ai-agents/EVAL_HARNESS_ADAPTER.md`
- [Factory Patterns (Extracted Concepts)](/api/docs/page.md?path=references%2Fai-agents%2FFACTORY_PATTERNS.md) — `docs/references/ai-agents/FACTORY_PATTERNS.md`
- [HLT Agent Operating System Thesis](/api/docs/page.md?path=references%2Fai-agents%2FHLT_AGENT_OS_THESIS.md) — `docs/references/ai-agents/HLT_AGENT_OS_THESIS.md`
- [Hosted Agent Core Setup](/api/docs/page.md?path=references%2Fai-agents%2FHOSTED_AGENT_CORE_SETUP.md) — `docs/references/ai-agents/HOSTED_AGENT_CORE_SETUP.md`
- [Multimedia Capability Reference](/api/docs/page.md?path=references%2Fai-agents%2FMULTIMEDIA_CAPABILITY_REFERENCE.md) — `docs/references/ai-agents/MULTIMEDIA_CAPABILITY_REFERENCE.md`
- [How This System Works — The One-Pager](/api/docs/page.md?path=references%2Fai-agents%2FSYSTEM_ONE_PAGER.md) — `docs/references/ai-agents/SYSTEM_ONE_PAGER.md`
- [Core Agent Capability Lanes](/api/docs/page.md?path=references%2Fai-agents%2FUSE_CASES.md) — `docs/references/ai-agents/USE_CASES.md`
- [Agent Runtime and Skill Adaptation Contract](/api/docs/page.md?path=references%2Fcontracts%2FAGENT_RUNTIME_AND_SKILL_ADAPTATION.md) — `docs/references/contracts/AGENT_RUNTIME_AND_SKILL_ADAPTATION.md`
- [Agent Skills Open Standard (ASOS) — Katailyst Alignment](/api/docs/page.md?path=references%2Fcontracts%2FAGENT_SKILLS_OPEN_STANDARD.md) — `docs/references/contracts/AGENT_SKILLS_OPEN_STANDARD.md`
- [Architecture Preservation and Recovery Guide](/api/docs/page.md?path=references%2Fcontracts%2FARCHITECTURE_PRESERVATION_AND_RECOVERY.md) — `docs/references/contracts/ARCHITECTURE_PRESERVATION_AND_RECOVERY.md`
- [Atomic Duplicate Detection Policy](/api/docs/page.md?path=references%2Fcontracts%2FATOMIC_DUPLICATE_DETECTION_POLICY.md) — `docs/references/contracts/ATOMIC_DUPLICATE_DETECTION_POLICY.md`
- [Atomic Unit Standards (Canonical)](/api/docs/page.md?path=references%2Fcontracts%2FATOMIC_UNIT_STANDARDS.md) — `docs/references/contracts/ATOMIC_UNIT_STANDARDS.md`
- [Context Assembly & Graph-Driven Selection — Technical Reference](/api/docs/page.md?path=references%2Fcontracts%2FCONTEXT_ASSEMBLY_AND_GRAPH_SELECTION.md) — `docs/references/contracts/CONTEXT_ASSEMBLY_AND_GRAPH_SELECTION.md`
- [Current Operating Model](/api/docs/page.md?path=references%2Fcontracts%2FCURRENT_OPERATING_MODEL.md) — `docs/references/contracts/CURRENT_OPERATING_MODEL.md`
- [DB URL Env Contract (Canonical)](/api/docs/page.md?path=references%2Fcontracts%2FDB_URL_ENV_CONTRACT.md) — `docs/references/contracts/DB_URL_ENV_CONTRACT.md`
- [Layered Context Packet Contract](/api/docs/page.md?path=references%2Fcontracts%2FLAYERED_CONTEXT_PACKET_CONTRACT.md) — `docs/references/contracts/LAYERED_CONTEXT_PACKET_CONTRACT.md`
- [Link Graph Quality Standard](/api/docs/page.md?path=references%2Fcontracts%2FLINK_GRAPH_QUALITY_STANDARD.md) — `docs/references/contracts/LINK_GRAPH_QUALITY_STANDARD.md`
- [HLT QBank Read-Only Extraction Contract v0](/api/docs/page.md?path=references%2Fcontracts%2FQBANK_READONLY_EXTRACTION_CONTRACT_V0.md) — `docs/references/contracts/QBANK_READONLY_EXTRACTION_CONTRACT_V0.md`
- [Contracts Reference Index](/api/docs/page.md?path=references%2Fcontracts%2FREADME.md) — `docs/references/contracts/README.md`
- [Recovery Posture](/api/docs/page.md?path=references%2Fcontracts%2FRECOVERY_POSTURE.md) — `docs/references/contracts/RECOVERY_POSTURE.md`
- [Tool Integration Philosophy](/api/docs/page.md?path=references%2Fcontracts%2FTOOL_INTEGRATION_PHILOSOPHY.md) — `docs/references/contracts/TOOL_INTEGRATION_PHILOSOPHY.md`
- [Vault + Tool Execution (End-to-End Guide)](/api/docs/page.md?path=references%2Fcontracts%2FVAULT_TOOL_EXECUTION.md) — `docs/references/contracts/VAULT_TOOL_EXECUTION.md`
- [Design System Rules](/api/docs/page.md?path=references%2FDESIGN_SYSTEM_RULES.md) — `docs/references/DESIGN_SYSTEM_RULES.md`
- [External codebases — reference pointers](/api/docs/page.md?path=references%2Fexternal-codebases.md) — `docs/references/external-codebases.md`
- [API Contracts Reference](/api/docs/page.md?path=references%2Fintegrations%2FELEVENLABS_WHISPER_API.md) — `docs/references/integrations/ELEVENLABS_WHISPER_API.md`
- [HLT Mastery -- Framer Page Build Guide](/api/docs/page.md?path=references%2Fintegrations%2FFRAMER_PAGE_BUILD_GUIDE.md) — `docs/references/integrations/FRAMER_PAGE_BUILD_GUIDE.md`
- [HLT Cloudinary DAM — Canonical Reference](/api/docs/page.md?path=references%2Fintegrations%2FHLT_CLOUDINARY_DAM.md) — `docs/references/integrations/HLT_CLOUDINARY_DAM.md`
- [Marketo Integration Contract](/api/docs/page.md?path=references%2Fintegrations%2FINTEGRATION_CONTRACT_MARKETO.md) — `docs/references/integrations/INTEGRATION_CONTRACT_MARKETO.md`
- [Multimedia Mastery Integration Contract](/api/docs/page.md?path=references%2Fintegrations%2FINTEGRATION_CONTRACT_MULTIMEDIA_MASTERY.md) — `docs/references/integrations/INTEGRATION_CONTRACT_MULTIMEDIA_MASTERY.md`
- [Render MCP Integration Contract](/api/docs/page.md?path=references%2Fintegrations%2FINTEGRATION_CONTRACT_RENDER_MCP.md) — `docs/references/integrations/INTEGRATION_CONTRACT_RENDER_MCP.md`
- [Integrations Reference Index](/api/docs/page.md?path=references%2Fintegrations%2FREADME.md) — `docs/references/integrations/README.md`
- [Tool Integration Families Runbook (Cloudinary, Novu, Localytics)](/api/docs/page.md?path=references%2Fintegrations%2FTOOL_INTEGRATION_FAMILIES_RUNBOOK.md) — `docs/references/integrations/TOOL_INTEGRATION_FAMILIES_RUNBOOK.md`
- [MCP Import & Placement Normalization](/api/docs/page.md?path=references%2Fmcp%2FMCP_IMPORT_NORMALIZATION.md) — `docs/references/mcp/MCP_IMPORT_NORMALIZATION.md`
- [Nomenclature (Canonical Terms)](/api/docs/page.md?path=references%2FNOMENCLATURE.md) — `docs/references/NOMENCLATURE.md`
- [Filesystem + Bash Principle (Reference)](/api/docs/page.md?path=references%2Foperations%2FFILESYSTEM_BASH_PRINCIPLES.md) — `docs/references/operations/FILESYSTEM_BASH_PRINCIPLES.md`
- [References Index](/api/docs/page.md?path=references%2FREADME.md) — `docs/references/README.md`
- [Security Notes — Rendered HTML (`dangerouslySetInnerHTML`)](/api/docs/page.md?path=references%2Fsecurity%2FSECURITY_NOTES.md) — `docs/references/security/SECURITY_NOTES.md`
- [Skill Factory Governance Checklist](/api/docs/page.md?path=references%2Fskills%2FSKILL_FACTORY_GOVERNANCE_CHECKLIST.md) — `docs/references/skills/SKILL_FACTORY_GOVERNANCE_CHECKLIST.md`
- [Supabase Auth Setup (Email + OAuth)](/api/docs/page.md?path=references%2Fsupabase%2FSUPABASE_AUTH_SETUP.md) — `docs/references/supabase/SUPABASE_AUTH_SETUP.md`
- [Vercel AI SDK v6 & @ai-sdk/mcp — Sidecar System Technical Reference](/api/docs/page.md?path=references%2Fvercel-ai-sdk-v6-mcp-patterns.md) — `docs/references/vercel-ai-sdk-v6-mcp-patterns.md`
- [HLT Mastery Brand Consolidation & Sidecar Plan](/api/docs/page.md?path=references%2Fvision%2F2026-03-22-hlt-brand-consolidation-sidecar-plan.md) — `docs/references/vision/2026-03-22-hlt-brand-consolidation-sidecar-plan.md`
- [HLT Mastery — The Healthcare Funnel Blueprint](/api/docs/page.md?path=references%2Fvision%2F2026-04-12-hlt-healthcare-funnel-blueprint.md) — `docs/references/vision/2026-04-12-hlt-healthcare-funnel-blueprint.md`
- [Vision Docs](/api/docs/page.md?path=references%2Fvision%2FREADME.md) — `docs/references/vision/README.md`

## MCP Surface

Katailyst exposes a streamable-http MCP server at `/mcp` with 40 tools, 13 resources, and 5 prompts.

**Connection modes**:
- `max` (40 tools) — Default mode (17 core tools): discovery, reading, graph, execution, and navigation. Branch into authoring or delivery toolsets when you need write ops or scheduling. (omit the toolset header)
- `discover` (14 tools) — Compact branch for first-glance discovery when you intentionally want a smaller visible surface. (set `x-katailyst-toolset: bootstrap`)
- `trusted-agent` (40 tools) — Pinned hosted-agent branch for registry plus delivery/admin work without relying on the implicit full default. (set `x-katailyst-toolset: agent,delivery-admin`)
- `media` (12 tools) — Media-forward branch for multimedia and asset-heavy work. (set `x-katailyst-toolset: multimedia`)
- `builder` (10 tools) — Compact build surface for UI builders and codegen-oriented clients. (set `x-katailyst-toolset: v0`)

**Explicit toolsets**:
- `default` (19 tools) — Core tools for discovery, reading, graph traversal, execution, and navigation (17 tools). Covers 90% of agent tasks. Branch into authoring, delivery, or extended when you need write ops, scheduling, or the full catalog. Call guide to learn the system and find the right branch. (named core toolset; distinct from header-omitted Max mode)
- `authoring` (16 tools) — Registry write operations: create, update, link, tag, and manage entities. Branch into this when you need to create or modify registry content. Includes memory, history, deliberation, and list management. (set `X-Katailyst-Toolset: authoring`)
- `delivery` (6 tools) — Content delivery: scheduling, target management, and promotion. Branch into this when you need to schedule social posts, manage delivery targets, or promote content. (set `X-Katailyst-Toolset: delivery`)
- `extended` (40 tools) — Flat list of all tools in the catalog. Prefer branching into default + authoring + delivery instead — the layered approach gives better results. Use extended only when you need the full list in a single toolset. (set `X-Katailyst-Toolset: extended`)
- `bootstrap` (14 tools) — Compact first-glance surface for remote MCP clients. Start here, inspect capabilities, build a context packet, then opt into a broader toolset. (set `X-Katailyst-Toolset: bootstrap`)
- `agent` (36 tools) — Hosted agent surface: default + authoring + execution + memory + lists. Delivery tools stay in their own branch. Use X-Katailyst-Toolset: agent,delivery when you need both. (set `X-Katailyst-Toolset: agent`)
- `multimedia` (12 tools) — Curated toolset for multimedia workflows: discovery, skill lookup, agent context, artifact retrieval. (set `X-Katailyst-Toolset: multimedia`)
- `v0` (10 tools) — Minimal toolset for AI code generators (v0, Cursor). Design system context, skill lookup, and entity discovery. (set `X-Katailyst-Toolset: v0`)
- `delivery-admin` (4 tools) — Operator-only delivery branch for Pipedream connect flows, target discovery, and promotion. (set `X-Katailyst-Toolset: delivery-admin`)

**Tool Families**:
- Registry / core — discovery, graph, entity CRUD, lists (executable)
- Research / web — Firecrawl, Tavily, Brave, NewsAPI (executable)
- Media / design — Cloudinary transforms, uploads (executable)
- Delivery / Pipedream — connect flows, target management (gated_live)
- Communications — Novu, Slack, Telegram (describable)
- Deploy / dev — Vercel, GitHub, CodeSandbox (inventory_only)
- Data / analytics — Metabase, MindsDB, Zilliz (inventory_only)

**Prompts**: registry-select-from-menu, registry-refine-discovery, registry-integration-onboarding, registry-agent-bootstrap, registry-expand-user-request

**Resources**: Registry API Contract, Discovery-First Orchestrator Workflow, Katailyst System Guide, Context Vs Execution, Discovery Ranking and Fallback Guide, Atomic Unit Model, Design System: Tokens, Components, and Motion, Integration Catalog, Taxonomy and Naming System, Agent Quick Start, Brand Voice Canon, Program Personas, Katailyst Extension Manifest

**Connection**: `claude mcp add --transport http katailyst-registry https://<host>/mcp` or see [Agent Quick Start](/api/docs/page.md?path=QUICK_START_AGENTS.md)

## Notes

- Curated scope excludes generated or volatile docs surfaces (`docs/reports/**`, `docs/wiki/**`, `docs/planning/**`, `docs/plans/**`, `docs/investigations/**`).
- Repo files are mirrors; Supabase DB is canonical for registry state.