docs(council): target dedicated council agents by role

skills/council/scripts/council.sh

@@ -117,14 +117,48 @@
 # ─── SUBAGENT LABELING ────────────────────────────────────────────
 #
 # Personality mode:
-#   Labels: council-r{round}-{role}
-#   Examples: council-r1-pragmatist, council-r2-skeptic, council-referee
-#   Single-round: council-pragmatist, council-referee (no round prefix)
+#   Agent ids:
+#     council-pragmatist
+#     council-visionary
+#     council-skeptic
+#     council-referee
+#   Labels can still be council-r{round}-{role} for bookkeeping, but sessions should target
+#   the dedicated council agent ids above.
 #
 # D/P mode:
-#   Labels: council-r{round}-{group}-{role}
-#   Examples: council-r1-d-freethinker, council-r1-p-arbiter, council-meta
-#   Single-round: council-d-freethinker, council-p-arbiter, council-meta
+#   Agent ids:
+#     council-d-freethinker
+#     council-d-arbiter
+#     council-p-freethinker
+#     council-p-arbiter
+#     council-meta-arbiter
+#   Labels can still be council-r{round}-{group}-{role} for bookkeeping, but sessions should target
+#   the dedicated council agent ids above.
+#
+# ─── ROLE-AWARE MODEL TIERING ─────────────────────────────────────
+#
+# light:
+#   advisors/freethinkers/arbiters -> dedicated council role agents on litellm/gpt-5-mini
+#   referee/meta-arbiter           -> dedicated synthesis agents on openai-codex/gpt-5.4
+#
+# medium:
+#   advisors/freethinkers/arbiters -> dedicated council role agents on litellm/gpt-5-mini
+#   referee/meta-arbiter           -> dedicated synthesis agents on openai-codex/gpt-5.4
+#
+# heavy:
+#   preserve dedicated role agent ids; prefer strongest synthesis on referee/meta-arbiter.
+#   Only override advisor models upward when the task is genuinely high-stakes or unusually complex.
+#
+# Principle: mission-specific synthesis gets the stronger model first; broad advisor diversity stays cheap
+# unless the topic quality/risk clearly justifies escalation.
+#
+# Example sessions_spawn targeting:
+#   sessions_spawn(... agentId="council-pragmatist" ...)
+#   sessions_spawn(... agentId="council-referee" ...)
+#   sessions_spawn(... agentId="council-meta-arbiter" ...)
+#
+# Single-round labels may still look like council-pragmatist / council-meta for readability,
+# but the runtime target should be the dedicated council agent id.
 #
 # ─── WORD COUNT GUIDANCE ──────────────────────────────────────────
 #