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