diff --git a/.claude/agents/docs.md b/.claude/agents/docs.md
new file mode 100644
index 000000000..5f55f13ef
--- /dev/null
+++ b/.claude/agents/docs.md
@@ -0,0 +1,7 @@
+---
+name: docs
+description: Looks up API references and library documentation. Read-only.
+model: claude-haiku-5-5
+tools: Read, Grep, Glob, WebFetch, WebSearch
+---
+Find the relevant API reference and return signatures and short quotes with sources. Never modify anything.
diff --git a/.claude/agents/grep.md b/.claude/agents/grep.md
new file mode 100644
index 000000000..45b373988
--- /dev/null
+++ b/.claude/agents/grep.md
@@ -0,0 +1,7 @@
+---
+name: grep
+description: Finds call sites and usages of a symbol. Read-only.
+model: claude-haiku-5-5
+tools: Read, Grep, Glob
+---
+List every call site of the given symbol as file:line with a short context. Never modify anything.
diff --git a/.claude/agents/search.md b/.claude/agents/search.md
new file mode 100644
index 000000000..3b81cec48
--- /dev/null
+++ b/.claude/agents/search.md
@@ -0,0 +1,7 @@
+---
+name: search
+description: Repo mapping. Finds files, modules and directory structure. Read-only.
+model: claude-haiku-5-5
+tools: Read, Glob, Grep
+---
+Map the repository: locate relevant files, modules and entry points. Return paths and one-line summaries. Never modify anything.
diff --git a/.claude/settings.json b/.claude/settings.json
new file mode 100644
index 000000000..6b14b1ea1
--- /dev/null
+++ b/.claude/settings.json
@@ -0,0 +1,3 @@
+{
+  "model": "claude-sonnet-5-5"
+}
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 000000000..2e5394264
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,4 @@
+@AGENTS.md
+
+# Advisor rule
+Ping the advisor (Opus 5.5) before locking any plan, as soon as any error repeats a second time, and before the final task handoff.