diff --git a/AGENTS.md b/AGENTS.md
index 085342923..da81eb204 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -52,15 +52,15 @@ This is a **production-ready AI coding plugin** providing 68 specialized agents,
 ## Agent Orchestration
 
 Use agents proactively without user prompt:
-- Complex feature requests → **planner**
-- Code just written/modified → **code-reviewer**
-- Bug fix or new feature → **tdd-guide**
-- Architectural decision → **architect**
-- Security-sensitive code → **security-reviewer**
-- Brownfield project onboarding → **spec-miner**
-- Autonomous loops / loop monitoring → **loop-operator**
-- Harness config reliability and cost → **harness-optimizer**
-- RAG/retrieval pipeline changes → **rag-pipeline-reviewer**
+- Complex feature requests → **ecc:planner**
+- Code just written/modified → **ecc:code-reviewer**
+- Bug fix or new feature → **ecc:tdd-guide**
+- Architectural decision → **ecc:architect**
+- Security-sensitive code → **ecc:security-reviewer**
+- Brownfield project onboarding → **ecc:spec-miner**
+- Autonomous loops / loop monitoring → **ecc:loop-operator**
+- Harness config reliability and cost → **ecc:harness-optimizer**
+- RAG/retrieval pipeline changes → **ecc:rag-pipeline-reviewer**
 
 Use parallel execution for independent operations — launch multiple agents simultaneously.
 
@@ -114,9 +114,9 @@ Troubleshoot failures: check test isolation → verify mocks → fix implementat
 
 ## Development Workflow
 
-1. **Plan** — Use planner agent, identify dependencies and risks, break into phases
-2. **TDD** — Use tdd-guide agent, write tests first, implement, refactor
-3. **Review** — Use code-reviewer agent immediately, address CRITICAL/HIGH issues
+1. **Plan** — Use ecc:planner agent, identify dependencies and risks, break into phases
+2. **TDD** — Use ecc:tdd-guide agent, write tests first, implement, refactor
+3. **Review** — Use ecc:code-reviewer agent immediately, address CRITICAL/HIGH issues
 4. **Capture knowledge in the right place**
    - Personal debugging notes, preferences, and temporary context → auto memory
    - Team/project knowledge (architecture decisions, API changes, runbooks) → the project's existing docs structure
diff --git a/docs/es/AGENTS.md b/docs/es/AGENTS.md
index f19fa7120..c15bf5539 100644
--- a/docs/es/AGENTS.md
+++ b/docs/es/AGENTS.md
@@ -50,13 +50,13 @@ Este es un **plugin de IA para codificación listo para producción** que propor
 ## Orquestación de Agentes
 
 Usa agentes proactivamente sin prompt del usuario:
-- Solicitudes de features complejas → **planner**
-- Código recién escrito/modificado → **code-reviewer**
-- Corrección de bug o nueva feature → **tdd-guide**
-- Decisión arquitectónica → **architect**
-- Código sensible a la seguridad → **security-reviewer**
-- Bucles autónomos / monitoreo de bucles → **loop-operator**
-- Confiabilidad y costo de la configuración del harness → **harness-optimizer**
+- Solicitudes de features complejas → **ecc:planner**
+- Código recién escrito/modificado → **ecc:code-reviewer**
+- Corrección de bug o nueva feature → **ecc:tdd-guide**
+- Decisión arquitectónica → **ecc:architect**
+- Código sensible a la seguridad → **ecc:security-reviewer**
+- Bucles autónomos / monitoreo de bucles → **ecc:loop-operator**
+- Confiabilidad y costo de la configuración del harness → **ecc:harness-optimizer**
 
 Usa ejecución paralela para operaciones independientes — lanza múltiples agentes simultáneamente.
 
diff --git a/docs/es/rules/common/agents.md b/docs/es/rules/common/agents.md
index 8c162c58f..bb61f7c14 100644
--- a/docs/es/rules/common/agents.md
+++ b/docs/es/rules/common/agents.md
@@ -5,7 +5,9 @@
 Los agentes de ECC se distribuyen con el plugin `ecc@ecc`, no en `~/.claude/agents/`.
 Se invocan a través de la herramienta Agent con un `subagent_type` con ámbito de plugin:
 
