diff --git a/.opencode/agents/behave-tester-codex.md b/.opencode/agents/behave-tester-codex.md
index e69de29bb..ca9dff99b 100644
--- a/.opencode/agents/behave-tester-codex.md
+++ b/.opencode/agents/behave-tester-codex.md
@@ -0,0 +1,7 @@
+---
+description: This subagent should only be called manually by the user.
+mode: subagent
+hidden: true
+---
+
+This agent has been deprecated. Use the tier selector architecture instead.
diff --git a/.opencode/agents/behave-tester-haiku.md b/.opencode/agents/behave-tester-haiku.md
index e69de29bb..ca9dff99b 100644
--- a/.opencode/agents/behave-tester-haiku.md
+++ b/.opencode/agents/behave-tester-haiku.md
@@ -0,0 +1,7 @@
+---
+description: This subagent should only be called manually by the user.
+mode: subagent
+hidden: true
+---
+
+This agent has been deprecated. Use the tier selector architecture instead.
diff --git a/.opencode/agents/behave-tester-opus.md b/.opencode/agents/behave-tester-opus.md
index e69de29bb..ca9dff99b 100644
--- a/.opencode/agents/behave-tester-opus.md
+++ b/.opencode/agents/behave-tester-opus.md
@@ -0,0 +1,7 @@
+---
+description: This subagent should only be called manually by the user.
+mode: subagent
+hidden: true
+---
+
+This agent has been deprecated. Use the tier selector architecture instead.
diff --git a/.opencode/agents/behave-tester-sonnet.md b/.opencode/agents/behave-tester-sonnet.md
index e69de29bb..ca9dff99b 100644
--- a/.opencode/agents/behave-tester-sonnet.md
+++ b/.opencode/agents/behave-tester-sonnet.md
@@ -0,0 +1,7 @@
+---
+description: This subagent should only be called manually by the user.
+mode: subagent
+hidden: true
+---
+
+This agent has been deprecated. Use the tier selector architecture instead.
diff --git a/.opencode/agents/build-opencode.md b/.opencode/agents/build-opencode.md
index 65aee216c..dcbbea681 100644
--- a/.opencode/agents/build-opencode.md
+++ b/.opencode/agents/build-opencode.md
@@ -31,7 +31,7 @@ You have FULL authority to:
 
 ## Agent Format Documentation
 
-The official OpenCode agent format is documented at https://opencode.ai/docs/agents
+The official OpenCode agent format is documented at https://opencode.ai/docs/agents , read this website and related links in completely to ensure you understand how the files in the `.opencode/` directory work and are formated.
 
 Key requirements for agent files:
 1. **Markdown files** with `.md` extension
