docs: initialize NixOS infrastructure with AI assistant
Creates PROJECT.md with vision and requirements. Creates config.json with interactive workflow mode.
This commit is contained in:
59
.planning/PROJECT.md
Normal file
59
.planning/PROJECT.md
Normal file
@@ -0,0 +1,59 @@
|
||||
# NixOS Infrastructure with AI Assistant
|
||||
|
||||
## What This Is
|
||||
|
||||
This project manages a NixOS-based infrastructure with Docker services, integrated with OpenCode AI assistant for automated management. The system supports:
|
||||
|
||||
- Reproducible NixOS infrastructure configuration
|
||||
- Docker service management via Docker Compose
|
||||
- AI-assisted infrastructure operations
|
||||
- Automatic service deployment and lifecycle management
|
||||
- Integration with existing Docker stacks (ai, cloudstorage, homeautomation, network, passwordmanager, versioncontrol)
|
||||
|
||||
## Core Value
|
||||
|
||||
The core value is a **reproducible and evolvable NixOS infrastructure** that can be managed through natural language interactions with the OpenCode AI assistant. The system should automatically detect and integrate new Docker services while maintaining consistency across all deployments.
|
||||
|
||||
## Requirements
|
||||
|
||||
### Validated
|
||||
|
||||
- NixOS configuration management with flakes
|
||||
- Docker service integration via docker_manager.nix
|
||||
- Traefik reverse proxy with automatic TLS certificates
|
||||
- Environment variable management via agenix secrets
|
||||
- Standardized service patterns across all Docker stacks
|
||||
|
||||
### Active
|
||||
|
||||
- [ ] Automatic detection and integration of new Docker Compose files in `assets/compose/`
|
||||
- [ ] AI assistant integration for service lifecycle management
|
||||
- [ ] Service health monitoring and logging verification
|
||||
- [ ] Documentation of integration patterns in SKILL.md
|
||||
- [ ] Automated system update workflow (`nh os switch`)
|
||||
|
||||
### Out of Scope
|
||||
|
||||
- Full n8n integration for automated workflows - deferring to future milestone
|
||||
- Self-healing infrastructure with automatic problem detection - future enhancement
|
||||
- Multi-host orchestration - single-host focus for v1
|
||||
|
||||
## Key Decisions
|
||||
|
||||
| Decision | Rationale | Outcome |
|
||||
|----------|-----------|---------|
|
||||
| NixOS with Flakes | Reproducible infrastructure, better dependency management | Good |
|
||||
| Docker Compose integration | Preserves existing service configurations, flexibility | Good |
|
||||
| agenix for secrets | Secure secrets management, Nix native integration | Good |
|
||||
| Traefik reverse proxy | Unified HTTPS entrypoint, automatic certificate management | Good |
|
||||
| Standardized service patterns | Consistency across services, easier maintenance | Pending |
|
||||
|
||||
## Context
|
||||
|
||||
- **Existing Services**: ai (Llama.cpp, Open WebUI, n8n), cloudstorage (Nextcloud), homeautomation (Home Assistant), network (Traefik, DDNS), passwordmanager (Vaultwarden), versioncontrol (Gitea)
|
||||
- **Tech Stack**: NixOS unstable, Docker, Docker Compose, Traefik, agenix, OpenCode AI
|
||||
- **Hardware**: AMD MI50 GPUs for AI workloads
|
||||
- **Network**: Traefik-net bridge network for all services
|
||||
- **Storage**: `/mnt/HoardingCow_docker_data/<service>` for persistent data
|
||||
|
||||
**Last updated: 2026-01-01 after init**
|
||||
17
.planning/config.json
Normal file
17
.planning/config.json
Normal file
@@ -0,0 +1,17 @@
|
||||
{
|
||||
"mode": "interactive",
|
||||
"gates": {
|
||||
"confirm_project": true,
|
||||
"confirm_phases": true,
|
||||
"confirm_roadmap": true,
|
||||
"confirm_breakdown": true,
|
||||
"confirm_plan": true,
|
||||
"execute_next_plan": true,
|
||||
"issues_review": true,
|
||||
"confirm_transition": true
|
||||
},
|
||||
"safety": {
|
||||
"always_confirm_destructive": true,
|
||||
"always_confirm_external_services": true
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user