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
• Data model and durability
• Federation technical notes
• GitHub sync
• Hosted mode technical notes
• Semantic search technical notes

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.