---
name: brief
description: Generate a compiled decision brief from the current sprint's claims.
tools:
- mcp__wheat__wheat_compile
- mcp__wheat__wheat_status
- mcp__mill__mill_convert
- mcp__mill__mill_formats
- mcp__mill__mill_preview
- Write
- Read
---
# /brief -- Generate a decision brief
The user wants a compiled output document from the current sprint.
## Arguments
$ARGUMENTS
Optional: output format (pdf, html, md). Default: html.
## Instructions
1. **Run `wheat_compile`** to ensure compilation is current and there are no blocking conflicts.
- If compilation fails due to unresolved conflicts, stop and suggest `/resolve`.
2. **Check sprint readiness** via `wheat_status`:
- Minimum 5 active claims to generate a meaningful brief
- At least 2 topics covered
- Warn if all claims are the same type (type monoculture)
3. **Read `compilation.json`** -- this is the source of truth, never read claims.json directly for output.
4. **Read the template** at `${CLAUDE_PLUGIN_ROOT}/skills/_templates/sidebar-brief.html` for the canonical accessible HTML structure. All generated HTML MUST follow this template exactly. Note: the path uses `${CLAUDE_PLUGIN_ROOT}` because the template lives in the Grainulator plugin directory, not the user's repo.
5. **Generate the brief** using `mill_convert`:
- Format: user-requested or default to HTML
- Structure: Executive summary, key findings by topic, risks and mitigations, recommendations, evidence appendix
- Include claim IDs as references throughout
6. **WCAG compliance checklist** -- verify the generated HTML includes all of these:
- [ ] `Skip to content` as first child of ``
- [ ] `` wrapping all content
- [ ] `