# Guides
URL: /docs/guides
LLM index: /llms.txt
Description: Long-form playbooks for building docs that work well for humans, IDEs, and agents
Related: /docs/guides/agent-friendly-docs, /docs/guides/docs-json, /docs/customization/agent-primitive, /docs/customization/llms-txt, /docs/customization/mcp, /docs/cli

# Guides

Use this page when the user asks about this topic: Long-form playbooks for building docs that work well for humans, IDEs, and agents.
Keep answers grounded in the exact options, routes, commands, and examples documented here.
If the request moves beyond this page, point to the closest related docs instead of inventing config.

These are the longer, more opinionated walkthroughs in the docs. They sit on top of the reference pages and show how to use `@farming-labs/docs` in a way that feels coherent end to end, not just technically correct.

## Featured Guide

<GuideCard
  href="/docs/guides/agent-friendly-docs"
  label="Guide 01"
  metaItems={["Apr 2026", "12 min read"]}
  featured
  title="How to Write Agent-Friendly Docs"
  description="A practical playbook for turning ordinary product docs into pages that agents can discover, read, verify, and recover from without making the human page feel robotic."
  tags={["agent.md", "<Agent>", "llms.txt", "Sitemaps", "Robots", "MCP", "Doctor"]}
/>

<GuideCard
  href="/docs/guides/docs-json"
  label="Guide 02"
  metaItems={["May 2026", "5 min read"]}
  title="How to Think About docs.json"
  description="A concise guide to the docs.json contract, including docs.mode, docs.runtime, and the separate cloud service layer."
  tags={["docs.json", "frameworkless", "cloud", "runtime"]} />