Complete Phase 6: documentation cleanup and integration

- Delete docs/zk/ directory (content migrated to structured docs)
- Delete docs/README.md (docs/index.md is now the root)
- Add devpi reference card and use-pypi-proxy how-to guide
- Add maintenance notes to indri reference (sleep prevention, sudo)
- Add iCloud Photos backup note to borgmatic reference
- Rewrite zk-docs task to prime AI context with key docs
- Update CLAUDE.md and README.md to remove zk references
- Update exploring-the-docs with AI context priming section

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

docs/reference/index.md

@@ -31,6 +31,7 @@ Individual service reference cards with URLs and configuration details.
 | [[teslamate]] | Tesla data logger | k8s |
 | [[transmission]] | BitTorrent daemon | k8s |
 | [[zot]] | Container registry | indri |
+| [[devpi]] | PyPI caching proxy | k8s |
 | [[docs]] | Documentation site (Quartz) | k8s |
 
 ## Infrastructure

docs/reference/infrastructure/indri.md

@@ -32,6 +32,12 @@ Primary BlumeOps server. Mac Mini M1 (2020).
 **Kubernetes (via minikube):**
 - [[apps | All k8s applications]]
 
+## Maintenance Notes
+
+**Sleep prevention:** Uses Amphetamine (App Store) to prevent sleep. If Amphetamine crashes after extended uptime, consider switching to `pmset` or `caffeinate` via ansible.
+
+**Passwordless sudo:** Configured for `erichblume` user (`/etc/sudoers.d/erichblume`) to allow ansible `become: true` without prompts. Acceptable given Tailscale is the trust boundary.
+
 ## Related
 
 - [[routing | Routing]] - Port mappings

docs/reference/services/borgmatic.md

@@ -25,7 +25,9 @@ Daily backup system using Borg backup, running on indri.
 - `/opt/homebrew/var/forgejo` - Git forge data
 - `~/.config/borgmatic` - Borgmatic config
 - `~/Documents` - Personal documents
-- `~/Pictures` - Photos
+- `~/Pictures` - Photos (see note below)
+
+**iCloud Photos note:** macOS Photos.app defaults to "Optimize Mac Storage" which keeps only thumbnails locally. Borgmatic only backs up what's on disk, so iCloud-only photos are NOT backed up via this method.
 
 **Databases:**
 - `miniflux` on [[postgresql]]

docs/reference/services/devpi.md

@@ -0,0 +1,37 @@
+---
+title: devpi
+tags:
+  - service
+  - python
+---
+
+# devpi (PyPI Proxy)
+
+PyPI caching proxy and private package index.
+
+## Quick Reference
+
+| Property | Value |
+|----------|-------|
+| **URL** | https://pypi.ops.eblu.me |
+| **Namespace** | `devpi` |
+| **ArgoCD App** | `devpi` |
+| **Storage** | 50Gi PVC |
+| **Image** | `registry.ops.eblu.me/blumeops/devpi:latest` |
+
+## Indices
+
+| Index | Purpose |
+|-------|---------|
+| `root/pypi` | PyPI mirror/cache (auto-created) |
+| `eblume/dev` | Private packages (inherits from root/pypi) |
+
+## Credentials
+
+Root password stored in 1Password (blumeops vault), injected via ExternalSecret.
+
+## Related
+
+- [[how-to/use-pypi-proxy]] - Client configuration and package uploads
+- [[argocd]] - Deployment
+- [[1password]] - Secrets management