tend-a11y

Tend A11y — the herald

Find the single highest-priority accessibility, UX, or copy-tone issue in this repo's markup, fix it minimally, verify, hand back the diff for review. One issue per run.

0. Load config

• Read .claude/tend/config.yaml. Use skills.a11y (off-limits globs, notes). This skill has no capability modules — skip module-gating entirely, there is no modules: gating step here.
• No config? Run at core tier: core SvelteKit + TS assumptions, conservative built-in off-limits (never touch lockfiles, CI, .env, config). Emit once: "run tend-onboard to sharpen." Continue.

1. Triage

MANDATORY READ references/scan-core.md.

• Establish the off-limits set: config's skills.a11y.off-limits plus the built-in rails (never touch lockfiles, CI config, .env, project config, or backend/API-route logic — this skill is presentation-only).
• Establish entry points: this repo's markup files — .svelte components, +page.svelte / +layout.svelte routes, or whatever template files the stack actually uses. Check skills.a11y.notes for a named component-library directory (e.g. src/lib/components/ui) — if one exists, its exports are the "use this instead of raw HTML" target list for Phase 2.
• Read 1–2 existing components before scanning to learn the repo's actual component-library and status/loading conventions — you need the real pattern in hand before you can call a deviation from it a violation.

Completion criterion: off-limits set known, component-library convention (if any) identified, entry-point globs identified.

2. Scan — priority order, stop at the first real hit

Ordered highest-value (most silent-to-users) first — stop at the first real, evidence-backed hit:

1. Raw interactive HTML where a component-library equivalent exists — a raw <button>/<a>/<input> alongside a Button/Link/Input export elsewhere in the repo.
2. Icon-only or icon-primary interactive elements missing an accessible name — no aria-label, no visually-hidden text, no title fallback.
3. <img> without alt — a missing attribute is the violation; an intentionally empty alt="" on a decorative image is not.
4. Form inputs without an associated label — no label for=, aria-label, or component-library label prop. Audit the rendered count, not just the template: inputs generated inside a loop ({#each} or equivalent) produce N anonymous controls at runtime.
5. role="button" (or a bare onclick on a non-interactive element) missing the paired keyboard handler — onkeydown for Enter + Space. Native <button> gets this for free; this only fires on the raw-element escape hatch.
6. Async success/error/loading feedback rendered as a plain, unannounced element — no role="alert"/role="status", no aria-live, and no existing component-library banner/toast primitive already used elsewhere in the repo.
7. A destructive action (delete/remove/reset) with no confirmation step before it takes effect.
8. Copy-tone violations, checked against the config-driven allow/deny list (skills.a11y.notes, or a project tone doc it points to). If no repo-specific list exists, fall back to generic defaults: an imperative softener like "Please" prefacing a validation/error instruction ("Please enter a name" vs. "Enter a name"), or a needless exclamation mark in routine confirmation/instructional copy. Scan both rendered markup text and string literals inside <script> blocks — copy assigned to a variable, passed to a toast/alert call, or set via .textContent/.innerText lives in script blocks, not just markup, and a markup-only grep will miss the real validation strings.