infra/.planning/ROADMAP.md

Roadmap: NixOS Infrastructure with AI Assistant

Overview

This roadmap outlines the implementation of a reproducible NixOS infrastructure with Docker service management, integrated with an AI assistant for automated operations. The system will automatically detect and integrate new Docker services while maintaining consistency across deployments.

Domain Expertise

None

Phases

• ✅ Phase 1: Foundation Setup - Establish core NixOS configuration with flakes
• ✅ Phase 2: Docker Service Integration - Integrate Docker Compose services
• ✅ Phase 3: AI Assistant Integration - Enable AI-assisted infrastructure management
• Phase 4: Internet Access & MCP - MCP server for web access
• Phase 5: TAK Server Integration - Add TAK server to infrastructure

Phase Details

Phase 1: Foundation Setup

Goal: Establish the core NixOS configuration with flakes and basic infrastructure Depends on: Nothing (first phase) Research: Unlikely (established Nix patterns) Plans: 3 plans Status: Complete

Plans:

• 01-01: Set up NixOS flake structure with hardware configuration
• 01-02: Configure basic services and networking
• 01-03: Implement secrets management with agenix

Phase 2: Docker Service Integration

Goal: Integrate Docker service management with Traefik reverse proxy Depends on: Phase 1 Research: Unlikely (existing Docker Compose patterns) Plans: 3 plans Status: Complete

Plans:

• 02-01: Implement docker_manager.nix for service integration
• 02-02: Configure Traefik reverse proxy with automatic TLS
• 02-03: Set up persistent storage for Docker services

Phase 3: AI Assistant Integration

Goal: Enable AI assistant to manage infrastructure operations Depends on: Phase 2 Research: Likely (AI integration patterns) Research topics: OpenCode AI API, infrastructure management patterns, natural language parsing for service operations Plans: 2 plans Status: Complete

Plans:

• 03-01: Integrate OpenCode AI assistant with NixOS configuration
• 03-02: Implement natural language command parsing

Phase 4: Internet Access & MCP

Goal: Set up MCP server for web access and enhanced functionality Depends on: Phase 3 Research: Likely (MCP server configuration) Research topics: MCP server setup, web access integration, security considerations Plans: 2 plans

Plans:

• 04-01: Configure MCP server for external access
• 04-02: Test web search capabilities and integration

Phase 4.1: Organize Accumulated Commits (INSERTED)

Goal: Organize uncommitted changes into logical, meaningful commits Depends on: Phase 4 Plans: 0 plans

Plans:

• TBD (run /gsd/plan-phase 4.1 to break down)

Details: [To be added during planning]

Phase 5: TAK Server Integration

Goal: Add TAK server to the infrastructure Depends on: Phase 2 Research: Likely (TAK server Docker image selection) Research topics: TAK server Docker image options, configuration requirements, integration patterns Plans: 3 plans

Plans:

• 05-01: Research and select TAK server Docker image
• 05-02: Create Docker Compose file for TAK server
• 05-03: Integrate TAK server with existing infrastructure

Progress

Execution Order: Phases execute in numeric order: 1 → 2 → 3 → 4 → 5

Phase	Plans Complete	Status	Completed
1. Foundation Setup	3/3	Complete	-
2. Docker Service Integration	3/3	Complete	-
3. AI Assistant Integration	2/2	Complete	-
4. Internet Access & MCP	0/2	Not started	-
5. TAK Server Integration	0/3	Not started	-