-    Agent(subagent_type: "ecc:planner", prompt: "...")
+```text
+Agent(subagent_type: "ecc:planner", prompt: "...")
+```
 
 | Agente | Propósito | Cuándo Usar |
 |--------|-----------|-------------|
diff --git a/docs/ja-JP/AGENTS.md b/docs/ja-JP/AGENTS.md
index be7370bc0..f32e801b8 100644
--- a/docs/ja-JP/AGENTS.md
+++ b/docs/ja-JP/AGENTS.md
@@ -50,13 +50,13 @@
 ## エージェントオーケストレーション
 
 ユーザーのプロンプトなしで積極的にエージェントを使用する：
-- 複雑な機能リクエスト → **planner**
-- コードの作成/変更直後 → **code-reviewer**
-- バグ修正または新機能 → **tdd-guide**
-- アーキテクチャの意思決定 → **architect**
-- セキュリティに関わるコード → **security-reviewer**
-- 自律ループ / ループ監視 → **loop-operator**
-- ハーネス設定の信頼性とコスト → **harness-optimizer**
+- 複雑な機能リクエスト → **ecc:planner**
+- コードの作成/変更直後 → **ecc:code-reviewer**
+- バグ修正または新機能 → **ecc:tdd-guide**
+- アーキテクチャの意思決定 → **ecc:architect**
+- セキュリティに関わるコード → **ecc:security-reviewer**
+- 自律ループ / ループ監視 → **ecc:loop-operator**
+- ハーネス設定の信頼性とコスト → **ecc:harness-optimizer**
 
 独立した操作には並列実行を使用する — 複数のエージェントを同時に起動する。
 
diff --git a/docs/ja-JP/rules/common/agents.md b/docs/ja-JP/rules/common/agents.md
index 7b8082cf7..71cd7754e 100644
--- a/docs/ja-JP/rules/common/agents.md
+++ b/docs/ja-JP/rules/common/agents.md
@@ -5,7 +5,9 @@
 ECC の Agent は `ecc@ecc` プラグインに同梱されており、`~/.claude/agents/` には配置されません。
 Agent ツールではプラグインスコープの `subagent_type` で呼び出します:
 
-    Agent(subagent_type: "ecc:planner", prompt: "...")
+```text
+Agent(subagent_type: "ecc:planner", prompt: "...")
+```
 
 | Agent | 目的 | 使用タイミング |
 |-------|---------|-------------|
diff --git a/docs/tr/AGENTS.md b/docs/tr/AGENTS.md
index c49b9962a..abb7dbd7e 100644
--- a/docs/tr/AGENTS.md
+++ b/docs/tr/AGENTS.md
@@ -47,14 +47,14 @@ Bu, yazılım geliştirme için 68 özel agent, 292 skill, 94 command ve otomati
 ## Agent Orkestrasyonu
 
 Agentları kullanıcı istemi olmadan proaktif olarak kullanın:
-- Karmaşık özellik istekleri → **planner**
-- Yeni yazılan/değiştirilen kod → **code-reviewer**
-- Hata düzeltme veya yeni özellik → **tdd-guide**
-- Mimari karar → **architect**
-- Güvenlik açısından hassas kod → **security-reviewer**
-- Çok kanallı iletişim önceliklendirme → **chief-of-staff**
-- Otonom döngüler / döngü izleme → **loop-operator**
-- Harness yapılandırma güvenilirliği ve maliyeti → **harness-optimizer**
+- Karmaşık özellik istekleri → **ecc:planner**
+- Yeni yazılan/değiştirilen kod → **ecc:code-reviewer**
+- Hata düzeltme veya yeni özellik → **ecc:tdd-guide**
+- Mimari karar → **ecc:architect**
+- Güvenlik açısından hassas kod → **ecc:security-reviewer**
+- Çok kanallı iletişim önceliklendirme → **ecc:chief-of-staff**
+- Otonom döngüler / döngü izleme → **ecc:loop-operator**
+- Harness yapılandırma güvenilirliği ve maliyeti → **ecc:harness-optimizer**
 
 Bağımsız işlemler için paralel yürütme kullanın — birden fazla agenti aynı anda başlatın.
 
