For Agents

How coding agents should consume these docs: /llms.txt, /llms-full.txt, and per-page Markdown endpoints.

Machine-readable endpoints

This site serves its content as plain Markdown alongside the rendered pages:

Endpoint	What it returns	Use it when
`/llms.txt`	An index of every page with links	You need to find the right page before fetching it
`/llms-full.txt`	The entire site as one Markdown file	You want everything in context at once
any route + `.md`	That single page as raw Markdown, e.g. `/how-it-works.md` or `/commands/stack.md`	You know which page you need

Prefer the targeted flow — fetch /llms.txt, pick the page, fetch <route>.md — over pulling /llms-full.txt unless you genuinely need the whole site.

Reaching the site

The docs run as a local dev server on port 1414:

# from the repo root
bun run docs
 
# or, equivalently, from docs/
bun run dev

Then fetch, for example:

curl http://localhost:1414/llms.txt
curl http://localhost:1414/getting-started.md

In-repo alternatives (no server needed)

If you're operating inside this repo (or have it checked out), the same knowledge is readable directly from disk:

Skills — skills/<name>/SKILL.md for each of: xiv (the router), xiv-operator, xiv-review-core, stack-plan, review-path, test-writing, test-audit. These are the canonical operating instructions; xiv init/xiv update install them into agent skill directories, so you may already have them loaded. See Skills.
Reference docs — skills/xiv/references/*.md (implement.md, review.md, stack.md, authoring.md, smithers-ops.md, smithers.md). The xiv skill routes by intent to exactly one of these; follow the same pattern rather than reading them all.
The runbook — xiv how-to prints the full stacked-feature orchestration loop (what to run next, prerequisites, cost, hard rules) straight to the terminal.
The CLI itself — xiv --help and xiv <command> --help are the source of truth for commands and flags. Never hardcode flags from memory or from prose docs.

Ground rules when acting on what you read

These docs describe an agent-operated tool, and the standing guardrails travel with it:

For the full operator discipline — launch, watch, babysit, report — read the xiv skill and, for long stack builds, xiv-operator.

Suggest changes to this page