Qubinode Navigator - Architecture Decision Records Index

Overview

This document provides a comprehensive index of all Architecture Decision Records (ADRs) for the Qubinode Navigator project, organized by status and relationships.

Current Architecture (Active ADRs)

🏗️ Core Architecture

  • ADR-0001: Container-First Execution Model with Ansible Navigator
  • ADR-0033: Terminal-Based One-Shot Deployment Architecture ⭐ Primary Entry Point
  • ADR-0028: Modular Plugin Framework for Extensibility

🤖 AI Assistant Integration

  • ADR-0027: CPU-Based AI Deployment Assistant Architecture
  • ADR-0032: AI Assistant Community Distribution Strategy
  • ADR-0034: AI Assistant Terminal Integration Strategy
  • ADR-0038: FastMCP Framework Migration for MCP Servers ⭐ New

🖥️ Platform Support

  • ADR-0005: KVM/Libvirt Virtualization Platform Choice
  • ADR-0026: RHEL 10/CentOS 10 Platform Support Strategy

☁️ Multi-Cloud & Configuration

  • ADR-0002: Multi-Cloud Inventory Strategy
  • ADR-0003: Dynamic Configuration Management
  • ADR-0009: Cloud Provider-Specific Configuration Management
  • ADR-0023: Enhanced Configuration Management with HashiCorp Vault

🔒 Security

  • ADR-0004: Security Architecture with Ansible Vault
  • ADR-0010: Progressive SSH Security Model
  • ADR-0024: Vault-Integrated Setup Script Security Enhancement
  • ADR-0025: Ansible Tooling Modernization and Security Strategy

🛠️ Development & Operations

  • ADR-0006: Modular Dependency Management Strategy
  • ADR-0007: Bash-First Orchestration with Python Configuration
  • ADR-0011: Comprehensive Platform Validation
  • ADR-0030: Software and OS Update Strategy

📚 Documentation

  • ADR-0029: Documentation Strategy and Website Modernization
  • ADR-0035: Terminal-Centric Documentation Strategy

Deprecated ADRs

❌ Superseded by Current Architecture

  • ADR-0008: OS-Specific Deployment Script Strategy
    • Superseded by ADR-0033: Terminal-Based One-Shot Deployment Architecture
  • ADR-0031: Setup Script Modernization Strategy
    • Superseded by ADR-0033: Terminal-Based One-Shot Deployment Architecture

Architecture Relationships

Primary Deployment Flow 

ADR-0033 (One-Shot Deployment) 
├── depends on → ADR-0001 (Container-First Execution)
├── depends on → ADR-0027 (AI Assistant Architecture)
├── depends on → ADR-0026 (RHEL 10/CentOS 10 Support)
├── integrates → ADR-0002 (Multi-Cloud Inventory)
├── integrates → ADR-0004 (Security/Vault)
└── supersedes → ADR-0008, ADR-0031

AI Assistant Integration 

ADR-0034 (AI Terminal Integration)
├── depends on → ADR-0027 (AI Assistant Architecture)
├── depends on → ADR-0032 (AI Community Distribution)
├── depends on → ADR-0033 (One-Shot Deployment)
└── documented by → ADR-0035 (Terminal Documentation)

Security Architecture 

ADR-0004 (Security Architecture)
├── enhanced by → ADR-0024 (Vault Integration)
├── modernized by → ADR-0025 (Ansible Security)
└── supports → ADR-0010 (SSH Security)

Implementation Status Summary

✅ Implemented (Production Ready)

  • Core deployment architecture (ADR-0033)
  • AI Assistant integration (ADR-0027, ADR-0032, ADR-0034)
  • RHEL 10/CentOS 10 support (ADR-0026)
  • Plugin framework (ADR-0028)
  • Security modernization (ADR-0025)

🚧 In Progress

  • Documentation strategy implementation (ADR-0029, ADR-0035)
  • FastMCP framework migration (ADR-0038) - PoC Complete ✅

📋 Planned

  • Software update automation (ADR-0030)

Quick Navigation

For New Users

  1. Start with ADR-0033 (Terminal-Based One-Shot Deployment) - the main deployment approach
  2. Review ADR-0034 (AI Assistant Integration) - for understanding AI-powered assistance
  3. Check ADR-0026 (RHEL 10/CentOS 10 Support) - for modern OS compatibility

For Developers

  1. ADR-0028 (Plugin Framework) - for extending functionality
  2. ADR-0001 (Container-First Execution) - for understanding execution model
  3. ADR-0007 (Bash-First Orchestration) - for scripting patterns

For Security/Operations

  1. ADR-0004 (Security Architecture) - foundational security model
  2. ADR-0024 (Vault Integration) - for credential management
  3. ADR-0025 (Ansible Security) - for tooling security

Missing ADR Numbers

Available for future decisions: ADR-0012 through ADR-0022

Last Updated: 2025-11-11
This index is automatically maintained. Please update when adding new ADRs.