Copy as markdown[View .md](https://docs.funnelfizz.com/ai-agents/read-docs "View the raw markdown for this page")[Open in Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Fdocs.funnelfizz.com%2Fai-agents%2Fread-docs.md%20and%20help%20me%20with%20this%20FunnelFizz%20topic%3A%20Reading%20docs "Open this page in Claude with context")[Open in ChatGPT](https://chat.openai.com/?q=Read%20https%3A%2F%2Fdocs.funnelfizz.com%2Fai-agents%2Fread-docs.md%20and%20help%20me%20with%20this%20FunnelFizz%20topic%3A%20Reading%20docs "Open this page in ChatGPT with context")

# Reading docs

Three machine-readable surfaces let agents read these docs without scraping HTML or rendering JS.

## `/llms.txt`, the index[​](#llmstxt-the-index "Direct link to llmstxt-the-index")

[`https://docs.funnelfizz.com/llms.txt`](https://docs.funnelfizz.com/llms.txt)

A sparse structured index of every docs page, title and one-line summary per entry. \~3–5 KB. Use when your agent needs to know *what pages exist* before deciding what to fetch ("which page covers splits?").

Follows the [llms.txt convention](https://llmstxt.org) proposed by Jeremy Howard / Answer.AI.

## `/llms-full.txt`, the corpus[​](#llms-fulltxt-the-corpus "Direct link to llms-fulltxt-the-corpus")

[`https://docs.funnelfizz.com/llms-full.txt`](https://docs.funnelfizz.com/llms-full.txt)

Every page concatenated into one markdown file. Use when your agent needs the whole knowledge base in context to answer general questions or write code against FunnelFizz.

Both files regenerate on every docs build, so they're always current.

## Per-page `.md` routes[​](#per-page-md-routes "Direct link to per-page-md-routes")

Append `.md` to any docs URL to get the raw markdown source minus navigation chrome:

```
https://docs.funnelfizz.com/concepts/stages       ← rendered HTML

https://docs.funnelfizz.com/concepts/stages.md    ← clean markdown
```

Use when the agent only needs one specific page, cheaper than fetching the full corpus.

## Context7[​](#context7 "Direct link to Context7")

[Context7](https://context7.com) is an indexed MCP-based docs search service by Upstash. Agents that have Context7 enabled can run:

```
use context7 funnelfizz
```

…and Context7 returns relevant doc excerpts. Complementary to our own MCP server: **Context7 serves docs**, **the FunnelFizz MCP serves your live workspace**.

Our `context7.json` (in this repo at `docs/context7.json`) gives Context7 a few canonical rules to surface alongside excerpts:

```
{

  "$schema": "https://context7.com/schema/context7.json",

  "projectTitle": "FunnelFizz",

  "description": "Marketing funnel builder for solo founders and small SaaS teams.",

  "rules": [

    "Plans are FREE, HOBBY, PRO only. There is no TEAM plan.",

    "Domain is funnelfizz.com (not .app).",

    "Brand is FunnelFizz (PascalCase) in user-facing copy.",

    "The 4 stages are AWARENESS → CONSIDERATION → TRIAL → CUSTOMER in fixed order.",

    "Stripe connection uses restricted keys (rk_live_...) with exactly 7 read scopes."

  ]

}
```

## When to use which[​](#when-to-use-which "Direct link to When to use which")

| Task                                    | Use                                                           |
| --------------------------------------- | ------------------------------------------------------------- |
| "Which page covers splits?"             | `llms.txt`                                                    |
| "Tell me everything about FunnelFizz"   | `llms-full.txt`                                               |
| "Walk me through stages"                | `/concepts/stages.md` (single page)                           |
| Inside an MCP-aware agent with Context7 | `use context7 funnelfizz`                                     |
| Doing actual setup or reading live data | [MCP](https://docs.funnelfizz.com/ai-agents/mcp.md), not docs |