diff --git a/docs/roadmap.md b/docs/roadmap.md
index e69de29..0189d9c 100644
--- a/docs/roadmap.md
+++ b/docs/roadmap.md
@@ -0,0 +1,64 @@
+
+
+```markdown
+# Project Roadmap
+
+## Phase 1 — Repo Foundation
+
+- [ ] Create repo
+- [ ] Add README
+- [ ] Add architecture document
+- [ ] Add setup guide
+- [ ] Add roadmap
+- [ ] Add troubleshooting guide
+
+---
+
+## Phase 2 — Metrics Foundation
+
+- [ ] Install node exporter
+- [ ] Add Prometheus config
+- [ ] Add K3s node targets
+- [ ] Add Proxmox target
+- [ ] Add service uptime checks
+
+---
+
+## Phase 3 — Grafana Dashboards
+
+- [ ] Add Prometheus datasource
+- [ ] Build infrastructure dashboard
+- [ ] Build K3s dashboard
+- [ ] Build Proxmox dashboard
+- [ ] Build service uptime dashboard
+
+---
+
+## Phase 4 — Alerting
+
+- [ ] Add alert rules
+- [ ] Add Alertmanager
+- [ ] Test node down alert
+- [ ] Test service down alert
+- [ ] Document alert response process
+
+---
+
+## Phase 5 — Advanced Observability
+
+- [ ] Add Loki for logs
+- [ ] Add Cloudflare access logs
+- [ ] Add Kubernetes event monitoring
+- [ ] Add Proxmox HA event monitoring
+- [ ] Add incident response notes
+
+---
+
+## Phase 6 — Portfolio Polish
+
+- [ ] Add screenshots
+- [ ] Add architecture diagram image
+- [ ] Add demo dashboard image
+- [ ] Link to Ced’s HomeLab repo
+- [ ] Link to Ced’s NOC repo
+- [ ] Add project summary to portfolio website
\ No newline at end of file