LLM files
LLM files
Section titled “LLM files”Katana UI ships machine-readable documentation so AI agents — including KatanaKit’s own assistant — can discover, compose and code against the kit without scraping the rendered docs.
Artifacts
Section titled “Artifacts”| Artifact | Purpose | Consumer |
|---|---|---|
llms.txt |
Curated index of the kit: entry points, blocks, links. | Agents with a fetch tool. |
llms-full.txt |
Concatenated documentation and component reference in one file. | Agents with a large context window. |
registry.json |
Structured component and block metadata (props, tokens, examples, a11y). | Build tools, generators, MCP servers. |
| Per-block markdown | One file per block with usage and examples. | Focused retrieval. |
| MCP server (optional) | Query interface over the registry. | Agent toolchains. |
llms.txt shape
Section titled “llms.txt shape”# Katana UI
> Framework-agnostic UI kit for KatanaKit. Tokens, primitives, blocks and app pages.
## Docs- Architecture: /docs/ui-kit/architecture- Inventory: /docs/ui-kit/inventory
## Entry points- Tokens: @katanakit/ui/tokens- Vanilla: @katanakit/ui/vanilla- Charts: @katanakit/ui/charts
## Blocks- KPI stats: /docs/ui-kit/blocks/kpi-stats.md- Data table: /docs/ui-kit/blocks/data-table.mdregistry.json shape
Section titled “registry.json shape”{ "name": "kpi-stats", "category": "block", "description": "Row of metric cards with trend indicators.", "tokens": ["--kt-space-4", "--kt-radius-md"], "props": [ { "name": "items", "type": "KpiItem[]", "required": true }, { "name": "columns", "type": "2 | 3 | 4", "default": "4" } ], "examples": ["examples/kpi-stats/default.html"], "a11y": { "role": "group", "keyboard": [] }}Generation pipeline
Section titled “Generation pipeline”- Component metadata is the single source of truth, colocated with each component.
- A build script validates the metadata (props, tokens, examples, a11y map).
- The script emits
llms.txt,llms-full.txt,registry.jsonand per-block markdown into the packagedist/and the docs static files. - CI fails when metadata and docs drift apart.
Integration with Kitt
Section titled “Integration with Kitt”The KatanaKit assistant can register a tool that queries registry.json, so an agent
can answer “which block shows revenue trends?” or scaffold a page with valid entry
points instead of guessing imports.