Revision control
++ # Agents
++
++ **Role:** agent definitions for the Qt Doc Agent Framework
++ (orchestrator + stage agents).
++
++ **See also:** [`../README.md`](../README.md) for the framework
++ overview · [`../CONTRIBUTING.md`](../CONTRIBUTING.md) for how to add a
++ new agent.
++
++ The framework runs as a four-layer chain: **harness → orchestrator →
++ agent → skill**. Files in this directory sit at the orchestrator and
++ agent layers.
++
++ - **[`orchestrator.md`](orchestrator.md)** — the dispatcher for the
++ whole framework. Picks the pipeline (A/B/C/D), gates pre-flight,
++ launches stage agents, verifies output. Has the `Agent` tool.
++ - **Stage agents** — one per pipeline stage. Self-sufficient: load
++ their own skills, fetch their own input, verify their own output.
++ No `Agent` tool by default (skill-loading only), unless marked as a
++ fan-out node below.
++
++ ## Pipeline mapping
++
++ | Pipeline | Stage | Agent | Fan-out? |
++ |----------|-------|-------|----------|
++ | (all) | Dispatch | orchestrator | yes |
++ | A | Review | qt-doc-reviewer | no |
++ | A | Warning fix | qdoc-warning-fixer | no |
++ | A | Impact analysis | doc-impact-analyzer | no |
++ | A | Module audit | doc-structure-auditor | no |
++ | A | Build | doc-builder | no |
++ | A | Vale lint | vale-qdoc-linter | no |
++ | B | Create / scaffold | doc-shaper | no |
++ | B | Fill and review stub | *(TBD)* | — |
++ | C | Bug triage to fix | *(TBD)* | — |
++ | D | Batch orchestrator | *(TBD)* | likely yes |
++ | (all) | Artifact testing | artifact-tester | no |
++
++ **Fan-out?** column: does the agent get the `Agent` tool so it can spawn
++ further subagents? Default is **no** — stage agents keep the chain
++ honest by loading skills rather than spawning agents. Mark **yes** only
++ for orchestrator-shaped agents (Pipeline D's batch orchestrator is the
++ obvious future candidate).
++
++ Every agent listed above lives (or will live) in this directory.
++ Additions land here as each pipeline stabilizes.
++
++ ## Conventions
++
++ - Definitions are Markdown files with YAML frontmatter pinned to
++ `claude-opus-5-5`.
++ - Every agent declares which skills it loads, when, and via which
++ loading pattern (see the seven patterns in
++ [`../doc/loading-patterns.md`](../doc/loading-patterns.md)).
++ - Every agent that outputs suggestions uses `skill-doc-diff` for the
++ Doc Team diff format.
++ - Only fan-out agents include `Agent` in their `tools:` frontmatter.
++ Stage agents omit it, so accidental nesting can't happen.