---
title: Knowledge Plane
description: How next-ai-ready makes your content readable by AI.
canonical_url: https://next-ai-ready.vercel.app/en/docs/concepts/knowledge-plane
url: https://next-ai-ready.vercel.app/en/docs/concepts/knowledge-plane
last_updated: 2026-08-01
updated: 2026-08-01
author: next-ai-ready team
summary: How next-ai-ready makes your content readable by AI.
topics: [architecture, knowledge-plane, capability-plane]
---

# Knowledge Plane

The Knowledge Plane is responsible for making your content **citable** by AI search engines. It transforms your MDX pages into structured formats that AI systems understand.

## How it works

1. **Scan** — the build CLI finds all MDX files matching your `content` globs
2. **Parse** — frontmatter and headings are extracted into semantic metadata
3. **Compile** — each page becomes a `SemanticNode` in a graph
4. **Emit** — the graph is serialized into multiple AI-consumable formats

## Artifacts

- **`llms.txt`** — a site-wide index listing every page with its summary, following the [llms.txt proposal](https://llmstxt.org)
- **`llms-full.txt`** — every page’s body plus an optional `## FAQ` section (from frontmatter `questions`), for deep ingestion and RAG
- **`/<page>.md`** — each page rendered as clean Markdown with YAML header
- **`/<page>.ai.json`** — structured JSON with the semantic node and all descendants
- **JSON-LD** — `Article`, `FAQPage`, `WebPage` markup embedded in your pages

When a requested Markdown page is missing, the handler returns a machine-readable
recovery document with HTTP `200`, `X-Robots-Tag: noindex`, the requested path,
`llms.txt`, `sitemap.md`, and up to five relevant pages. Normal browser requests
still use the application's real HTML `404`, so agent recovery does not weaken SEO
error semantics.

## Semantic metadata

Add a `semantic` export to your MDX pages to enrich the graph:

```ts
export const semantic = {
  summary: "How to install the CLI tool.",
  topics: ["installation", "cli"],
  questions: [
    { q: "How do I install?", a: "Run pnpm add next-ai-ready." }
  ],
};
```

Questions become `FAQPage` JSON-LD automatically — giving your pages a chance to appear in AI-generated FAQ results.