diff --git a/.planning/ROADMAP.md b/.planning/ROADMAP.md
new file mode 100644
index 0000000..1c4b281
--- /dev/null
+++ b/.planning/ROADMAP.md
@@ -0,0 +1,73 @@
+# 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: Automation & Monitoring** - Implement service detection and monitoring
+
+## 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
+
+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
+
+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
+
+Plans:
+- [ ] 03-01: Integrate OpenCode AI assistant with NixOS configuration
+- [ ] 03-02: Implement natural language command parsing
+
+### Phase 4: Automation & Monitoring
+**Goal**: Implement automatic service detection and health monitoring
+**Depends on**: Phase 3
+**Research**: Unlikely (internal patterns)
+**Plans**: 2 plans
+
+Plans:
+- [ ] 04-01: Implement automatic Docker Compose file detection
+- [ ] 04-02: Add service health monitoring and logging
+
+## Progress
+
+**Execution Order:**
+Phases execute in numeric order: 1 → 2 → 3 → 4
+
+| Phase | Plans Complete | Status | Completed |
+|-------|----------------|--------|-----------|
+| 1. Foundation Setup | 0/3 | Not started | - |
+| 2. Docker Service Integration | 0/3 | Not started | - |
+| 3. AI Assistant Integration | 0/2 | Not started | - |
+| 4. Automation & Monitoring | 0/2 | Not started | - |
diff --git a/.planning/STATE.md b/.planning/STATE.md
new file mode 100644
index 0000000..e065b52
--- /dev/null
+++ b/.planning/STATE.md
@@ -0,0 +1,53 @@
+# Project State
+
+## Project Reference
+
+**Core Value:** A reproducible and evolvable NixOS infrastructure that can be managed through natural language interactions with the OpenCode AI assistant
+**Current Focus:** Implement automatic detection and integration of Docker Compose services, AI assistant integration, service health monitoring, and automated system updates
+
+## Current Position
+
+Phase: 1 of 4 (Foundation Setup)
+Plan: Not started
+Status: Ready to plan
+Last activity: 2026-01-01 - Project initialized
+
+Progress: ░░░░░░░░░░ 0%
+
+## Performance Metrics
+
+**Velocity:**
+- Total plans completed: 0
+- Average duration: 0 min
+- Total execution time: 0.0 hours
+
+**By Phase:**
+
+| Phase | Plans | Total | Avg/Plan |
+|-------|-------|-------|----------|
+| - | - | - | - |
+
+**Recent Trend:**
+- Last 5 plans: []
+- Trend: [Not available]
+
+## Accumulated Context
+
+### Decisions Made
+
+| Phase | Decision | Rationale |
+|-------|----------|-----------|
+
+### Deferred Issues
+
+None yet.
+
+### Blockers/Concerns Carried Forward
+
+None yet.
+
+## Session Continuity
+
+Last session: 2026-01-01 00:00
+Stopped at: Project initialization complete
+Resume file: None