# Documentation

## Guides

User-facing documentation:

- [Agent definitions](guides/agent-definitions.md)
- [Tool reference](guides/tool-reference.md)
- [Diagnostics](guides/diagnostics.md)

## Reference

- [Dictionary](reference/dictionary)

## Plans

Implementation plans and design notes are kept separately from stable user documentation:

- [Architecture](plans/architecture.md)
- [Agent labels](plans/agent-labels.md)
- [Settings scope (historical)](plans/settings-scope.md)
- [Per-workspace settings specification](../specs/005-per-workspace-settings/spec.md)
- [Tool surface split](plans/tool-surface-split.md)