docs: add critical Flux CD deployment notes

Updated CLAUDE.md and README.md to clearly document:
- Repository is deployed via Flux CD
- Manifests use Flux variable substitution
- Variables must NOT be replaced with hardcoded values

This prevents future mistakes with variable substitution.

Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

README.md

@@ -1,3 +1,20 @@
 # irc
 
-Some useful apps for IRC
+Kubernetes manifests for IRC applications, deployed via Flux CD.
+
+## Applications
+
+- **The Lounge** - Modern web IRC client
+- **ZNC** - IRC bouncer
+
+## Deployment
+
+This repository is deployed to Kubernetes using **Flux CD** with variable substitution. Configuration variables (e.g., hostnames) are provided via ConfigMaps at deployment time.
+
+## CI/CD
+
+Automated validation and security scanning via Gitea Actions:
+- YAML linting and Kustomize validation
+- Kubernetes schema validation (kubeconform)
+- Security scanning (Trivy, Checkov)
+- Best practices analysis (kube-score, Polaris)