references/correction.md

Correction phase (put the fixes in place, by priority)

Fix without breaking or inventing anything. Doctrine (native HTML first, smallest possible change, no regressions) applied in priority order.

Processing order

1. 🔴 Blocking first, then 🟠 major, then 🟡 minor — the order of the prd backlog and the report. On a large repo, handle the shared templates first (layouts, design system): a fix there covers the whole site.
2. Three classes of fix (fix):
   • auto — deterministic codemods (positive tabindex, redundant ARIA, blocked zoom); safe to apply unsupervised.
   • placeholder — inserts a valid attribute with a TODO (alt/lang/title/aria-label) that you replace with a real, in-context value.
   • proposal — judgment only; the engine never invents content (alt text, link purpose, table structure) — the AI agent writes it and adjudicates the criterion (verify --manual, gated).
3. Conforming / non-conforming examples: for each pattern, start from the smallest change that makes the rendered HTML conforming (not just the source). If a library component does not instantiate correctly (e.g. an icon-only DSFR button with no title), fix at the usage site and re-verify on the render.

Commands

node scripts/ultra11y.mjs fix "src/**/*.html"            # dry-run: proposed diff
node scripts/ultra11y.mjs fix "src/**/*.html" --write     # apply (auto+placeholder)
node scripts/ultra11y.mjs fix "src/**/*.tsx"  --write     # real JSX: jsxSafe codemods only
node scripts/ultra11y.mjs fix "src/**" --write --iterate   # re-audit + re-apply to a fixpoint
node scripts/ultra11y.mjs fix "src/**" --only img-alt-missing,positive-tabindex
node scripts/ultra11y.mjs prd  --in audits/audit-latest.json   # prioritized backlog of remaining fixes

• Anti-regression gate: --write applies only if a re-audit proves no new non-conformity is introduced (including no new finding type). An invalid placeholder is thus blocked.
• JSX/TSX: fix --write applies only the safe codemods (remove ARIA, insert valid React attributes); it never rewrites an attribute name (no tabIndex={5} → tabindex="0"). The rest stays a proposal.
• After fixing, loop: re-audit, re-judge the proposals, until check/verify are green again (see the SKILL's "loop" section).