Este repositorio construye, patrón por patrón y con evidencia, el sistema de verificación que permite dirigir a un agente de IA sin leer cada línea que escribe: oráculos que puedan contradecirlo, y convenciones que hagan que el propio agente produzca la evidencia de su trabajo.
Un ecosistema de agentes que revisan a otros agentes tiene un techo: todos comparten el mismo sesgo. Dos jueces del mismo modelo, ciegos entre sí, leyendo el mismo código, coinciden también en lo que no entienden. La confirmación cruzada entre dos instancias del mismo criterio no es evidencia independiente: es la misma opinión emitida dos veces.
Un oráculo es algo que puede contradecir al modelo sin pedirle permiso: un test que falla, una captura, una consulta que devuelve una fila de más. La diferencia entre revisar y verificar es exactamente esa.
Un patrón entra a este repositorio cuando ya resolvió un problema real en un proyecto real. No antes.
Cada patrón entra con tres cosas, siempre las mismas:
- El dolor concreto — qué se rompió, qué se pasó por alto, qué se revisó mal.
- El artefacto mínimo — lo más pequeño que haga el trabajo.
- La evidencia — qué ocurrió al usarlo; qué detectó que antes se escapaba.
Lo que no cumple las tres va a hipotesis/. La regla se aplica al
propio repositorio: escribir una convención porque suena bien es opinión, y es
justamente lo que este repositorio existe para evitar.
| Término | Definición |
|---|---|
| Oráculo | Fuente capaz de contradecir al agente sin depender de su criterio: un test, una captura, una medición, un esquema. |
| Artefacto de evidencia | Salida material y revisable que el agente produce al terminar una tarea, destinada a que una persona verifique en segundos. |
| Opinión | Juicio emitido por un modelo sobre su propio trabajo o el de otro modelo del mismo tipo. Útil, pero no es evidencia. |
| Protocolo de entrega | Lo que un agente debe dejar escrito al terminar, además del código. |
Este repositorio no aspira a inventar todo. La mayor parte del trabajo bueno en esta área ya está hecha por otros, y copiarla sería empeorarla: una copia nace desactualizada y nadie se entera. Así que el arsenal tiene dos capas, y la diferencia entre ellas es quién puso la evidencia.
Herramientas de terceros, mantenidas por sus autores. Acá van enlaces, nunca copias.
| Herramienta | Qué hace | Estado |
|---|---|---|
| Engram | Memoria persistente entre sesiones del agente | En uso |
| Agent Teams Lite | Desarrollo dirigido por especificación con subagentes (las skills sdd-*) |
En uso |
| Superpowers | Protocolos de trabajo: brainstorming, depuración sistemática, verificación previa | En uso |
| code-slop | Detecta patrones de código generado por IA: narración en comentarios, nombres genéricos, interfaces prematuras, exceso defensivo, tests que mockean todo. 24 reglas en 6 categorías | Por instalar |
| Gentleman-Skills | Skills por framework, curadas y de comunidad | Referencia; ver la tabla por stack |
| Guardian Angel | Revisión de código agnóstica al proveedor | Por evaluar → hipótesis |
Skills que dependen del lenguaje o del framework. No van en el arsenal global:
se copian al .claude/skills/ del proyecto que las necesita, para que queden
versionadas con él y las tenga cualquiera que lo clone.
No es por ahorrar contexto — diez skills son unos 500 tokens y eso no se nota. Es por propiedad: una skill del proyecto viaja con el proyecto y se ve en una revisión; una copia personal no la tiene nadie más y envejece en silencio.
| Stack | Skills | Fuente |
|---|---|---|
| React / TypeScript | react-19, typescript, tailwind-4, zod-4, zustand-5 |
Gentleman-Skills |
| Pruebas de extremo a extremo | playwright |
Gentleman-Skills |
| PHP / Laravel | laravel-best-practices, laravel-testing, laravel-owasp-security, laravel-queues, php-best-practices |
AsyrafHussin/agent-skills |
| Laravel + React juntos | laravel-inertia-react |
AsyrafHussin/agent-skills |
mkdir -p .claude/skills
cp -r <repo-clonado>/curated/react-19 .claude/skills/De a una, nunca paquetes completos. Hay repos con más de cincuenta skills, y
algunos incluyen versiones propias de brainstorming, writing-plans o
executing-plans que chocan con las que ya trae Superpowers: quedan dos skills
peleando por el mismo disparador y el agente elige cualquiera.
Trabajo ajeno que resuelve problemas de este repositorio y todavía no se probó. Está acá para no reinventarlo.
| Fuente | Qué aporta |
|---|---|
| Acceptance Pipeline Specification | Mutación de aceptación: cambiar los valores de ejemplo de un Gherkin y ver si el test sigue pasando. Si pasa, el test no estaba conectado a nada. |
| clj-mutate · dependency-checker | Oráculos mecánicos: mutación y verificación de dependencias entre módulos |
| Receipt-Driven Development | Protocolo transaccional que prueba que la revisión ocurrió y quién autorizó la entrega |
Ordenar lo ajeno sirvió para ver dónde está el hueco:
| Familia | Qué es | Dónde vive |
|---|---|---|
| Mecánicos | Fallan solos, sin que nadie opine: tests, mutación, verificadores | Uncle Bob |
| De juicio | Otro modelo opinando sobre el trabajo | Guardian Angel, RDD |
| Perceptuales | Un artefacto que una persona verifica en segundos | Casi vacía |
La tercera es la única donde quien decide es una persona mirando, y es la que este repositorio construye.
Lo propio: construido o adaptado, y admitido solo con evidencia.
| Patrón | Qué verifica |
|---|---|
| Blink | Cambios visuales de frontend, por comparación de parpadeo. |
patrones/— lo que ya se ganó el lugar.hipotesis/— lo que todavía no.docs/disenos/— por qué cada patrón es como es: decisiones, alternativas descartadas y qué se verificó de cada una.