diff --git a/internal/config/config.go b/internal/config/config.go
index fe0336c5bb..abdfeb9b04 100644
--- a/internal/config/config.go
+++ b/internal/config/config.go
@@ -733,16 +733,7 @@ const perRepoConfigHeader = `# fullsend per-repo configuration
 # https://github.com/fullsend-ai/fullsend
 #
 # This file configures fullsend for per-repo installation mode.
-# See ADR 0033 for details.
-#
-# The "runtime" key selects which agent runtime runs the agents, claude
-# (default when unset) or pi. For one run, the 'fullsend run --runtime'
-# flag wins, then FULLSEND_RUNTIME, then this file. See docs/runtimes.md.
-#
-# An entry in the agents list can set runtime, model and effort for one
-# agent (an entry with just a name tunes a built-in agent); those win over
-# the repo-wide runtime key and the harness, and per-run flags/variables
-# still win over them. See docs/runtimes.md.
+# See https://fullsend.sh/docs/guides/infrastructure/layered-config-reference
 `
 
 // NewPerRepoConfig creates a new perRepoConfig with the given roles.
diff --git a/internal/config/config_test.go b/internal/config/config_test.go
index b29b0d950a..a0bcff0103 100644
--- a/internal/config/config_test.go
+++ b/internal/config/config_test.go
@@ -742,6 +742,13 @@ func TestPerRepoConfigMarshal_KillSwitchOmitted(t *testing.T) {
 	assert.NotContains(t, string(data), "kill_switch")
 }
 
+func TestPerRepoConfigHeaderPointsToUserDocs(t *testing.T) {
+	assert.NotContains(t, perRepoConfigHeader, "ADR",
+		"per-repo config header must not reference internal ADRs")
+	assert.Contains(t, perRepoConfigHeader, "https://fullsend.sh/",
+		"per-repo config header should link to user-facing docs")
+}
+
 func TestPerRepoConfig_RoundTrip(t *testing.T) {
 	original := NewPerRepoConfig([]string{"fullsend", "triage", "coder", "review", "fix"}, "")
 	data, err := original.Marshal()