diff --git a/template/stacks/ci-sizer/sizer-receiver.yaml b/template/stacks/ci-sizer/sizer-receiver.yaml
index cd36a47..1fc7279 100644
--- a/template/stacks/ci-sizer/sizer-receiver.yaml
+++ b/template/stacks/ci-sizer/sizer-receiver.yaml
@@ -1,3 +1,7 @@
+# Required: CI Sizer receiver
+# Always deploy this — it stores metrics and computes sizing recommendations.
+# Works standalone or with GARM (Forgejo/GitHub) and/or GitLab webhook.
+# See: ci-sizer/docs/deployment-modes.md
 apiVersion: argoproj.io/v1alpha1
 kind: Application
 metadata:
diff --git a/template/stacks/garm/garm.yaml b/template/stacks/garm/garm.yaml
index b643346..67fc4a3 100644
--- a/template/stacks/garm/garm.yaml
+++ b/template/stacks/garm/garm.yaml
@@ -1,3 +1,7 @@
+# Default: Forgejo/GitHub Actions runner manager
+# Deploys GARM with the ci-sizer provider for automatic sizing + collector injection.
+# For GitLab-only deployments, omit this and use gitlab-webhook instead.
+# See: ci-sizer/docs/deployment-modes.md
 apiVersion: argoproj.io/v1alpha1
 kind: Application
 metadata: