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