Design System
Tandem design principles prioritize clarity, trust, and actionable status visibility across Desktop and TUI experiences.
Product UI Principles
Section titled “Product UI Principles”- Safety context should be visible at decision time (not hidden in logs).
- Runtime status should be legible at a glance (connected, running, waiting, error).
- Interaction patterns should stay consistent across Desktop and TUI where possible.
Runtime UX Contracts
Section titled “Runtime UX Contracts”- Permission/approval surfaces should clearly state tool intent and scope.
- Long-running tasks should expose progress and recovery paths.
- Session/workspace boundaries should be explicit in navigation and commands.
Implementation Layering
Section titled “Implementation Layering”- Guide pages describe user-facing patterns and behaviors.
- Deep visual/style token details and implementation rules belong in
docs/references.
Related Deep Docs
Section titled “Related Deep Docs”docs/DESIGN_SYSTEM.mddocs/PLANNING_MODES.mddocs/IMPROVE_SESSION_FLOW.md