# Documentation - Guides

> Task-based guides for agent-friendly docs and discovery surfaces.

## Pages

- [Guides](https://docs.farming-labs.dev/docs/guides.md): Long-form playbooks for building docs that work well for humans, IDEs, and agents
- [How to Write Agent-Friendly Docs](https://docs.farming-labs.dev/docs/guides/agent-friendly-docs.md): A practical playbook for writing documentation that reads well for humans while still giving agents enough structure to implement, verify, and recover
- [docs.json](https://docs.farming-labs.dev/docs/guides/docs-json.md): How the shared docs.json contract separates docs structure from Docs Cloud services