diff --git a/agents/.agents/skills/codex-subagent-playbook/references/roles.md b/agents/.agents/skills/codex-subagent-playbook/references/roles.md
index e5e5bc9..f179269 100644
--- a/agents/.agents/skills/codex-subagent-playbook/references/roles.md
+++ b/agents/.agents/skills/codex-subagent-playbook/references/roles.md
@@ -22,8 +22,9 @@
 
 - **Управляемая стоимость.** Хост видит агентов из `~/.codex/agents` или
   `.codex/agents` и схема `spawn_agent` открывает `agent_type`, `model` и
-  `reasoning_effort`. Для TOML-роли передавай `agent_type`, а модель и
-  глубину бери из её файла. Для разового выбора передавай `model` и
+  `reasoning_effort` (про фактическое применение effort — кавеат в
+  [выборе уровня](#выбор-уровня)). Для TOML-роли передавай `agent_type`, а
+  модель и глубину бери из её файла. Для разового выбора передавай `model` и
   `reasoning_effort` без пользовательской роли с закреплённой моделью.
   Плейбук использует `fork_turns="none"` ради чистого контекста. Технически
   ограниченный fork числом тоже допускает переопределения; только полный