Skip to content
Back to search

agente-qa-mobile

9-stage mobile QA pipeline as Claude Code skills: expectations before code, oracle ensemble, 2 human gates.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/manuel-arguelles-ai--agente-qa-mobile/badge.svg)](/listings/manuel-arguelles-ai--agente-qa-mobile)

HTML

<a href="/listings/manuel-arguelles-ai--agente-qa-mobile"><img src="/api/listings/manuel-arguelles-ai--agente-qa-mobile/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 98 lines
  1. # agente-qa-mobile
  2. Pipeline de QA para apps móviles (Flutter/Android, con criterios iOS) en **9 etapas** y **2 compuertas human-in-the-loop**, implementado como skills de Claude Code. Audita una feature o app y entrega un reporte de cumplimiento con un veredicto por expectativa: `cumple`, `no_cumple` o `dudoso`.
  3. ## La idea central
  4. Un auditor que primero lee el código y después decide qué "debería" hacer termina auditando contra lo que el código ya hace: todo cumple, porque las expectativas salieron de la implementación.
  5. Este pipeline invierte el orden:
  6. 1. **Primero se generan las expectativas de calidad desde la concepción** (spec, historia de usuario) y desde criterios externos verificables (Android vitals, OWASP MASVS, WCAG), **antes de mirar el código**. Cada expectativa es una tupla ⟨P, I, Q⟩: precondición, interacción, postcondición, con un tag estable.
  7. 2. Después se exploran el código y la app en ejecución para descubrir expectativas adicionales (cada una con su `source`), que se fusionan con las anteriores sin duplicar.
  8. 3. Cada expectativa se convierte en un **ensemble de oráculos** (propiedad ejecutable, relación metamórfica, check estático, auditoría de datos); ningún oráculo basado en LLM decide solo.
  9. 4. Solo `qa-verify` emite veredictos, y **nunca** marca `cumple` sin evidencia. Si la única fuente de una expectativa es un comentario del propio código (no un spec ni un test), una desviación queda como `dudoso`, porque los comentarios se desincronizan del código.
  10. ## Pipeline
  11. ```mermaid
  12. flowchart TD
  13. A[1. qa-conceive<br/>expectativas desde la spec] --> B[2. qa-explore-code<br/>expectativas desde el código]
  14. B --> C[3. qa-explore-runtime<br/>expectativas explorando la UI]
  15. C --> D[4. qa-author-oracles<br/>ensemble de checks por expectativa]
  16. D --> G1{{COMPUERTA HUMANA 1<br/>aprobar expectativas y checks}}
  17. G1 --> E[5. qa-execute<br/>correr o generar checks]
  18. E --> F[6. qa-run-farm<br/>device farm: Firebase Test Lab]
  19. F --> V[7. qa-visual<br/>golden tests + MLLM advisory]
  20. V --> W[8. qa-verify<br/>veredicto por expectativa]
  21. W --> G2{{COMPUERTA HUMANA 2<br/>adjudicar los dudosos}}
  22. G2 --> R[9. qa-report<br/>reporte rankeado por riesgo]
  23. ```
  24. El driver `/qa-mobile <target>` orquesta todo. Si la feature no tiene spec escrita, se omite `qa-conceive` y `qa-explore-code` pasa a ser la fuente primaria (sin inventar una concepción de memoria).
  25. ## Qué hace cada etapa
  26. | Etapa | Skill | Qué produce |
  27. |---|---|---|
  28. | 1 | `qa-conceive` | Expectativas ⟨P,I,Q⟩ desde la spec, más no-funcionales ancladas en `criteria/`. Vocabulario de tags canónico para que sea reproducible. Solo genera, no afirma cumplimiento. |
  29. | 2 | `qa-explore-code` | Expectativas derivadas del código, con `source`; relaciones metamórficas (filtros: subconjunto; orden/monotonía). |
  30. | 3 | `qa-explore-runtime` | Exploración autónoma de la UI con Patrol (planner, actor, observer, reflector con memoria; llama al LLM solo cuando la cobertura se estanca). Incluye ciclo de vida (background/kill y restauración). |
  31. | 4 | `qa-author-oracles` | Fusiona duplicados entre fuentes y emite por expectativa al menos 2 tipos de check: `property`, `metamorphic`, `static`, `data-audit`. |
  32. | 5 | `qa-execute` | Corre lo que se puede correr (tests, `flutter analyze`, auditorías de datos) y **genera** los tests que requieren device. Verifica que el test ejercite el símbolo real y no una copia aislada. |
  33. | 6 | `qa-run-farm` | Runbook para Firebase Test Lab (build en CI, sharding vía Patrol). Sin infraestructura, la evidencia queda como `planned`. |
  34. | 7 | `qa-visual` | Evidencia visual: golden tests (deterministas) y juicio MLLM solo como nota advisory. |
  35. | 8 | `qa-verify` | `cumple` / `no_cumple` / `dudoso` con `confidence`; `blocked_reason` opcional (`no_device`, `no_infra`, `ambiguous_evidence`, `needs_external_data`). |
  36. | 9 | `qa-report` | `qa-report.md`: resumen, hallazgos por riesgo (`no_cumple` > `dudoso` > `cumple`) y cola de revisión humana agrupada por causa de bloqueo. No pierde ningún tag. |
  37. ## Las 2 compuertas human-in-the-loop
  38. - **Compuerta 1 (tras la etapa 4):** el humano revisa y aprueba las expectativas y sus checks antes de gastar tiempo de ejecución.
  39. - **Compuerta 2 (tras la etapa 8):** el humano adjudica cada `dudoso` antes de generar el reporte final.
  40. El driver tiene prohibido saltárselas.
  41. ## Estructura
  42. ```
  43. skills/
  44. qa-mobile/ driver /qa-mobile + criteria/ (vitals, masvs, wcag, ios)
  45. qa-conceive/ qa-explore-code/ qa-explore-runtime/ qa-author-oracles/
  46. qa-execute/ qa-run-farm/ qa-visual/ qa-verify/ qa-report/
  47. (cada una: SKILL.md, EVAL.md y golden/ con casos de ejemplo)
  48. docs/
  49. AGENT.md resumen del agente
  50. RESEARCH.md investigación que respalda el diseño, con fuentes y caveats
  51. ```
  52. ## Instalación
  53. Requiere Claude Code. Copia las 10 carpetas de `skills/` juntas al directorio de skills (las skills se referencian entre sí por ruta relativa `../qa-mobile/criteria/`):
  54. ```bash
  55. git clone <url-del-repo> agente-qa-mobile
  56. mkdir -p ~/.claude/skills
  57. cp -R agente-qa-mobile/skills/* ~/.claude/skills/
  58. ```
  59. Para una instalación por proyecto, copia a `<proyecto>/.claude/skills/`. Luego, en Claude Code:
  60. ```
  61. /qa-mobile <ruta-al-repo-flutter | descripción de la feature>
  62. ```
  63. El reporte se escribe en `<target>/qa-report.md`.
  64. ## Límites honestos
  65. - **El device farm real está pendiente.** `qa-run-farm` produce el runbook (`patrol build`, `gcloud firebase test ...`) y deja la evidencia como `planned`; no se ha ejecutado una corrida real en Firebase Test Lab. Lo mismo aplica a `qa-explore-runtime`, que requiere device o emulador.
  66. - El costo por minuto de Firebase Test Lab **no está verificado**; consúltalo en la documentación del proveedor.
  67. - El oráculo visual MLLM tiene un techo reportado cercano al 49 %: es advisory y requiere confirmación humana.
  68. - Las skills están pensadas para Flutter/Patrol (con criterios iOS de apoyo). Otros stacks requieren adaptarlas.
  69. - Los archivos `EVAL.md` y `golden/` documentan puntajes de un harness de evaluación interno que **no se incluye** en este repo; los golden son casos de ejemplo, no una suite ejecutable aquí.
  70. - La validación end-to-end documentada se hizo una vez sobre una app Flutter de ejemplo; no hay evidencia de uso a mayor escala.
  71. - Parte de la investigación en `docs/RESEARCH.md` se apoya en un preprint de 2026 sin revisión por pares ni reproducción independiente; el propio documento lo declara.
  72. ## Licencia
  73. MIT. Ver `LICENSE`.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.