{"id":51286603,"url":"https://github.com/dogfood-lab/interface-audits","last_synced_at":"2026-06-30T06:03:14.994Z","repository":{"id":357508968,"uuid":"1237249865","full_name":"dogfood-lab/interface-audits","owner":"dogfood-lab","description":"Proof-backed audits for human-facing product surfaces.","archived":false,"fork":false,"pushed_at":"2026-06-16T01:21:27.000Z","size":2814,"stargazers_count":0,"open_issues_count":5,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-16T03:14:26.221Z","etag":null,"topics":["accessibility","audit","cognitive-load","dogfood-lab","interface-design","load-displacement","ux"],"latest_commit_sha":null,"homepage":"https://dogfood-lab.github.io/interface-audits/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dogfood-lab.png","metadata":{"files":{"readme":"README.es.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":"audits/cognitive-load/CHANGELOG.md","citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-13T02:33:44.000Z","updated_at":"2026-06-16T01:21:29.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/dogfood-lab/interface-audits","commit_stats":null,"previous_names":["dogfood-lab/interface-audits"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/dogfood-lab/interface-audits","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dogfood-lab%2Finterface-audits","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dogfood-lab%2Finterface-audits/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dogfood-lab%2Finterface-audits/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dogfood-lab%2Finterface-audits/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dogfood-lab","download_url":"https://codeload.github.com/dogfood-lab/interface-audits/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dogfood-lab%2Finterface-audits/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34954284,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-30T02:00:05.919Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["accessibility","audit","cognitive-load","dogfood-lab","interface-design","load-displacement","ux"],"created_at":"2026-06-30T06:03:12.075Z","updated_at":"2026-06-30T06:03:14.988Z","avatar_url":"https://github.com/dogfood-lab.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"README.ja.md\"\u003e日本語\u003c/a\u003e | \u003ca href=\"README.zh.md\"\u003e中文\u003c/a\u003e | \u003ca href=\"README.md\"\u003eEnglish\u003c/a\u003e | \u003ca href=\"README.fr.md\"\u003eFrançais\u003c/a\u003e | \u003ca href=\"README.hi.md\"\u003eहिन्दी\u003c/a\u003e | \u003ca href=\"README.it.md\"\u003eItaliano\u003c/a\u003e | \u003ca href=\"README.pt-BR.md\"\u003ePortuguês (BR)\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./.brand/readme.png\" alt=\"interface-audits — Reduce the Burden. Improve the Experience.\" width=\"400\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/dogfood-lab/interface-audits/actions/workflows/verify.yml\"\u003e\u003cimg src=\"https://github.com/dogfood-lab/interface-audits/actions/workflows/verify.yml/badge.svg\" alt=\"verify\"\u003e\u003c/a\u003e\n  \u003ca href=\"./LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-MIT-blue\" alt=\"MIT License\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://dogfood-lab.github.io/interface-audits/\"\u003e\u003cimg src=\"https://img.shields.io/badge/handbook-live-2da44e?logo=github\" alt=\"Handbook\"\u003e\u003c/a\u003e\n  \u003ca href=\"./SHIP_GATE.md\"\u003e\u003cimg src=\"https://img.shields.io/badge/shipcheck-passed-2da44e\" alt=\"Shipcheck passed\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\u003cem\u003eProof-backed audits for human-facing product surfaces.\u003c/em\u003e\u003c/p\u003e\n\n---\n\n## De qué se trata\n\n`interface-audits` es una biblioteca de rúbricas de auditoría y las herramientas ejecutables que las implementan. Cada auditoría detecta una clase específica de fallos en la interfaz de usuario que los analizadores de accesibilidad genéricos no detectan. Los analizadores detectan las violaciones de WCAG; estas auditorías detectan las interfaces que **superan las pruebas de los analizadores, pero que aún así dificultan la tarea a los usuarios**.\n\nLa primera auditoría de esta biblioteca es **Carga cognitiva**, que detecta la redistribución de la carga: interfaces que trasladan la carga a la memoria, la búsqueda, la confianza, la verificación, la navegación, la configuración, la recuperación de la fuente, la decodificación visual, el tiempo, la recuperación/deshacer o la pérdida de funciones.\n\nCada auditoría incluye cuatro elementos:\n\n1. **Rúbrica**: doctrina, secciones, reglas de gravedad ([`audits/cognitive-load/RUBRIC.md`](audits/cognitive-load/RUBRIC.md))\n2. **Herramienta**: contrato de invocación y procedimiento ([`audits/cognitive-load/skill/SKILL.md`](audits/cognitive-load/skill/SKILL.md))\n3. **Esquema**: esquema JSON para los resultados y las hojas de puntuación ([`shared/schemas/`](shared/schemas/))\n4. **Evidencia**: al menos una prueba de estrés o ejecución de prueba completa ([`audits/cognitive-load/evidence/`](audits/cognitive-load/evidence/))\n\nSin evidencia, no hay auditoría oficial. Consulte [`shared/audit-lifecycle.md`](shared/audit-lifecycle.md) para ver el diagrama de estados y [`ROADMAP.md`](ROADMAP.md) para ver lo que está por venir.\n\n## Instalación\n\nLa mayoría de los usuarios no \"instalan\" este repositorio; simplemente lo leen. Las auditorías son rúbricas y herramientas en formato Markdown que son interpretadas por [Claude](https://claude.ai) u otro motor de IA compatible con las herramientas MCP adecuadas (navegación del navegador, captura de pantalla, lectura del DOM).\n\nPara los mantenedores que deseen ejecutar las herramientas de verificación locales (validación de esquemas, comprobación de enlaces, auditoría de envío):\n\n```bash\ngit clone https://github.com/dogfood-lab/interface-audits.git\ncd interface-audits\nnpm install        # installs ajv, ajv-formats, glob (dev-only)\nnpm run verify     # runs schema + link + shipcheck checks\n```\n\n**Requisitos:** Node 20+ para las herramientas de verificación. Las propias auditorías son independientes de la plataforma y están en formato Markdown.\n\n## Uso\n\n### Ejecución de una auditoría\n\nInvocación a través de Claude (o un motor compatible):\n\n\u003e Ejecutar la auditoría de carga cognitiva en `\u003ctarget-url-or-surface\u003e`\n\nConsulte [`audits/cognitive-load/skill/SKILL.md`](audits/cognitive-load/skill/SKILL.md) para obtener la lista completa de activadores, entradas, salidas y procedimientos.\n\n### Lectura de auditorías existentes\n\nLas ejecuciones de auditorías anteriores se encuentran en `audits/\u003cname\u003e/evidence/\u003crun-id\u003e/` y consisten en tres archivos:\n\n- `\u003caudit\u003e-findings.md`: resultados completos en formato de rúbrica\n- `\u003caudit\u003e-scorecard.json`: resultados por sección (superado/advertencia/fallo) + resumen\n- `remediation-priority-list.md`: resultados ordenados por gravedad × impacto\n\nLas auditorías actuales y sus registros de evidencia se encuentran en la tabla [Auditorías actuales](#current-audits) que se muestra a continuación.\n\n### Creación de una nueva auditoría\n\nUna nueva auditoría pasa por cinco estados del ciclo de vida: Borrador → Probada → Congelada → Probada en producción → Revisada. Consulte [`shared/audit-lifecycle.md`](shared/audit-lifecycle.md) para ver el diagrama de estados, [`shared/pressure-test-protocol.md`](shared/pressure-test-protocol.md) para ver el procedimiento y la auditoría de carga cognitiva en `audits/cognitive-load/` como una implementación de referencia.\n\n## Superficie de amenaza\n\nCuando se invoca una herramienta de auditoría, el motor (Claude con las herramientas MCP adecuadas) realiza operaciones en el objetivo proporcionado por el usuario:\n\n- **Salida de red**: solo a la URL de destino que especificó el usuario. Las herramientas no llaman a otros servicios.\n- **Captura del DOM y de la captura de pantalla**: la herramienta puede leer el DOM de la página, tomar capturas de pantalla e inspeccionar las clases CSS responsivas. El contenido capturado puede incluir cualquier cosa visible en la sesión autenticada del usuario en la URL de destino, incluidos los nombres, el cuerpo de los mensajes y el estado de la cuenta.\n- **Escritura de archivos locales**: los archivos de evidencia se escriben en `audits/\u003cname\u003e/evidence/\u003crun-id\u003e/` dentro del árbol de trabajo del repositorio. Las herramientas no escriben fuera de este ámbito.\n- **No hay transmisión de evidencia saliente**: los archivos de evidencia permanecen en el disco local a menos que el usuario los confirme y los envíe explícitamente.\n- **No hay telemetría, no hay gestión de secretos**: este repositorio no recopila datos analíticos ni lee credenciales.\n\nAntes de confirmar los archivos de evidencia en un repositorio público, el usuario es responsable de revisar lo que se ha capturado. Consulte [`SECURITY.md`](SECURITY.md) para obtener el modelo de amenazas completo, la política de informes de vulnerabilidades y el alcance.\n\n## Auditorías actuales\n\n| Auditoría | Estado | Detecta | Evidencia |\n|---|---|---|---|\n| [cognitive-load](audits/cognitive-load/) | Congelada v0.2 + Probada una vez en producción | Redistribución de la carga, complejidad oculta, carga de confianza en la IA, fallo de cambio de estado | PT0 (claude.ai), PT1 (GitHub), PT2-doc-fallback (Outlook), Dogfood-1 (manual de investigación) |\n| [low-vision](audits/low-vision/) | Probada v0.1.0 | Acceso visual en condiciones de densidad real (zoom/reflujo, contraste en fotos y gráficos, enfoque en temas personalizados, orientación espacial) | PT0 (documentación de MDN ARIA): 10 resultados, 2C/4H, se detectaron 4 de 4 patrones de fallo graves |\n| [screen-reader-task](audits/screen-reader-task/) | Probada v0.1.0 | Continuidad y finalización de las tareas a través de un lector de pantalla: no solo la validez de ARIA | PT0 (react.dev/learn): 13 resultados, 2C/5H, se detectaron 3 de 4 patrones de fallo graves |\n| [color-dependence](audits/color-dependence/) | Probada v0.1.0 | Significado transmitido únicamente por el color, incluido el límite de contraste-superado/tono-fallido | PT0 (Microsoft/vscode GitHub Actions): 10 resultados, 1C/4H, se detectaron 3 de 5 patrones de fallo graves |\n| [motor-access](audits/motor-access/) | Probada v0.1.0 | Coste de interacción para usuarios con movilidad reducida (ruta de teclado, tamaño del objetivo, dependencia del arrastre, tiempo de espera, deshacer) | PT0 (sistema de diseño de GOV.UK, patrón de varios pasos): 8 resultados + 12 observaciones positivas, 0C/2H |\n| [ai-trust-surface](audits/ai-trust-surface/) | Probada v0.1.0 | Confianza impuesta, comportamiento de la IA opaco, sin posibilidad de recuperación de los errores de la IA, sin trazabilidad | PT0 (Bing SSR + documentación de confianza en la IA de primera parte) — 9 hallazgos (5H/4M), 4 observados, la sección 7 superó una prueba reproducible |\n| [motion-sensitivity](audits/motion-sensitivity/) | Probada v0.1.0 | Desencadenantes vestibulares, respeto por la animación, prefiere movimiento reducido, umbrales para destellos/convulsiones | PT0 (linear.app) — 3 hallazgos (1H/2L) + 4 observaciones positivas, 0C |\n\n## Familia de auditorías\n\nCada auditoría debe declarar *¿qué carga detecta esta auditoría que los analizadores genéricos no detectan?* Para la carga cognitiva, la respuesta es la redistribución de la carga.\n\n### Auditorías futuras (aún no creadas)\n\nLas siete auditorías especificadas actualmente ya están en el repositorio y son **\"Sometidas a pruebas de estrés o mejores\"** (ver *Auditorías actuales* arriba); no hay auditorías pendientes en estado \"Borrador\". Las dos más recientes, **\"Superficie de confianza de la IA\"** (`AT`) y **\"Sensibilidad al movimiento\"** (`MO`), fueron elaboradas por un grupo de estudio (investigación → verificación de citas externas → autor) y se sometieron a pruebas de estrés de la misma manera que las cuatro anteriores. Las auditorías adicionales se realizan según la demanda, no son especulativas; se añaden una a la vez, con evidencia, cuando un objetivo real y una rúbrica basada en la investigación justifican el trabajo. El [MAPA DE CARRETERA](ROADMAP.md) realiza un seguimiento de los candidatos y del trabajo de avance del ciclo de vida (PT1 → Congelación) para las auditorías que ya están aquí.\n\n## Estructura del repositorio\n\n```\ninterface-audits/\n├── README.md\n├── CHANGELOG.md                       # monorepo events\n├── ROADMAP.md                         # forward plan: audits, tooling, process rules\n├── SECURITY.md                        # threat surface + reporting\n├── SHIP_GATE.md                       # shipcheck quality gate\n├── SCORECARD.md                       # pre/post-treatment scores\n├── LICENSE                            # MIT\n├── package.json                       # verify tooling + Node engines\n├── verify.sh                          # one-command verification\n├── scripts/\n│   ├── verify-schemas.mjs             # JSON Schema validation\n│   └── verify-links.mjs               # markdown relative-link check\n├── shared/                            # cross-audit norms\n│   ├── audit-lifecycle.md\n│   ├── evidence-states.md\n│   ├── severity-model.md\n│   ├── finding-format.md\n│   ├── pressure-test-protocol.md\n│   └── schemas/\n│       ├── finding.base.schema.json\n│       └── scorecard.base.schema.json\n└── audits/                            # one directory per audit; each has the same shape:\n    │                                  #   README.md · RUBRIC.md · CHANGELOG.md ·\n    │                                  #   skill/SKILL.md · schemas/finding.extensions.json · evidence/\n    ├── cognitive-load/                # Frozen v0.2 + Dogfooded\n    ├── low-vision/                    # Pressure-tested v0.1.0  (LV)\n    ├── screen-reader-task/            # Pressure-tested v0.1.0  (SR)\n    ├── color-dependence/              # Pressure-tested v0.1.0  (CD)\n    ├── motor-access/                  # Pressure-tested v0.1.0  (MA)\n    ├── ai-trust-surface/              # Pressure-tested v0.1.0  (AT)\n    └── motion-sensitivity/            # Pressure-tested v0.1.0  (MO)\n```\n\n## Esto no es\n\n- No es un escáner de conformidad con WCAG (utilice [axe](https://www.deque.com/axe/), [Lighthouse](https://developer.chrome.com/docs/lighthouse), [Pa11y](https://pa11y.org/) para ello).\n- No es una revisión del diseño visual.\n- No es una lista de verificación de accesibilidad genérica.\n- No es un paquete npm publicado (todavía; el archivo `package.json` declara `private: true` hasta que se separe un paquete de ejecución).\n\nLas auditorías de este repositorio están diseñadas para aplicarse a interfaces que **superan los escáneres, pero que aún obligan a los usuarios a buscar**.\n\n## Contribuciones\n\nActualmente, este repositorio es mantenido por [dogfood-lab](https://github.com/dogfood-lab). Se aceptan contribuciones externas; primero, abra un problema para discutir cualquier nueva auditoría o cambio en la rúbrica. Según el ciclo de vida: sin pruebas, no hay auditoría oficial.\n\n## Licencia\n\n[MIT](LICENSE) — Copyright (c) 2026 dogfood-lab.\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cem\u003ePart of \u003ca href=\"https://github.com/dogfood-lab\"\u003edogfood-lab\u003c/a\u003e — sister to \u003ca href=\"https://github.com/mcp-tool-shop-org\"\u003emcp-tool-shop-org\u003c/a\u003e.\u003c/em\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdogfood-lab%2Finterface-audits","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdogfood-lab%2Finterface-audits","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdogfood-lab%2Finterface-audits/lists"}