MaarkssDN/Birthub-360 / .agents/skills/accessibility
accessibility
VerifiedUse em todo componente interativo, formulário, modal, navegação ou mudança de layout. Cobre o débito de acessibilidade já mapeado neste projeto (jsx-a11y, axe-core) e os requisitos WCAG AA mínimos não-negociáveis.
Acessibilidade — Birth Hub 360º
Estado atual (não repita os problemas já resolvidos, nem ignore os que faltam)
Este projeto já tem tooling de acessibilidade real, não é greenfield:
eslint-plugin-jsx-a11yativo emeslint.config.mjs. Regras que bloqueiam o lint:react/no-unescaped-entities,jsx-a11y/heading-has-content(com exceção documentada emCard.tsxparaCardTitle). Regras rebaixadas awarn(débito conhecido, ~152 ocorrências):jsx-a11y/label-has-associated-control,click-events-have-key-events,no-static-element-interactions,no-noninteractive-element-interactions,no-autofocus,media-has-caption. Não aumente essas contagens de warning em código novo — todo<div onClick>novo precisa derole,tabIndexeonKeyDown/onKeyPressdesde o início; todo<input>novo precisa de<label>associado (viahtmlFor/idouaria-labelledby) desde o início.@axe-core/playwrightroda emtests/e2e/accessibility.spec.tscontra login, dashboard, Pipeline CRM e Configurações — falha em violaçõescritical/serious. Ao adicionar uma tela nova a um fluxo coberto por esse spec, ela herda a mesma verificação; considere adicionar umtest()novo se a tela for uma superfície principal.- Baseline global
:focus-visible { outline: 2px solid var(--brand); outline-offset: 2px }já existe emglobals.css— todo elemento interativo tem foco visível por padrão, mesmo sem estilo próprio. Componentes com anel de foco próprio (focus-visible:ring-*) continuam vencendo por especificidade — não remova isso ao estilizar um componente novo. @media (prefers-reduced-motion: reduce)global já cobre CSS/keyframes;MotionConfig reducedMotion="user"cobre Framer Motion.
Bug real já encontrado e corrigido — não reintroduza
Texto branco sobre --brand/--brand-2 puro (ex.: item ativo da Sidebar) dava só ~3.2:1
(Birth Hub 360) / ~3.9:1 (Birth Hub 360) de contraste — abaixo do mínimo AA de 4.5:1. Corrigido com o token
--color-brand-active (color-mix(in srgb, var(--brand) 75%, black)). Use
bg-brand-active/--color-brand-active sempre que precisar de texto branco sobre um fundo de cor
de marca sólida — não volte a usar --brand puro nesse cenário.
Acessibilidade executável — inspeção estática não é prova
Achado real do Piloto 002 (Kanban/CrmBoard, ver .Codex/PILOTS.md): o board já tinha
KeyboardSensor do @dnd-kit/core configurado — presente no código, parecendo "drag acessível
por teclado" numa leitura estática. Só rodando o gesto de verdade (Space → seta → Space, num
board de múltiplas colunas) o bug apareceu: sortableKeyboardCoordinates (a opção nativa do
dnd-kit) nunca conseguia sair da coluna vizinha, porque sua busca por distância comparava o card
contra todos os droppables (cada card individual + cada coluna inteira), e o droppable da
coluna (bem maior) sempre "ganhava". A correção real também exigiu entender closures: o
KeyboardSensor congela a função coordinateGetter no momento em que o Space ativa o drag e
reusa essa mesma closure pelo resto do gesto — um coordinateGetter que lia leads (state) direto
sempre via o valor de quando o drag começou, nunca o atualizado (nem trocar por uma ref sempre-atual
resolvia sozinho, porque reparentar o card no state também derrubava o foco real do DOM). Ver os
comentários em src/components/CrmBoard.tsx (columnKeyboardCoordinateGetter) para o relato
completo.
Regra: presença de um sensor/handler de teclado no código de uma biblioteca de terceiros não é prova de que o gesto funciona de ponta a ponta. Para qualquer interação de teclado nova ou tocada (drag, listas reordenáveis, comandos compostos), execute o gesto real (Playwright ou manual) antes de considerar acessível — não confie só na leitura de código nem na documentação da lib. Isso vale em dobro quando a lib gerencia estado internamente via closures ativadas uma única vez (comum em sensores/handlers de gesto) — teste explicitamente o comportamento após updates de state subsequentes, não só o primeiro passo do gesto.
Checklist mínimo para qualquer componente interativo novo
- Navegável via teclado: Tab alcança o elemento, Enter/Space ativa, Escape fecha (modais/ drawers/dropdowns), setas navegam onde o padrão ARIA pedir (menus, tabs, listboxes).
-
<div onClick>/<span onClick>temrole,tabIndex={0}e handler de teclado — ou, preferencialmente, é um<button>/<a>de verdade. - Todo
<input>/<select>/<textarea>tem<label>associado (htmlFor) ouaria-label/aria-labelledby. - Formulários com
react-hook-form/zodexpõem erro viaaria-describedbyapontando pro texto de erro, não só cor vermelha. - Contraste de texto ≥ 4.5:1 (normal) / 3:1 (grande) — checar especialmente texto sobre
bg-brand/cor sólida (usar--color-brand-activese for branco sobre marca). - Área com scroll próprio (padrão do Kanban
CrmBoard) temtabIndex={0}+aria-labelse for navegável só por scroll horizontal. - Imagem/ícone informativo tem
alt/aria-label; decorativo temaria-hidden="true". - A raiz da tela tem um landmark semântico (
<main>, não<div>) — achado real do axe-core no Piloto 001:WelcomeScreen.tsxusava<div>na raiz e disparavalandmark-one-main/regionem toda a página. - Estado de loading é anunciado (não só visual) —
aria-live/aria-busyonde aplicável. - Animação nova respeita
prefers-reduced-motion(herdado doMotionConfigraiz, salvo hooks customizados que checamuseReducedMotion()manualmente).
Como verificar
npm run lint— pega os erros bloqueantes dejsx-a11yimediatamente.npx playwright test tests/e2e/accessibility.spec.ts— rodaaxe-corenas telas principais já cobertas. Se a mudança tocar uma dessas telas, rode este spec antes de reportar concluído.- Ao adicionar uma superfície principal nova, considere adicionar um
test()a esse spec seguindo o padrão existente (signUp+assertNoBlockingViolations).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |