llm docs

Author: mitchross

README.md

@@ -216,7 +216,8 @@ All PVC backups use **Kopia on NFS** via VolSync, automated by Kyverno policies.
 - **Backend**: Kopia filesystem repository on TrueNAS NFS (`192.168.10.133:/mnt/BigTank/k8s/volsync-kopia-nfs`)
 - **Encryption**: Kopia password from 1Password (`rustfs` item)
 - **Restore**: Automatic on PVC recreation - PVC Plumber checks for existing backups, Kyverno injects `dataSourceRef`
-- **Details**: See [docs/pvc-plumber-full-flow.md](docs/pvc-plumber-full-flow.md) and [docs/backup-restore.md](docs/backup-restore.md)
+- **Details**: See [docs/pvc-plumber-full-flow.md](docs/pvc-plumber-full-flow.md), [docs/backup-restore.md](docs/backup-restore.md), and [docs/cnpg-disaster-recovery.md](docs/cnpg-disaster-recovery.md)
+- **AI-guided database recovery**: Copy/paste prompts are in [LLM Recovery Prompt Templates](docs/cnpg-disaster-recovery.md#llm-recovery-prompt-templates)
 
 ## Hardware
 

docs/backup-restore.md

@@ -204,6 +204,8 @@ This shared repository design is a deliberate choice. Kopia uses **content-defin
 
 ## Why Two Backup Systems (NFS for PVCs, S3 for Databases)
 
+For CloudNativePG database recovery runbooks (including ArgoCD race-condition handling) see [docs/cnpg-disaster-recovery.md](cnpg-disaster-recovery.md). For AI-assisted incident guidance, use [LLM Recovery Prompt Templates](cnpg-disaster-recovery.md#llm-recovery-prompt-templates).
+
 **PVC backups → NFS + Kopia** because:
 - VolSync's Kopia mover needs filesystem access for content-defined chunking and dedup
 - Direct NFS gives 10Gbps to TrueNAS with no HTTP overhead

docs/index.md

@@ -8,6 +8,8 @@ See the [README](https://github.com/mitchross/talos-argocd-proxmox) for setup in
 
 - [ArgoCD & GitOps Architecture](argocd.md) - Sync waves, app-of-apps pattern, health checks
 - [Backup & Restore](backup-restore.md) - Kyverno + VolSync + PVC Plumber automated backups
+- [CNPG Disaster Recovery](cnpg-disaster-recovery.md) - Manual Postgres recovery workflow, ArgoCD race handling, and lineage bump rules
+- [AI-Guided CNPG Recovery Prompt](cnpg-disaster-recovery.md#llm-recovery-prompt-templates) - Copy/paste prompts for LLM-assisted recovery
 - [Full Backup Flow](pvc-plumber-full-flow.md) - Complete bare-metal to disaster recovery walkthrough
 - [VPA Resource Optimization](vpa-resource-optimization.md) - Using VPA/Goldilocks to right-size pod resources
 - [Network Topology](network-topology.md) - Cluster networking and 10G infrastructure