# Docs map
## Start here
- [Introduction](introduction.md): what Caboodle does and when to use it.
- [Getting started](getting-started.md): the smallest install, interview and recovery.
- [Installing and removing](installing.md): platforms, source builds, files and updates.
- [Using it with agents](agents.md): standalone MCP clients and managed crews.
- [Using Caboodle](using.md): the guided and non-interactive workflows.
- [Reference](reference.md): every command and the glossary.
- [Configuration](configuration.md): plan, intent, environment and state.
## Understand the design
- [How it works](architecture.md): the plan/apply/verify engine.
- [Three proofs](proofs.md): installed, working and observable.
- [Conventions](conventions.md): shared layout without a second manifest.
- [Profiles](profiles.md): tool selections, crew ownership and model artifacts.
- [Crew capability contracts](crew-contracts.md): browser evidence and admission.
- [Emitting to Quipu](emission.md): durable install and lifecycle records.
- [The stack](stack.md): the six core tools and related projects.
- [The corpus](corpus.md): staging canonical knowledge shares.
- [Roadmap](roadmap.md): planned capabilities, not promises of shipped behavior.
- [The stack standard](stack-standard.md): shared public documentation conventions.
## Documents outside the book
These links point to the source repository so they work on both GitHub and the
published book. Every loose document under `docs/` is listed here.
- [Stack README standard](https://github.com/scbrown/caboodle/blob/main/docs/stack/README-STANDARD.md): section order, theme, shared stack block and review checklist.
- [README template](https://github.com/scbrown/caboodle/blob/main/docs/stack/README-TEMPLATE.md): fill-in template implementing the standard.
- [Design vision](https://github.com/scbrown/caboodle/blob/main/docs/design/vision.md): **Historical** design proposal; use the reference for shipped commands.
- [txtai gap analysis](https://github.com/scbrown/caboodle/blob/main/docs/design/txtai-gap-analysis.md): **Historical** comparison and design opportunities, not a current capability guarantee.