pi-cluster

Operating the local coding agent — qwen3-coder via opencode, Claude-orchestrated, spec-driven. Use when running/troubleshooting `oc`, the ralph-qwen loop, or the laptop↔Beelink-qwen creds.

Expert knowledge for cluster backup and restore operations. Use when configuring backups, triggering manual jobs, or restoring data.

Expert knowledge for media applications (Jellyfin, Immich, Jellyseerr). Use when managing media storage, NFS mounts, or application-specific configurations.

Expert knowledge for Pi-hole and Unbound DNS operations. Use when configuring DNS, troubleshooting resolution issues, modifying adlists, or understanding the DNS data flow.

Expert knowledge for cluster observability. Use when configuring Prometheus/Grafana, Alertmanager, Uptime Kuma, or the Homepage dashboard.

Expert knowledge for Tailscale VPN operations. Use when configuring remote access, exit nodes, ACL policies, or troubleshooting VPN connectivity.

Expert knowledge for the Family Board kiosk dashboard (board.lab.mtgibbs.dev) — a framework-light PWA that renders the n8n intake feed. Use when designing or changing the board UI, adding fixtures, or wiring the feed proxy. The deployable workspace is clusters/pi-k3s/family-board/.

Direct REST API patterns for Sonarr, Radarr, Prowlarr, Bazarr, SABnzbd. Use when MCP tools don't expose the operation needed (manual import, release grab, availability override, bulk wanted-search, etc.).

Expert knowledge for TLS/SSL operations. Use when configuring certificates, debugging cert-manager, or managing Ingress TLS.

Deploy and troubleshoot Flux GitOps configurations for Pi K3s cluster. Use when deploying Kustomizations, managing HelmReleases, debugging Flux sync issues, or committing and pushing changes.

Diagnose and fix Kubernetes cluster issues on Pi K3s. Use when investigating pod failures, resource issues, networking problems, DNS issues, or general cluster health concerns.

Manage secrets using External Secrets Operator and 1Password. Use when creating ExternalSecrets, troubleshooting secret sync, configuring 1Password items, or bootstrapping the secrets infrastructure.

Expert knowledge for Flux Image Automation. Use when configuring auto-deploys, debugging image scanners, or updating GitHub credentials.

Scaffold and deploy a new service to the Pi K3s cluster. Use when adding new applications, creating the full GitOps structure, or setting up ingress and secrets for new services.