Updated project to improve guidance

clusters/homelab/apps.yaml

@@ -1,6 +1,13 @@
 # flux bootstrap points the flux-system Kustomization at ./clusters/homelab
 # and applies everything under it (prune: true), so these Kustomization
 # objects are how the rest of the repo gets pulled in.
+#
+# One object per app, each with its own sourceRef/interval/prune, rather
+# than a single Kustomization pointed at all of apps/ — see README.md
+# "Why it's structured this way" for the reasoning (independent failure
+# domains, independent `flux get kustomization <name>` debugging). All
+# three share the same sourceRef because they all come from this one repo
+# — sourceRef is what to fetch from, path is where inside it to look.
 
 apiVersion: kustomize.toolkit.fluxcd.io/v1
 kind: Kustomization