# Documentation

URL: https://mechcrate.dev/docs/
Source: site/apps/site/src/content/docs/docs/index.md

---

The MechCrate docs are organised into five sections, mirrored by the sidebar:

- **Start**: install, first project, the folder contract, CLI reference.
- **Framework**: router, recipes, compose & env conventions, infra credentials, upgrade, testing, Cloudflare deploy, remote blueprints.
- **AI Layer**: MCP server and tool families, the techniques corpus / RAG setup, the research pipeline, agent execution rules.
- **Techniques Corpus**: the published `docs/development/` corpus that ships inside mx's agent retrieval layer.
- **Project**: research log, research backlog, the known-broken lane, license.

Two things worth knowing before you start reading. Pages here stay short where a
[corpus document](/docs/corpus/) already covers the topic in depth. The page
links to it rather than restating it, so each document renders exactly once. And
where something is broken, the page says so and points at the
[known-broken lane](/docs/project/known-broken/) rather than writing around it.