documentation_review: Add YAML frontmatter to agent definitions


Claude Code only registers a file in ~/.claude/agents as a dispatchable
subagent if it starts with YAML frontmatter carrying name and
description; both fields are mandatory. The agent definitions had none,
so following the documented setup and copying them into ~/.claude/agents
left them invisible to the Task tool. The agent-first workflow in
CLAUDE.md, and each agent's own instruction to dispatch it with
model: "opus", could therefore never be followed.

Add frontmatter to all eight agents. The description states when to
delegate, since that text is what the dispatching model matches against.
Set model: opus on the seven agents whose prose already requires Opus;
vale-qdoc-linter states no requirement and inherits the session model.

Names match the file basenames, which is what users type. No tools
restriction is declared, so the agents keep inheriting the full tool set
they use today.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Change-Id: Ie12f24006cc68fe6587b1509fea53c664081fd7b
Reviewed-by: Jerome Pasion <jerome.pasion@qt.io>
commita5f92d6985c15c5558e33da3a754b5b4cfd12809
parent7d4d8236b84f1e3a8015686c484a415d2e421399
authorNicholas Bennett <nicholas.bennett@qt.io>
committerNicholas Bennett <nicholas.bennett@qt.io>
commit timeMon, 24 Aug 2026 13:27:55 +0000