KonstantinStarovoytov/agent-docs

Agent Docs

Ask questions about Claude Code, Cursor, Codex and MCP — get answers grounded in their official docs, with citations.

A hybrid RAG service that AI agents call through two MCP tools (or over REST). It indexes ~600 pages of official documentation, refreshes itself daily, and every design choice is backed by an experiment.

Why it is built this way, what was tested, and a glossary of every term: ARCHITECTURE.md

<picture> <source media="(prefers-color-scheme: dark)" srcset="docs/flow/agent-docs-flow-dark.gif"> <img alt="Query flow: an agent asks how to create a skill; search_docs finds the page, read_section returns the section, Langfuse measures every step" src="docs/flow/agent-docs-flow-light.gif"> </picture>

Step through it at your own pace (arrow keys work), or open the stills:

<details> <summary>The 15 steps as still images</summary> <picture> <source media="(prefers-color-scheme: dark)" srcset="docs/flow/steps/step-01-dark.webp"> <img alt="Step 1: The question" src="docs/flow/steps/step-01-light.webp"> </picture> <picture> <source media="(prefers-color-scheme: dark)" srcset="docs/flow/steps/step-02-dark.webp"> <img alt="Step 2: The agent plans the call" src="docs/flow/steps/step-02-light.webp"> </picture> <picture> <source media="(prefers-color-scheme: dark)" srcset="docs/flow/steps/step-03-dark.webp"> <img alt="Step 3: search_docs goes out" src="docs/flow/steps/step-03-light.webp"> </picture> <picture> <source media="(prefers-color-scheme: dark)" srcset="docs/flow/steps/step-04-dark.webp"> <img alt="Step 4: Hybrid search over chunks" src="docs/flow/steps/step-04-light.webp"> </picture> <picture> <source media="(prefers-color-scheme: dark)" srcset="docs/flow/steps/step-05-dark.webp"> <img alt="Step 5: Rank fusion" src="docs/flow/steps/step-05-light.webp"> </picture> <picture> <source media="(prefers-color-scheme: dark)" srcset