diff --git a/AGENTS.md b/AGENTS.md
index 50628caa4..a97c8323a 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -26,6 +26,7 @@ Sibling pattern to `kubeops.dev/installer`, `kubevault.dev/installer`, etc. —
 - `make gen-values-schema` — regenerate `values.openapiv3_schema.yaml`.
 - `make gen-chart-doc` — per-chart `README.md`.
 - `make update-charts` — refresh chart metadata.
+- `make refresh` — `gen update-catalog fmt`. **ALWAYS run this before opening a PR** so generated files are current.
 - `make fmt`, `make lint`, `make unit-tests` / `make test` — standard.
 - `make ct` — chart-testing.
 - `make verify` — module-tidy verification.
diff --git a/Makefile b/Makefile
index afc359fbc..569fdf278 100644
--- a/Makefile
+++ b/Makefile
@@ -227,6 +227,9 @@ manifests: gen-crds gen-schema patch-schema gen-chart-doc
 .PHONY: gen
 gen: codegen manifests
 
+.PHONY: refresh
+refresh: gen update-catalog fmt
+
 BIN_DIR ?= $(CURDIR)/bin/$(OS)_$(ARCH)
 
 .PHONY: install-image-packer