Skip to content

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 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

References