Brief

---
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** -- first read and apply every item from
   `${CLAUDE_PLUGIN_ROOT}/skills/_templates/wcag-shared.md`, then verify
   these brief-specific items:
   - [ ] `<nav aria-label="Table of contents">` wrapping sidebar links
   - [ ] `aria-current="page"` on active sidebar link (JS IntersectionObserver updates this)
   - [ ] Heading hierarchy: `<h1>` page title, `<h2>` sections, `<h3>` subsections -- never skip levels
   - [ ] All `<table>` elements have `<caption>` and `<th scope="col|row">`
   - [ ] Mobile sidebar uses `<details><summary>` disclosure, not `display: none`
   - [ ] Tags include text prefix (e.g., "Tested: verified"), never color alone

7. **Write output** to `output/brief.<ext>` in the sprint directory.

8. **Print summary**:

   ```
   Brief generated: output/brief.<ext>
   Claims: <count> active, <count> topics
   Strongest evidence: <tier>

   Next steps:
     /present            -- turn this into a slide deck
     /blind-spot         -- check for gaps before sharing
     /status             -- review the full sprint dashboard
   ```