Explanation

These pages are for understanding, not for doing. They explain how and why the library is built the way it is, so you can change it — or decide not to use it — with the full picture.

• Why KatanaKit — the goals behind the toolkit, its design stance and the cases where it is the wrong tool.
• Architecture — the hexagonal layout, layer by layer, and the design patterns that hold it together.
• Decisions (ADRs) — the numbered records of decisions with consequences: what was chosen, and what it costs.

Task-oriented pages live in the Guides section; exact facts live in the generated API Reference.