Architecture Decision Records (ADRs)
This directory contains all Architecture Decision Records for the provisioning platform. ADRs document significant architectural decisions and their rationale.
Index of Decisions
Core Architecture (ADR-001 to ADR-006)
- ADR-001: Project Structure - Overall project organization and directory layout
- ADR-002: Distribution Strategy - How the platform is packaged and distributed
- ADR-003: Workspace Isolation - Workspace management and isolation boundaries
- ADR-004: Hybrid Architecture - Rust/Nushell hybrid system design
- ADR-005: Extension Framework - Plugin/extension system architecture
- ADR-006: Provisioning CLI Refactoring - CLI modularization and command handling
Infrastructure & Configuration (ADR-007 to ADR-011)
- ADR-007: KMS Simplification - Key Management System design
- ADR-008: Cedar Authorization - Fine-grained authorization via Cedar policies
- ADR-009: Security System Complete - Comprehensive security implementation
- ADR-010: Configuration Format Strategy - When to use Nickel, TOML, YAML, or KCL
- ADR-011: Nickel Migration - Migration from KCL to Nickel as primary IaC language
Platform Services (ADR-012 to ADR-014)
- ADR-012: Nushell Nickel Plugin CLI Wrapper - Plugin architecture for Nickel integration
- ADR-013: Typdialog Web UI Backend Integration - Browser-based configuration forms with multi-user collaboration
- ADR-014: SecretumVault Integration - Centralized secrets management with dynamic credentials
AI and Intelligence (ADR-015)
- ADR-015: AI Integration Architecture - Comprehensive AI system for intelligent infrastructure provisioning
How to Use ADRs
- For decisions affecting architecture: Create a new ADR with the next sequential number
- For reading decisions: Browse this list or check SUMMARY.md
- For understanding context: Each ADR includes context, rationale, and consequences
ADR Format
Each ADR follows this standard structure:
- Context: What problem we're solving
- Decision: What we decided
- Rationale: Why we chose this approach
- Consequences: Positive and negative impacts
- Alternatives Considered: Other options we evaluated
Status Markers
- Proposed: Under review, not yet final
- Accepted: Approved and adopted
- Superseded: Replaced by a later ADR
- Deprecated: No longer recommended
Last Updated: 2025-01-08 Total ADRs: 15