diff --git a/docs/tr/rules/common/agents.md b/docs/tr/rules/common/agents.md
index b96f3a13a..d00403e87 100644
--- a/docs/tr/rules/common/agents.md
+++ b/docs/tr/rules/common/agents.md
@@ -5,7 +5,9 @@
 ECC agent'ları `ecc@ecc` eklentisiyle birlikte gelir, `~/.claude/agents/` dizininde bulunmaz.
 Agent aracıyla eklenti kapsamlı bir `subagent_type` ile çağrılır:
 
-    Agent(subagent_type: "ecc:planner", prompt: "...")
+```text
+Agent(subagent_type: "ecc:planner", prompt: "...")
+```
 
 | Agent | Amaç | Ne Zaman Kullanılır |
 |-------|---------|-------------|
diff --git a/docs/zh-CN/AGENTS.md b/docs/zh-CN/AGENTS.md
index 2f5a18856..3ee93e205 100644
--- a/docs/zh-CN/AGENTS.md
+++ b/docs/zh-CN/AGENTS.md
@@ -48,14 +48,14 @@
 
 主动使用智能体，无需用户提示：
 
-* 复杂功能请求 → **planner**
-* 刚编写/修改的代码 → **code-reviewer**
-* 错误修复或新功能 → **tdd-guide**
-* 架构决策 → **architect**
-* 安全敏感代码 → **security-reviewer**
-* 多渠道沟通分流 → **chief-of-staff**
-* 自主循环 / 循环监控 → **loop-operator**
-* 线束配置可靠性及成本 → **harness-optimizer**
+* 复杂功能请求 → **ecc:planner**
+* 刚编写/修改的代码 → **ecc:code-reviewer**
+* 错误修复或新功能 → **ecc:tdd-guide**
+* 架构决策 → **ecc:architect**
+* 安全敏感代码 → **ecc:security-reviewer**
+* 多渠道沟通分流 → **ecc:chief-of-staff**
+* 自主循环 / 循环监控 → **ecc:loop-operator**
+* 线束配置可靠性及成本 → **ecc:harness-optimizer**
 
 对于独立操作使用并行执行 — 同时启动多个智能体。
 
diff --git a/docs/zh-CN/rules/common/agents.md b/docs/zh-CN/rules/common/agents.md
index da79b41d6..3f3c2edaa 100644
--- a/docs/zh-CN/rules/common/agents.md
+++ b/docs/zh-CN/rules/common/agents.md
@@ -5,7 +5,9 @@
 ECC 智能体随 `ecc@ecc` 插件一起分发，不在 `~/.claude/agents/` 目录中。
 它们通过 Agent 工具以插件作用域的 `subagent_type` 调用：
 
-    Agent(subagent_type: "ecc:planner", prompt: "...")
+```text
+Agent(subagent_type: "ecc:planner", prompt: "...")
+```
 
 | 代理 | 用途 | 使用时机 |
 |-------|---------|-------------|
diff --git a/rules/common/agents.md b/rules/common/agents.md
index cb36573c6..14d9b9005 100644
--- a/rules/common/agents.md
+++ b/rules/common/agents.md
@@ -5,7 +5,9 @@
 ECC agents ship with the `ecc@ecc` plugin, not in `~/.claude/agents/`.
 They are invoked through the Agent tool with a plugin-scoped `subagent_type`:
 
-    Agent(subagent_type: "ecc:planner", prompt: "...")
+```text
+Agent(subagent_type: "ecc:planner", prompt: "...")
+```
 
 | Agent | Purpose | When to Use |
 |-------|---------|-------------|