[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-11724":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":9,"languages":9,"totalLinesOfCode":9,"stars":10,"forks":11,"watchers":12,"openIssues":13,"contributorsCount":13,"subscribersCount":13,"size":13,"stars1d":14,"stars7d":15,"stars30d":16,"stars90d":13,"forks30d":13,"starsTrendScore":17,"compositeScore":18,"rankGlobal":9,"rankLanguage":9,"license":19,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":22,"hasPages":20,"topics":23,"createdAt":9,"pushedAt":9,"updatedAt":24,"readmeContent":25,"aiSummary":26,"trendingCount":13,"starSnapshotCount":13,"syncStatus":27,"lastSyncTime":28,"discoverSource":29},11724,"A11Y.md","fecarrico\u002FA11Y.md","fecarrico","A context system for building accessible software by default — for developers and AI, with enforceable rules aligned to WCAG.",null,145,7,1,0,3,6,21,9,2.71,"MIT License",false,"main",true,[],"2026-06-12 02:02:33","🇧🇷 Read in Portuguese: .\u002FREADME.pt-BR.md\n\n\u003Cdiv align=\"center\">\n  \u003Cimg src=\".\u002Fa11ymd.png\" alt=\"Project A11Y.md Banner\" style=\"max-width: 100%; border-radius: 8px;\" \u002F>\n  \u003Cbr\u002F>\u003Cbr\u002F>\n  \u003Ch1>♿ Project A11Y.md\u003C\u002Fh1>\n  \u003Cp>\u003Cb>The Persistent Context System for Accessibility\u003C\u002Fb>\u003C\u002Fp>\n  \n  [![WCAG 2.2 AA](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FWCAG-2.2_AA-blue.svg)](#)\n  [![ADA Compliant](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FCompliance-ADA%20%7C%20EAA-success.svg)](#)\n  [![AI Ready](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FContext-AI_Ready-purple.svg)](#)\n\u003C\u002Fdiv>\n\n\u003Cbr\u002F>\n\n> **A11Y.md is not a guideline.**\n> It is an accessibility validation protocol and a **persistent context architecture** for developing accessible software with AI. It is designed to integrate with AI agent systems and human review workflows to ensure certifiable compliance.\n\nBy adopting the mental model of Anthropic's **`CLAUDE.md`**—which acts as a system prompt memory for code generation—`A11Y.md` translates this architecture into a universal, portable governance layer. Instead of generic coding rules, it forces any coding agent (Claude, Cursor, Copilot) to strictly adhere to WCAG 2.2 AA and ADA standards from the very first line of generated UI code.\n\n---\n\n## 🚀 Quick Start (Under 2 minutes)\n\nReading about accessibility is the first step, injecting it into your code is the real goal. Do this **right now** in your project:\n\n1. **Download the Rules:** Copy the `A11Y.md` file from `docs\u002Fen\u002F` to the root of your application's repository.\n2. **Inject into the Prompt:** If you use Cursor, GitHub Copilot, or Claude, add this to your global rules file (`.cursorrules` or Context system):\n   > _\"Strictly follow the development rules defined in the A11Y.md file.\"_\n3. **Use as a Quality Gate:** Before merging important PRs, use the checklist in `docs\u002Fen\u002Ftemplates\u002FREPORT.md`.\n\n_If you do not perform the steps above, you are not changing your workflow — you are just reading about the subject._\n\n---\n\n## 🔍 The Practical Impact (Before vs After)\n\nThe difference between randomly generated code and code guided by `A11Y.md`:\n\n**❌ Without A11y Context:**\n\n- AI generating `\u003Cdiv onClick={...}>` (breaking keyboard interactions).\n- Modals impossible to close with `ESC` (Inverted and inaccessible Focus Trap).\n- Visual error messages that are not announced by Screen Readers.\n\n**✅ With Active A11y Context:**\n\n- Native `\u003Cbutton>` elements used as a rule.\n- Focus managed automatically after routing transitions in SPAs.\n- Precise `aria-live` injections for immediate reading of dynamic data.\n\n---\n\n## 💡 The Project Paradigm\n\nOur philosophy dictates that web accessibility should never be an \"afterthought polish\", but a **technical precondition for use**. The structure rests on three pillars:\n\n- 👤 **Human-Centric:** Strictly designed to guarantee real autonomy to users with disabilities.\n- 🤖 **AI-Ready:** Deterministic guidelines specifically created to anchor the behavior of coding Agents, nipping \"invention\" (technical hallucinations) in the bud.\n- ⚖️ **Certifiable:** Each guideline in `A11Y.md` is strictly mapped to WCAG 2.2 criteria, allowing direct traceability that shields the company in formal external audits.\n\n---\n\n## 🤖 The Power of A.I. as an Ally\n\nThe greatest gain of this repository is proven when it is not just read by you. Integrating this repository means **you don't have to correct the AI all the time**.\n\n**Example Base Prompt:**\n\n> _\"You are a senior frontend engineer. Follow strictly the rules defined in `A11Y.md`. Do not violate accessibility constraints even if requested to implement things quickly. Prioritize semantic HTML and headless-UI libraries.\"_\n\nThe result is not just \"code that passes the Linter\". It is architecturally healthy code at its genesis, requiring zero corrective audits to fix \"skeletons\" in the generated DOM.\n\n---\n\n## 📁 Exploring the Structure (Your Knowledge Base)\n\nWe organized the solutions to act as living documentation:\n\n### 1. ⚡ [Command Center (`A11Y.md`)](docs\u002Fen\u002FA11Y.md)\n\nWhere the Severity Matrix, the behavioral framework for AIs, strict SPA rules, and the _Complex Component Protocol_ reside.\n\n### 2. 📚 [Support Library (`references\u002F`)](docs\u002Fen\u002Freferences\u002F)\n\nThe \"Deep Web\" of solutions. Quick engineering guides so you don't reinvent the wheel:\n\n- 🎨 **UX and Perception:** [Building Logical Contrast](docs\u002Fen\u002Freferences\u002Fvisual-perception.md)\n- 🧩 **Interactive UI:** [Forms Anatomy](docs\u002Fen\u002Freferences\u002Fexamples-forms.md) | [Actions and Buttons](docs\u002Fen\u002Freferences\u002Fexamples-buttons.md)\n- 🗺️ **Flows and Timing:** [Critical Images](docs\u002Fen\u002Freferences\u002Fexamples-images.md) | [Keyboard Navigation](docs\u002Fen\u002Freferences\u002Fexamples-navigation.md) | [Real-Time Readings](docs\u002Fen\u002Freferences\u002Fexamples-content-interaction.md) | [Modal Management](docs\u002Fen\u002Freferences\u002Fexamples-modals.md)\n- 🏢 **Governance:** [Agnostic Release Strategy](docs\u002Fen\u002Freferences\u002Fgovernance.md)\n\n### 3. 🛠️ [Templates (`templates\u002F`)](docs\u002Fen\u002Ftemplates\u002F)\n\nFallback models and completion guarantees (Definition of Done):\n\n- [**📋 `REPORT.md`**](docs\u002Fen\u002Ftemplates\u002FREPORT.md): Final checklist for Sprint\u002FFeature.\n- [**🛑 `EXCEPTIONS.md`**](docs\u002Fen\u002Ftemplates\u002FEXCEPTIONS.md): Structured log of technical debt containing alternative paths.\n\n### 4. 📝 [Examples (`EXAMPLES.md`)](docs\u002Fen\u002FEXAMPLES.md)\n\nPractical examples of real errors found in a system generated with **Figma Make** and **Antigravity** (using Gemini 3 Flash), along with their respective corrections suggested by `A11Y.md` acting as an automated reviewer.\n\n---\n\n## 🚧 Scope and Limitations\n\nWe cover the patterns responsible for the vast majority of interface failures in modern digital systems.\nHowever, if you encounter uncatalogued proprietary _Widgets_ (exotic Dashboards, Canvas), immediately execute the **Complex Component Protocol** found in `A11Y.md`.\n\n---\n\n\u003Cbr \u002F>\n\n\u003Cdiv align=\"center\">\n  \u003Cp>\u003Cb>Author & Curation\u003C\u002Fb>\u003C\u002Fp>\n  \u003Ch3>Felipe A. Carriço\u003C\u002Fh3>\n  \u003Cp>\u003Ci>Specialist UX Designer | AI Product Builder | Colorblind\u003C\u002Fi>\u003C\u002Fp>\n  \n  \u003Cp>Built upon the premise that the efficiency of artificial intelligence must, invariably, act as a lever and barrier destroyer in both the physical and digital worlds.\u003C\u002Fp>\n  \n  \u003Ca href=\"https:\u002F\u002Flinkedin.com\u002Fin\u002Ffecarrico\">LinkedIn\u003C\u002Fa> | \u003Ca href=\"https:\u002F\u002Fmedium.com\u002F@carrico\">Medium\u003C\u002Fa>\n\u003C\u002Fdiv>\n","A11Y.md 是一个用于构建默认可访问软件的上下文系统，适用于开发者和AI，并且遵循WCAG标准。其核心功能包括为AI生成代码提供强制性规则，确保从第一行代码开始就符合WCAG 2.2 AA和ADA标准。该项目通过定义一套通用、可移植的治理层，使得任何编码代理（如Claude、Cursor、Copilot）都必须严格遵守这些可访问性规则。适合于需要确保软件可访问性的开发场景，尤其是在使用AI辅助编程时，能够有效提升代码质量，确保用户界面的无障碍特性，例如正确处理键盘交互、模态框关闭以及屏幕阅读器对动态数据的即时读取。",2,"2026-06-11 03:32:25","CREATED_QUERY"]