diff --git a/templates/MAIN_AGENTS.md b/templates/MAIN_AGENTS.md
index d97ce59c..ddcb6576 100644
--- a/templates/MAIN_AGENTS.md
+++ b/templates/MAIN_AGENTS.md
@@ -8,7 +8,7 @@ This workspace belongs to the **Main Agent** for this gateway. You are not tied
 ## Every session
 Before doing anything else:
 1) Read SOUL.md (identity, boundaries)
-2) Read MAIN_USER.md (who you serve)
+2) Read USER.md (who you serve)
 3) Read memory/YYYY-MM-DD.md for today and yesterday (create memory/ if missing)
 4) If this is the main or direct session, also read memory.md
 
diff --git a/templates/MAIN_BOOT.md b/templates/MAIN_BOOT.md
index 0c7dba0e..46e6011d 100644
--- a/templates/MAIN_BOOT.md
+++ b/templates/MAIN_BOOT.md
@@ -2,6 +2,6 @@
 
 You are the **Main Agent** for this gateway.
 
-- Read MAIN_AGENTS.md and MAIN_USER.md first.
+- Read AGENTS.md and USER.md first.
 - Use Mission Control API for all outputs.
 - Do not respond in OpenClaw chat.
diff --git a/templates/MAIN_HEARTBEAT.md b/templates/MAIN_HEARTBEAT.md
index 9caf7879..97f26bef 100644
--- a/templates/MAIN_HEARTBEAT.md
+++ b/templates/MAIN_HEARTBEAT.md
@@ -4,8 +4,8 @@
 This file defines the main agent heartbeat. You are not tied to any board.
 
 ## Required inputs
-- BASE_URL (e.g. http://localhost:8000)
-- AUTH_TOKEN (agent token)
+- BASE_URL (e.g. http://localhost:8000) — see USER.md or TOOLS.md
+- AUTH_TOKEN (agent token) — see USER.md or TOOLS.md
 - AGENT_NAME
 - AGENT_ID
 
diff --git a/templates/MAIN_TOOLS.md b/templates/MAIN_TOOLS.md
index 36b91c8d..7dea11a9 100644
--- a/templates/MAIN_TOOLS.md
+++ b/templates/MAIN_TOOLS.md
@@ -1,4 +1,4 @@
-# MAIN_TOOLS.md
+# TOOLS.md (Main Agent)
 
 BASE_URL={{ base_url }}
 AUTH_TOKEN={{ auth_token }}
diff --git a/templates/MAIN_USER.md b/templates/MAIN_USER.md
index 3e2acd79..4e21b758 100644
--- a/templates/MAIN_USER.md
+++ b/templates/MAIN_USER.md
@@ -1,4 +1,4 @@
-# MAIN_USER.md
+# USER.md (Main Agent)
 
 ## User
 - Name: {{ user_name }}