How to: Key Principles
1. **Plugins** provide data and semantics (state, health, context)
2. **Renderer** handles all UI decisions (colors, icons, formatting)
3. **Themes** define color palettes only
4. **Core** orchestrates the lifecycle and manages caching

This architecture ensures:

- ✅ Plugins never decide colors or formatting
- ✅ Themes are purely declarative
- ✅ Rendering is consistent across all plugins
- ✅ Easy to extend without breaking existing code

**Learn more:** [Architecture Documentation](https://github.com/fabioluciano/tmux-powerkit/wiki/Architecture)

---