diff --git a/.agent/agents/backend-executor.md b/.agent/agents/backend-executor.agent.md
similarity index 100%
rename from .agent/agents/backend-executor.md
rename to .agent/agents/backend-executor.agent.md
diff --git a/.agent/agents/design-agent.md b/.agent/agents/design-agent.agent.md
similarity index 100%
rename from .agent/agents/design-agent.md
rename to .agent/agents/design-agent.agent.md
diff --git a/.agent/agents/frontend-executor.md b/.agent/agents/frontend-executor.agent.md
similarity index 100%
rename from .agent/agents/frontend-executor.md
rename to .agent/agents/frontend-executor.agent.md
diff --git a/.agent/agents/orchestrator.md b/.agent/agents/orchestrator.agent.md
similarity index 100%
rename from .agent/agents/orchestrator.md
rename to .agent/agents/orchestrator.agent.md
diff --git a/.agent/agents/requirements-agent.md b/.agent/agents/requirements-agent.agent.md
similarity index 100%
rename from .agent/agents/requirements-agent.md
rename to .agent/agents/requirements-agent.agent.md
diff --git a/.agent/agents/reviewer-agent.md b/.agent/agents/reviewer-agent.agent.md
similarity index 100%
rename from .agent/agents/reviewer-agent.md
rename to .agent/agents/reviewer-agent.agent.md
diff --git a/.agent/agents/task-breakdown-agent.md b/.agent/agents/task-breakdown-agent.agent.md
similarity index 100%
rename from .agent/agents/task-breakdown-agent.md
rename to .agent/agents/task-breakdown-agent.agent.md
diff --git a/README.md b/README.md
index b5b705e..b3cce0d 100644
--- a/README.md
+++ b/README.md
@@ -75,13 +75,13 @@ repo/
 │
 └── .agent/
     ├── agents/                        # Agent prompt definitions
-    │   ├── orchestrator.md
-    │   ├── requirements-agent.md
-    │   ├── design-agent.md
-    │   ├── task-breakdown-agent.md
-    │   ├── backend-executor.md
-    │   ├── frontend-executor.md
-    │   └── reviewer-agent.md
+    │   ├── orchestrator.agent.md
+    │   ├── requirements-agent.agent.md
+    │   ├── design-agent.agent.md
+    │   ├── task-breakdown-agent.agent.md
+    │   ├── backend-executor.agent.md
+    │   ├── frontend-executor.agent.md
+    │   └── reviewer-agent.agent.md
     ├── templates/                     # Document templates
     │   ├── epic.md
     │   ├── story.md
@@ -121,7 +121,7 @@ repo/
 
 Start Plan Mode when you have a new goal but no spec files yet.
 
-Give the **Orchestrator** agent the prompt from `.agent/agents/orchestrator.md` and describe your goal. The orchestrator will:
+Give the **Orchestrator** agent the prompt from `.agent/agents/orchestrator.agent.md` and describe your goal. The orchestrator will:
 
 1. Spawn the **Requirements Agent** → produces `story.md` / `epic.md`
 2. Spawn the **Design Agent** → produces `design.md`
@@ -133,7 +133,7 @@ Give the **Orchestrator** agent the prompt from `.agent/agents/orchestrator.md`
 
 Start Execute Mode when approved spec files already exist.
 
-Give the **Orchestrator** agent the prompt from `.agent/agents/orchestrator.md` and point it at the approved `tasks.md`. The orchestrator will:
+Give the **Orchestrator** agent the prompt from `.agent/agents/orchestrator.agent.md` and point it at the approved `tasks.md`. The orchestrator will:
 
 1. Pick the next unblocked task
 2. Spawn the appropriate **Executor Agent** (backend or frontend)
diff --git a/install.sh b/install.sh
index aca1cb2..299a408 100755
--- a/install.sh
+++ b/install.sh
@@ -118,6 +118,6 @@ info ""
 info "Done. Next steps:"
 info "  1. Open $TARGET/.agent/standards/ and fill in the placeholder"
 info "     code, testing, and documentation standards for your project."
-info "  2. Read $TARGET/.agent/agents/orchestrator.md to understand"
+info "  2. Read $TARGET/.agent/agents/orchestrator.agent.md to understand"
 info "     how to start a Plan Mode or Execute Mode session."
 info "  3. Optionally copy README.md from this repository for reference."