diff --git a/src/agents/AGENTS.md b/src/agents/AGENTS.md
index 9d83d29d2..bd7fe1136 100644
--- a/src/agents/AGENTS.md
+++ b/src/agents/AGENTS.md
@@ -1,3 +1,8 @@
+---
+name: agents-directory
+description: Developer reference for all 11 Oh My OpenAgent agent definitions, factory patterns, tool restrictions, and model routing.
+---
+
 # src/agents/ — 11 Agent Definitions
 
 **Generated:** 2026-04-18
diff --git a/src/agents/hephaestus/AGENTS.md b/src/agents/hephaestus/AGENTS.md
index 5db747318..c578b3970 100644
--- a/src/agents/hephaestus/AGENTS.md
+++ b/src/agents/hephaestus/AGENTS.md
@@ -1,3 +1,8 @@
+---
+name: hephaestus-agent
+description: Developer reference for the Hephaestus autonomous deep worker agent — model variants, key behaviors, and delegation patterns.
+---
+
 # src/agents/hephaestus/ -- Autonomous Deep Worker
 
 **Generated:** 2026-04-11
diff --git a/src/agents/prometheus/AGENTS.md b/src/agents/prometheus/AGENTS.md
index 63a81b818..6f707947f 100644
--- a/src/agents/prometheus/AGENTS.md
+++ b/src/agents/prometheus/AGENTS.md
@@ -1,3 +1,8 @@
+---
+name: prometheus-agent
+description: Developer reference for the Prometheus strategic planner agent — interview flow, plan output format, and key constraints.
+---
+
 # src/agents/prometheus/ -- Strategic Planner
 
 **Generated:** 2026-04-11
diff --git a/src/agents/sisyphus/AGENTS.md b/src/agents/sisyphus/AGENTS.md
index 15bdae2de..c8251e106 100644
--- a/src/agents/sisyphus/AGENTS.md
+++ b/src/agents/sisyphus/AGENTS.md
@@ -1,3 +1,8 @@
+---
+name: sisyphus-variants
+description: Developer reference for Sisyphus orchestrator model-specific prompt variants — selection logic and key exports.
+---
+
 # src/agents/sisyphus/ -- Orchestrator Variants
 
 **Generated:** 2026-04-11