# Design Notes

These notes preserve technical design context that is useful for maintainers and
operators. They are not the quick path for using kata; start with the guide and
operations pages first.

The design notes may discuss trade-offs, implementation history, and low-level
constraints that are too detailed for the main documentation.

## Available notes

- [Architecture and design principles](architecture.md)
- [Auto-start daemon idle shutdown](autostart-idle-shutdown.md)
- [Data model and durability](data-model.md)
- [Federation technical notes](federation.md)
- [GitHub sync](github-sync.md)
- [Hosted mode technical notes](hosted-mode.md)
- [Semantic search technical notes](semantic-search.md)

These notes are the curated home for kata's design rationale. Earlier planning
specs and implementation plans should be folded into these notes once the work
ships, then removed so stale drafts do not compete with maintained docs.