# Roadmap

Living document. Full reasoning behind this sequencing lives in `docs/architecture/00-founding-strategy.md`, Section 5. This file tracks current status; that one explains why.

## Current milestone: M0 — Foundation

Status: **in progress**
See `00-founding-strategy.md`, Section 8 for full acceptance criteria.

## MVP — "It can answer one true thing"
- [ ] Ingest Docker Compose files + Markdown docs from one Gitea repo
- [ ] Ask a question (Open WebUI or Claude Desktop), get an answer with citations + freshness timestamp
- [ ] No automation, no write access, Knowledge Agent only

## v0.1 — "It knows what's running"
- [ ] Docker Agent (read-only): container status, health, uptime
- [ ] "What changed yesterday" via Docker events + Gitea commit correlation
- [ ] Audit log queryable

## v0.5 — "It can safely touch things"
- [ ] Execution Guard fully implemented
- [ ] First write action: restart a named container, with confirmation
- [ ] Full audit trail of proposed/approved/denied actions
- [ ] Gate: no second write action until this one has run correctly for 2+ weeks
- [ ] Revisit: staging environment via Coolify (see ADR-003)

## v1.0 — "It's a real platform"
- [ ] Monitoring Agent (Grafana/Prometheus, read-only)
- [ ] Documentation Generator (live docs from actual state)
- [ ] Deployment Agent (deploy a new stack from template, confirmation required)
- [ ] MCP server matured as primary Claude Desktop interface
- [ ] Coolify webhook actually connected (deferred from M0/M1, see ADR-003)

## v2.0 — "It's proactive"
- [ ] Alert correlation across Grafana + Docker + Gitea
- [ ] Backup Agent, Networking Agent
- [ ] Suggests (never auto-executes) remediation for known-safe patterns

## v3.0 — "It's an operating system for the homelab"
- [ ] Multi-agent coordination for complex requests
- [ ] Self-updating knowledge base with confidence scoring
- [ ] Full self-service: infra changes proposed as PRs against IaC

## Backlog / Stretch / Wishlist / Technical debt

Track loose ideas and deferred items here as they come up — this section is intentionally informal.

-