# katailyst — llms.txt

The HLT registry control plane: 1,663 entities, 11,151 links, 128 vault secrets, streamable-http MCP at `/mcp`.

## Quickstart

- **What this IS**: Next.js app hosting (a) the Katailyst registry + graph + vault, (b) a streamable-http MCP server at `/mcp` that every HLT repo consumes, (c) the agent-facing docs surface (this file + `/llms-full.txt`), (d) the dashboard-cms admin + gallery + interactive surfaces.
- **What this IS NOT**: not a content factory (that's `~/hlt/sidecar`), not a public article renderer (that's `~/hlt/mastery-publishing` + Framer), not a data pipeline (that's `~/hlt/jobs`).
- **Live URL**: `https://www.katailyst.com` (site + MCP).
- **Local run**: `pnpm dev` (port 3000). MCP at `/mcp`.
- **Env**: see `kb:katailyst-vault-access-pattern`. Service uses `DATABASE_URL` + Supabase service role on the server; every consumer repo only needs `CATALYST_MCP_URL` + `CATALYST_MCP_TOKEN`.

## Registry refs

- **Owns / implements**: every `skill:*`, `tool:*`, `kb:*`, `prompt:*`, `hub:*`, `rubric:*`, `lint_rule:*`, `lint_ruleset:*` etc. — this is the canonical registry. Key self-referencing entities: `kb:katailyst-vault-access-pattern`, `kb:llms-txt-canonical-structure`, `lint_ruleset:registry-graph-governance`, `lint_rule:llms-txt-format`, `hub:hub-registry`, `skill:mcp-registry-server`, `skill:catalyst-db-js`.
- **Consumes**: n/a — Katailyst is the leaf in the dependency graph (the brain every sidecar calls).

## Architecture

```
HTTP (Vercel) ── /mcp (streamable-http) ── MCP server (lib/mcp/*)
              ├─ /api/docs/*             ── Docs renderer (lib/docs/llms-index.ts)
              ├─ /api/endpoints          ── Machine-readable API inventory
              ├─ /dashboard-cms/*        ── Admin + gallery + interactive
              └─ Supabase (public.* + integration_secrets + vault)
```

Top-level dirs: `app/` (Next.js routes), `lib/` (MCP, docs, db, discovery, auth, integrations), `docs/` (curated KBs + playbooks + runbooks — surfaced via the docs nav below), `scripts/` (ops + audit + generate), `supabase/` (migrations + functions), `plugins/` (cowork/slash-command bundles).

## Rules of engagement

- **Katailyst first** (this repo): `discover` → `get_entity` → `tool_execute`. `katailyst.orchestrate` for multi-angle work.
- **Axon second**: `axon status` before edits. `axon context` + `axon impact` for non-trivial changes to lib/mcp/*.
- **Model policy**: Opus 4.7 everywhere. Never Haiku, never GPT-4o.
- **Vault-first**: all third-party secrets live in `public.integration_secrets` + Supabase vault. See `kb:katailyst-vault-access-pattern`.
- **Protected writes**: `agent-core-docs`, `agent-architecture-docs`, `registry-graph-admin`, `publish-and-runtime-admin` surface groups require care. See `registry_session`.
- **llms.txt hygiene**: `pnpm llms:generate` regenerates this file from `lib/docs/llms-index.ts`. Lint rule `lint_rule:llms-txt-format` checks shape.

## Data contracts

- **MCP**: streamable-http at `/mcp`. Toolsets: `default`, `authoring`, `delivery`, `extended`, `bootstrap`, `agent`, `multimedia`, `v0`, `delivery-admin`. See `registry_capabilities`.
- **Registry**: Supabase Postgres. Canonical for every `type:code` entity referenced across the ecosystem.
- **Vault**: `public.integration_secrets` (metadata) + Supabase vault extension (encrypted values). Service-role only for direct reads; sidecars resolve via `tool_execute` with `auth_secret_key` bindings.

## Related repos

- **Downstream** (consume Katailyst via MCP): `~/hlt/sidecar`, `~/hlt/mastery-publishing`, `~/hlt/multimedia-mastery`, `~/hlt/forum-template`, `~/hlt/jobs`, `~/hlt/agent-canvas`, `~/hlt/brand-design-lab`, `~/hlt/engage`, `~/hlt/paperclip`, `~/hlt/mastra`, `~/hlt/operator-evals`, `~/hlt/research-team`, `~/hlt/evidence-based-business`, `~/hlt/gpt-researcher`.
- **Sibling / peer**: n/a — Katailyst is the hub.

## Docs index (auto-generated below)

The remainder of this file is the canonical docs navigation index for the Katailyst site. It is regenerated by `pnpm llms:generate`; edit `lib/docs/llms-index.ts` (not this file) to change the structure.

## 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`
- [katailyst.orchestrate — the flexible core of the consolidated MCP surface](/api/docs/page.md?path=architecture%2Fmcp-orchestrate.md) — `docs/architecture/mcp-orchestrate.md`
- [Atomic Unit Quality: Design Document](/api/docs/page.md?path=atomic-unit-quality.md) — `docs/atomic-unit-quality.md`
- [Axon — local code-graph index for the HLT ecosystem](/api/docs/page.md?path=axon-discovery.md) — `docs/axon-discovery.md`
- [Voice Examples — Before / After](/api/docs/page.md?path=brand-voice%2FEXAMPLES.md) — `docs/brand-voice/EXAMPLES.md`
- [Katailyst Voice — The Ten Rules](/api/docs/page.md?path=brand-voice%2FVOICE.md) — `docs/brand-voice/VOICE.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`
- [HLT Mastery — Standard Core Design System](/api/docs/page.md?path=design-system%2FREADME.md) — `docs/design-system/README.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`
- [Framer SEO Cleanup Plan — careful, staged, marketing-team coordinated](/api/docs/page.md?path=ops%2F2026-04-18-framer-seo-cleanup-plan.md) — `docs/ops/2026-04-18-framer-seo-cleanup-plan.md`
- [LinkedIn HLT Company Page re-OAuth — operator runbook](/api/docs/page.md?path=ops%2F2026-04-18-linkedin-hlt-company-page-oauth.md) — `docs/ops/2026-04-18-linkedin-hlt-company-page-oauth.md`
- [Cloudflare Worker v3 — Deploy Instructions (ops)](/api/docs/page.md?path=ops%2F2026-04-19-cloudflare-worker-v3-DEPLOY.md) — `docs/ops/2026-04-19-cloudflare-worker-v3-DEPLOY.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`
- [Operator flag-flip checklist](/api/docs/page.md?path=runbooks%2Foperator-flag-flip-checklist.md) — `docs/runbooks/operator-flag-flip-checklist.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 Avatars — Canonical Pointer Discipline](/api/docs/page.md?path=references%2Fagent-avatars.md) — `docs/references/agent-avatars.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`
- [Canonical Clones — Which Copy of Each Repo Is the Real One](/api/docs/page.md?path=references%2Fcanonical-clones.md) — `docs/references/canonical-clones.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`
- [HLT Ecosystem Inventory](/api/docs/page.md?path=references%2Fecosystem-inventory.md) — `docs/references/ecosystem-inventory.md`
- [Ecosystem Runtime Map](/api/docs/page.md?path=references%2Fecosystem-runtime-map.md) — `docs/references/ecosystem-runtime-map.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`
- [Pattern: First-Boot Topic Seeding for Exam Content](/api/docs/page.md?path=references%2Fpatterns%2Ffirst-boot-topic-seeding.md) — `docs/references/patterns/first-boot-topic-seeding.md`
- [Pattern: Append-Only PointEvents Ledger for Gamification](/api/docs/page.md?path=references%2Fpatterns%2Fgamification-pointevents-ledger.md) — `docs/references/patterns/gamification-pointevents-ledger.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 42 tools, 15 resources, and 6 prompts.

**Connection modes**:
- `max` (42 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` (42 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. 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` (42 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` (38 tools) — Hosted agent surface: registry/control-plane, execution, memory, lists, and delivery scheduling. Delivery target connect/discover/promote tools stay in delivery-admin. Use X-Katailyst-Toolset: agent,delivery-admin 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**: start-here, registry-select-from-menu, registry-refine-discovery, registry-integration-onboarding, registry-agent-bootstrap, registry-expand-user-request

**Resources**: Start here — Katailyst protocol, 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, Orchestrate run replay, 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)

## Recent significant changes

- Regenerated continuously by `pnpm llms:generate` + the `/api/cron/llms-index-check` cron. See `git log` on `docs/` for the actual change history.

## Known gaps / pending

- `http_multi_action` executor on the MCP side — unblocks action-multiplexed call_specs like `tool:meta-ads.insights` and `tool:manus.agent`.
- `tool:katailyst-vault-mcp` — future first-class secret-resolution tool so sidecars don't rely on per-integration call_specs.

## 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.