---
title: "Guides"
description: "Long-form playbooks for building docs that work well for humans, IDEs, and agents"
canonical_url: "https://docs.farming-labs.dev/docs/guides"
markdown_url: "https://docs.farming-labs.dev/docs/guides.md"
last_updated: "2018-10-20"
agent:
  tokenBudget: 750
---

# Guides

## Guides task

Task: Guides

Expected result: Long-form playbooks for building docs that work well for humans, IDEs, and agents

## Guides verification



## Guides agent guidance

Route the task to one playbook before proposing an implementation. Choose
`/docs/guides/agent-friendly-docs` for page contracts, audience projections, discovery, validation,
and compaction; choose `/docs/guides/docs-json` for `docs.mode`, `docs.runtime`, repo roots, and the
JSON-safe `cloud` layer. Adapter maintainers should use
`/docs/guides/adapter-agent-conformance` and require its versioned report to contain no failed
cases.

These guides explain end-to-end decisions, not every option type. When the selected workflow needs
an exact `defineDocs()` field, verify it against `/docs/reference`; when it needs CLI flags, use
`/docs/cli`. If the requested outcome cannot be verified by the chosen guide, switch to the linked
specialized page instead of combining unrelated configuration shapes.

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.
Docs-scoped sitemap: [/docs/sitemap.md](/docs/sitemap.md).
Well-known sitemap: [/.well-known/sitemap.md](/.well-known/sitemap.md).