Decisions
Architecture Decision Records
This directory contains Architecture Decision Records (ADRs) that document significant architectural decisions made in this project.
Index
| ADR | Title | Status |
|---|---|---|
| ADR-001 | Multi-stage CI/CD Pipeline Design | Accepted |
| ADR-002 | Shell Performance Optimization Strategy | Accepted |
| ADR-003 | Security-First Approach | Accepted |
| ADR-004 | Chezmoi + Custom CLI Wrapper Architecture | Accepted |
| ADR-005 | Chezmoi as Dotfiles Manager | Accepted |
| ADR-006 | Zsh as Default Shell | Accepted |
| ADR-007 | Multi-Shell Parity Strategy | Accepted |
| ADR-008 | Alias System Architecture | Accepted |
| ADR-009 | Wallpaper-Driven Theming Engine | Accepted |
| ADR-010 | Enable Starship Transient Prompt in Zsh and Fish | Accepted |
| ADR-011 | Keep Nushell as Tier-3 Reference with Minimum-Viable Caching | Accepted |
| ADR-012 | AI Fleet — Native Local Claude Proxy and Cockpit | Accepted |
| ADR-013 | Single mutation authority | Accepted; migration pending |
| ADR-014 | DPP framing, profiles and sealing | Accepted; restricted hello profile |
| ADR-015 | Transaction and recovery semantics | Accepted; Unix demonstration |
| ADR-016 | Plugin trust and sandbox levels | Accepted; audit plus experimental Linux process proof |
| ADR-017 | Sensitive data boundary | Accepted; secret broker pending |
| ADR-018 | Read-only MCP isolation | Accepted; separate service pending |
ADR Format
Each ADR follows this structure:
- Status: Proposed, Accepted, Deprecated, Superseded
- Context: The situation and forces at play
- Decision: The change being made
- Consequences: The resulting context after applying the decision