diff --git a/.opencode/agents/coverage-checker.md b/.opencode/agents/coverage-checker.md
index e69de29bb..ca9dff99b 100644
--- a/.opencode/agents/coverage-checker.md
+++ b/.opencode/agents/coverage-checker.md
@@ -0,0 +1,7 @@
+---
+description: This subagent should only be called manually by the user.
+mode: subagent
+hidden: true
+---
+
+This agent has been deprecated. Use the tier selector architecture instead.
diff --git a/.opencode/agents/implementer-codex.md b/.opencode/agents/implementer-codex.md
index e69de29bb..ca9dff99b 100644
--- a/.opencode/agents/implementer-codex.md
+++ b/.opencode/agents/implementer-codex.md
@@ -0,0 +1,7 @@
+---
+description: This subagent should only be called manually by the user.
+mode: subagent
+hidden: true
+---
+
+This agent has been deprecated. Use the tier selector architecture instead.
diff --git a/.opencode/agents/implementer-haiku.md b/.opencode/agents/implementer-haiku.md
index e69de29bb..ca9dff99b 100644
--- a/.opencode/agents/implementer-haiku.md
+++ b/.opencode/agents/implementer-haiku.md
@@ -0,0 +1,7 @@
+---
+description: This subagent should only be called manually by the user.
+mode: subagent
+hidden: true
+---
+
+This agent has been deprecated. Use the tier selector architecture instead.
diff --git a/.opencode/agents/implementer-opus.md b/.opencode/agents/implementer-opus.md
index e69de29bb..ca9dff99b 100644
--- a/.opencode/agents/implementer-opus.md
+++ b/.opencode/agents/implementer-opus.md
@@ -0,0 +1,7 @@
+---
+description: This subagent should only be called manually by the user.
+mode: subagent
+hidden: true
+---
+
+This agent has been deprecated. Use the tier selector architecture instead.
diff --git a/.opencode/agents/implementer-sonnet.md b/.opencode/agents/implementer-sonnet.md
index e69de29bb..ca9dff99b 100644
--- a/.opencode/agents/implementer-sonnet.md
+++ b/.opencode/agents/implementer-sonnet.md
@@ -0,0 +1,7 @@
+---
+description: This subagent should only be called manually by the user.
+mode: subagent
+hidden: true
+---
+
+This agent has been deprecated. Use the tier selector architecture instead.
diff --git a/.opencode/agents/quality-gate-escalator.md b/.opencode/agents/quality-gate-escalator.md
index e69de29bb..ca9dff99b 100644
--- a/.opencode/agents/quality-gate-escalator.md
+++ b/.opencode/agents/quality-gate-escalator.md
@@ -0,0 +1,7 @@
+---
+description: This subagent should only be called manually by the user.
+mode: subagent
+hidden: true
+---
+
+This agent has been deprecated. Use the tier selector architecture instead.
diff --git a/.opencode/agents/robot-tester-codex.md b/.opencode/agents/robot-tester-codex.md
index e69de29bb..ca9dff99b 100644
--- a/.opencode/agents/robot-tester-codex.md
+++ b/.opencode/agents/robot-tester-codex.md
@@ -0,0 +1,7 @@
+---
+description: This subagent should only be called manually by the user.
+mode: subagent
+hidden: true
+---
+
+This agent has been deprecated. Use the tier selector architecture instead.
diff --git a/.opencode/agents/robot-tester-haiku.md b/.opencode/agents/robot-tester-haiku.md
index e69de29bb..ca9dff99b 100644
--- a/.opencode/agents/robot-tester-haiku.md
+++ b/.opencode/agents/robot-tester-haiku.md
@@ -0,0 +1,7 @@
+---
+description: This subagent should only be called manually by the user.
+mode: subagent
+hidden: true
+---
+
+This agent has been deprecated. Use the tier selector architecture instead.
diff --git a/.opencode/agents/robot-tester-opus.md b/.opencode/agents/robot-tester-opus.md
index e69de29bb..ca9dff99b 100644
--- a/.opencode/agents/robot-tester-opus.md
+++ b/.opencode/agents/robot-tester-opus.md
@@ -0,0 +1,7 @@
+---
+description: This subagent should only be called manually by the user.
+mode: subagent
+hidden: true
+---
+
+This agent has been deprecated. Use the tier selector architecture instead.
diff --git a/.opencode/agents/robot-tester-sonnet.md b/.opencode/agents/robot-tester-sonnet.md
index e69de29bb..ca9dff99b 100644
--- a/.opencode/agents/robot-tester-sonnet.md
+++ b/.opencode/agents/robot-tester-sonnet.md
@@ -0,0 +1,7 @@
+---
+description: This subagent should only be called manually by the user.
+mode: subagent
+hidden: true
+---
+
+This agent has been deprecated. Use the tier selector architecture instead.
diff --git a/.opencode/agents/subtask-loop-v2.md b/.opencode/agents/subtask-loop-v2.md
index e69de29bb..ca9dff99b 100644
--- a/.opencode/agents/subtask-loop-v2.md
+++ b/.opencode/agents/subtask-loop-v2.md
@@ -0,0 +1,7 @@
+---
+description: This subagent should only be called manually by the user.
+mode: subagent
+hidden: true
+---
+
+This agent has been deprecated. Use the tier selector architecture instead.