diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..85e7c1d
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1 @@
+/.idea/
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..65462f4
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,74 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Repository Overview
+
+This repository contains Kubernetes manifests for deploying a media server stack and supporting infrastructure. The deployment uses LinuxServer.io containers for media applications and integrates with external NFS storage.
+
+## Architecture
+
+### Application Stack
+- **Media Applications** (`arr/` directory):
+  - Radarr (movies) - port 7878
+  - Sonarr (TV shows) - port 8989
+  - Prowlarr (indexer manager)
+  - SABnzbd (downloads)
+  - Overseerr (requests) - port 5055
+  - Tautulli (Plex monitoring)
+
+### Infrastructure Components
+- **MetalLB**: Load balancer with IP pool 192.168.15.200-192.168.15.210
+- **Longhorn**: Block storage for application configs
+- **NFS Storage**: External server at 192.168.12.16 for media files
+- **Kubernetes Dashboard**: Web UI with admin access
+
+## Deployment Commands
+
+```bash
+# Create namespace (required first)
+kubectl create namespace media
+
+# Deploy infrastructure
+kubectl apply -f nfs-storage-classes.yaml
+kubectl apply -f metallb-config.yaml
+kubectl apply -f kubernetes-dashboard.yaml
+
+# Deploy all media applications
+kubectl apply -f arr/
+
+# Deploy individual apps
+kubectl apply -f arr/radarr.yaml
+kubectl apply -f arr/sonarr.yaml
+```
+
+## Resource Patterns
+
+Each media application follows this structure:
+1. **Deployment**: Container with resource limits, PUID/PGID=1000, TZ=America/New_York
+2. **PersistentVolumeClaim**: Config storage using Longhorn
+3. **Service**: ClusterIP for internal communication
+4. **Ingress**: NGINX routing with pattern `{app}.local`
+
+## Storage Configuration
+
+- **Config Storage**: Longhorn PVCs for each application
+- **Media Storage**: NFS mounts from 192.168.12.16:
+  - `/Volume2/media` → `/media`
+  - `/Volume2/tv` → `/tv`
+  - `/Volume2/movies` → `/movies`
+  - `/Volume2/downloads` → `/downloads`
+
+## Prerequisites
+
+- NGINX Ingress Controller must be installed
+- Longhorn storage system must be deployed
+- NFS server must be accessible at 192.168.12.16
+- Local DNS must resolve `*.local` domains
+
+## Important Notes
+
+- All containers run with UID/GID 1000
+- Dashboard has full cluster-admin privileges
+- All images use `latest` tag
+- Media namespace must exist before deploying applications
\ No newline at end of file