Sem A11Y.md
<div onClick={() => navigate('/checkout')}>
Finish purchase
</div>Com A11Y.md
<button onClick={() => navigate('/checkout')}>
Finish purchase
</button>A11Y.md — Apoiado pelo Claude for Open Source Program, da Anthropic.
Acessibilidade antes de qualquer prompt
Um arquivo que ensina a IA que você usa — Cursor, Claude, Copilot — a construir interfaces acessíveis desde a primeira linha, seguindo o padrão internacional WCAG 2.2. Nada para instalar: uma frase no lugar certo e pronto.
[Focado no humano][Pronto para IA][Certificável]
Ao desenvolver o frontend, siga estritamente as regras de acessibilidade do arquivo https://raw.githubusercontent.com/fecarrico/A11Y.md/main/docs/pt-BR/A11Y.md
Não programa? Cole o link do GitHub no Lovable, no v0 ou no Figma Make — funciona igual.
- Claude for Open Source
- Smashing Magazine
- WCAG 2.2 AA
- Licença MIT
O PROBLEMA
Estamos escalando exclusão mais rápido do que nunca
De um lado, leis e certificações — necessárias, mas lentas. Do outro, a IA criando telas em velocidade absurda. Os números mostram quem está ganhando:
95,9%dos sites da web têm falhas de acessibilidade detectáveis — e o número piorou pela primeira vez em seis anos.
~30%das barreiras reais é o que os testes automáticos conseguem encontrar — até o governo dos EUA admitiu ter confiado demais em correções por IA.
Inacessível por padrãoé como nascem as interfaces geradas por IA.
10 de 10das jornadas com o A11Y.md documentaram o próprio processo sem ninguém pedir — zero sem ele.
NA PRÁTICA
O que muda no código
O erro mais comum em telas geradas por IA: um botão que parece botão, mas não é. Para quem navega por teclado ou usa leitor de tela, ele simplesmente não existe.
Os exemplos aqui são em React, mas a regra vale para qualquer tecnologia: a IA adapta o padrão para Vue, Angular, Svelte ou Solid — e, em aplicativos nativos (iOS, Android, React Native, Flutter), traduz a ideia em vez de copiar o código. A parte web já está madura; a nativa está em construção.
A PROVA
Esta página segue o próprio padrão
Esta página foi construída seguindo o próprio A11Y.md, no perfil mais exigente (Shield). Passou em todos os testes automáticos: zero violações, navegação completa por teclado, zoom de 200% sem quebrar nada. Mas máquina não fecha o ciclo: a IA erra, e o próprio A11Y.md exige que uma pessoa valide com leitor de tela antes de declarar a página aprovada. O relatório mostra o que passou, o que falta e por quê.
QUICK START
Menos de dois minutos
Ferramentas de IA leem arquivos como CLAUDE.md e AGENTS.md automaticamente. Acessibilidade ainda não tem um arquivo canônico assim — a sua regra cria essa camada. E você não copia nada: a IA lê o A11Y.md direto da fonte, sempre na versão mais atual.
- 01
Aponte a IA para o padrão
Adicione uma pequena regra às instruções da ferramenta de IA que você usa para criar — Cursor, Claude Code, Copilot ou similar.
- 02
Defina o perfil
Escolha o nível de exigência: Shield (o máximo), Standard (o padrão) ou Launchpad (para protótipos). Se você não escolher, a IA pergunta antes de começar.
- 03
Use como revisor
Peça para a IA revisar o que já existe — código pronto ou telas do Figma — usando o A11Y.md como régua.
.cursorrules
> Adicione ao arquivo de regras do seu agente:"Ao desenvolver o frontend, siga estritamenteas regras de acessibilidade do arquivohttps://raw.githubusercontent.com/fecarrico/A11Y.md/main/docs/pt-BR/A11Y.md"✔ Contexto de acessibilidade carregado✔ WCAG 2.2 AA — perfil Standard ativo✔ Guias de referência carregados sob demandaSeu ambiente agora sabe que acessibilidade é requisito básico.Um pedido pronto para designer, QA e produto
O A11Y.md serve a quem não escreve código. Copie o pedido do seu papel e cole na IA que você já usa.
Designer
Cole o link do padrão no Lovable, no v0 ou no Figma Make e a IA desenha já dentro das regras.
Cole na IA
Antes de propor este componente ou tela, siga as regras de acessibilidade do arquivo https://raw.githubusercontent.com/fecarrico/A11Y.md/main/docs/pt-BR/A11Y.md. Diga qual perfil de conformidade está usando e o que você não conseguiu verificar.
QA e testes
Cada guia do padrão diz o que deve acontecer por teclado e o que o leitor de tela precisa anunciar. Isso vira roteiro de teste.
Cole na IA
Consulte o guia deste componente no https://raw.githubusercontent.com/fecarrico/A11Y.md/main/docs/pt-BR/A11Y.md e liste, cenário a cenário, o que deve acontecer por teclado e o que o leitor de tela precisa anunciar, no computador e no celular. Separe o que você já verificou no código do que precisa de uma pessoa.
Produto
Os critérios de aceite de acessibilidade saem do padrão, não da memória de quem escreve a tarefa.
Cole na IA
Leia o A11Y.md em https://raw.githubusercontent.com/fecarrico/A11Y.md/main/docs/pt-BR/A11Y.md. A partir dele, escreva os critérios de aceite de acessibilidade desta entrega: o que é obrigatório no perfil Standard, o que vira exceção registrada e quem precisa validar com leitor de tela.
COMO FUNCIONA
O que o A11Y.md faz quando é chamado
O arquivo principal é leve de propósito: fica sempre presente na memória da IA, e o material de apoio só entra quando é necessário.
A11Y.md é carregado
É um site ou um aplicativo? Que componente vamos construir?
A IA responde essas perguntas antes de tudo e busca só o guia certo para aquele caso. Se for um aplicativo, ela adapta a orientação para a plataforma em vez de copiar soluções feitas para a web
references/Gera a interface
O projeto já tem esse componente? Essa escolha já foi feita antes?
Em vez de criar tudo do zero, a IA reaproveita o que o projeto já tem. E cada decisão tomada fica anotada, para que os próximos componentes sigam o mesmo padrão
A11Y-DECISIONS.mdFase de validação
Passa nos critérios do nível escolhido?
Cada exigência é conferida contra a norma internacional, critério por critério. Quando o A11Y.md pede mais do que a norma, isso aparece identificado como regra da casa
WCAG 2.2Gera o relatório
Encontrou algum problema? Falta teste humano?
O que não foi resolvido vira um registro formal de pendência. E o que só uma pessoa pode validar — como o teste com leitor de tela — fica apontado no relatório: a IA é proibida de fingir esse teste
EXCEPTIONS.md
REPERCUSSÃO
O que estão dizendo
“Felipe A. Carriço criou o A11Y.md, um sistema de contexto para construir software acessível por padrão.”
Apoio institucional
OZeWAI
Organização australiana de acessibilidade e inclusão na web
A OZeWAI listou o A11Y.md na sua Weekly Reading List de 27 de julho de 2026.
Weekly Reading List · 27 de julho de 2026 (abre em nova aba)“A IA não conserta sistemas inacessíveis. Ela escala o que encontra.”
“O produto é isso: ligar a acessibilidade ao processo de construção de modo que ela mude o que é gerado.”
Fontes
O que alimenta o padrão
Cada regra do A11Y.md vem de um documento que existe fora dele. Esta é a lista do que foi consultado e usado para construir a versão 2.4.0. São 35 documentos, com país e versão, para quem quiser conferir na fonte.
Normas e diretrizes técnicas
Legislação
| Documento | País | Versão |
|---|---|---|
| Lei Brasileira de Inclusão da Pessoa com Deficiência (Lei 13.146/2015) (abre em nova aba) | Brasil | 2015 |
| Lei 10.436/2002 (reconhecimento da Libras) (abre em nova aba) | Brasil | 2002 |
| Decreto 5.626/2005 (regulamentação da Libras) (abre em nova aba) | Brasil | 2005 |
| European Accessibility Act (Directive (EU) 2019/882) (abre em nova aba) | União Europeia | 2019 · vigente desde 2025 |
| General Data Protection Regulation (Regulation (EU) 2016/679) (abre em nova aba) | União Europeia | 2016 |
| Americans with Disabilities Act (ADA) (abre em nova aba) | Estados Unidos | 1990 · regra web de 2024 |
| Section 508 of the Rehabilitation Act (abre em nova aba) | Estados Unidos | revisão de 2017 |
Avaliação e conformidade
| Documento | País | Versão |
|---|---|---|
| Website Accessibility Conformance Evaluation Methodology (WCAG-EM) 1.0 (abre em nova aba) | Internacional (W3C) | 1.0 · 2014 |
| WCAG-EM Report Tool (abre em nova aba) | Internacional (W3C) | documento vivo |
| Developing an Accessibility Statement (abre em nova aba) | Internacional (W3C) | documento vivo |
| Voluntary Product Accessibility Template (VPAT) (abre em nova aba) | Estados Unidos (ITI) | 2.5Rev · 2025 |
| axe-core (abre em nova aba) | Estados Unidos (Deque) | 4.13.0 · fixada no benchmark |
| WAVE Web Accessibility Evaluation Tool (abre em nova aba) | Estados Unidos (WebAIM) | documento vivo |
| AccessMonitor (abre em nova aba) | Portugal (AMA) | documento vivo |
| Lighthouse (abre em nova aba) | Estados Unidos (Google) | documento vivo |
Plataformas, bibliotecas e documentos de apoio
| Documento | País | Versão |
|---|---|---|
| Apple Human Interface Guidelines (abre em nova aba) | Estados Unidos (Apple) | documento vivo |
| Material Design 3 (abre em nova aba) | Estados Unidos (Google) | 3 |
| Apple Developer Documentation: UIKit and SwiftUI accessibility (abre em nova aba) | Estados Unidos (Apple) | documento vivo |
| Android Developers: accessibility semantics in Compose (abre em nova aba) | Estados Unidos (Google) | documento vivo |
| React Native documentation: Accessibility (abre em nova aba) | Estados Unidos (Meta) | documento vivo |
| Flutter API documentation: Semantics (abre em nova aba) | Estados Unidos (Google) | documento vivo |
| eBay MIND Patterns (abre em nova aba) | Estados Unidos (eBay) | documento vivo |
| Hand Talk: documentação do plugin de tradução para Libras (abre em nova aba) | Brasil | documento vivo |
| VLibras: suíte de tradução para Libras do governo federal (abre em nova aba) | Brasil | documento vivo |
| Nota de Repúdio 02/2025 à utilização de software de tradução automática (Febrapils) (abre em nova aba) | Brasil | maio de 2025 |
História
Cada regra tem uma história
Este padrão não evolui por roadmap; evolui por resposta. Um post-mortem de campo virou release, um teste independente virou anti-pattern, uma pergunta da comunidade virou regra. A linha do tempo mostra essa conversa inteira — da primeira estrela até hoje.
Conhecer a história do projetoBora construir juntos?
O A11Y.md não é apenas um arquivo; é um ponto de partida. É open source porque acessibilidade não pede permissão, pede colaboração.
Adote no seu projeto
Uma frase no seu ambiente e o padrão passa a valer dali em diante.
Guia de integração (abre em nova aba)Contribua
Melhore os guias, aponte erros — ou mande um exemplo que você resolveu.
Abrir a Wiki (abre em nova aba)Mande seus achados
Testou o método num projeto seu? Conta o que funcionou — e o que não.
Abrir uma issue (abre em nova aba)
“Acessibilidade não pode ser um selo no final do processo. Precisa ser a restrição no começo.”
Edição de design
Torne suas telas e componentes acessíveis antes do primeiro pixel com o DA11Y.md
O agente do Figma lê o DA11Y.md por link e aplica as mesmas regras e os mesmos números do A11Y.md enquanto a tela é desenhada. Ele também está na Comunidade do Figma, como skill.
Conhecer o DA11Y.md (abre em nova aba)Ao fundo, o hero do DA11Y.md desenhado em ASCII, com o logotipo dally.md.