# Plan: fold the editorial brief redesign into the generator; rename quick-start -> brief

## Why
The one-page brief was prototyped and refined by hand with the pilot into a refined
editorial layout (white, boxed data strips, ASU maroon eyebrow labels, Palatino numerals,
no cream card fills). It also gained a Course-at-a-Glance cohort-stats band (enrollment,
sections, success/DEW, course evaluation) sourced from the program dataset. Fold that design
and the new `brief` schema into `scripts/assurance_brief_html.py` so every course's brief
renders this way. Rename the deliverable from "quick-start" to "brief" throughout (the three
assurance deliverables are brief / report / playbook).

## A. Generator (`scripts/assurance_brief_html.py`)
Port the final editorial CSS + structure. New `brief` schema (all fields optional; a section
skips when absent):
- `period_lines` [str] -> masthead dateline
- `glance` [{value,label,denom?,note?}] -> Course at a Glance stat band (note renders green benchmark)
- `about` str -> plain "COM 100 is ..." paragraph (subject + CLOs merged, de-jargoned)
- `how_graded` str -> grading-structure line; renderer appends the "following assessment items:" lead-in when graded_items present
- `graded_items` [{count,label,weight_pct}] -> Graded Items stat band
- `working`/`exposed` [str] -> two boxed columns (green/maroon dots)
- `barrier` str -> feasibility constraint, rendered as "The Constraint"
- `directions` [{lead,text}] -> Improvement Opportunities (numbered)

Every field HTML-escaped. Title renders "<course>: Assessment Brief". WCAG AA fix: muted
label color `#736c60` (5.2:1), not the old `#8f877a` (3.55:1). Print-perfect US Letter.

## B. Rename quick-start -> brief
Generator docstrings, `<title>`, CLI description; the test docstring + title assertion.
SKILL.md already lists brief/report/playbook; update the brief-fields block to the new schema
and document the cohort-stats band (modality-filtered, DEW/success/eval as neutral context;
student evaluations are a 1-5 perception metric with known bias, presented with a benchmark).

## C. Tests (`tests/test_assurance_brief_html.py`)
Rewrite for the new schema/output: title says "Assessment Brief" (not quick-start); glance
band (denom + green note); graded-items band; boxed cols; section order; missing-field skip;
XSS escaping across every field; the AA muted color; editorial markers (no gold ::before ticks).

## Out of scope
- No change to the audit engine, tier, coverage, or the report/playbook renderers.
- The cohort-stats loader (reading the program xlsx by course + modality) is a separate follow-up;
  for now `glance` values are authored into the narrative.

## Verify
- Full `pytest tests/ -q` green on a clean checkout.
- Generator reproduces the approved COM 100 editorial brief at one Letter page.
- Read the diff by hand before merge. Coder != reviewer.
