Revisión en dos ejes del diff entre HEAD y un punto figo proporcionado por el usuario:
- Estándares — ¿el código cumple con los estándares de codificación documentados en este repositorio?
- Especificación — ¿el código implementa fielmente el issue / PRD / especificación original?
Ambos ejes se ejecutan como subagentes paralelos para no contaminar el contexto del otro, luego esta habilidad agrega sus hallazgos.
El rastreador de issues debería haberte sido proporcionado — ejecuta /setup-matt-pocock-skills si falta docs/agents/issue-tracker.md.
Proceso
1. Fijar el punto de referencia
Cualquier punto que el usuario haya indicado como referencia — un SHA de commit, nombre de rama, etiqueta, main, HEAD~5, etc. Si no especificó uno, pídelo.
Captura el comando diff una vez: git diff <punto-de-referencia>...HEAD (tres puntos, para que la comparación sea contra la merge-base). También anota la lista de commits mediante git log <punto-de-referencia>..HEAD --oneline.
Antes de continuar, confirma que el punto de referencia se resuelve (git rev-parse <punto-de-referencia>) y que el diff no está vacío. Una referencia incorrecta o un diff vacío deben fallar aquí, no dentro de los dos subagentes paralelos.
2. Identificar la fuente de la especificación
Busca la especificación original, en este orden:
- Referencias a issues en los mensajes de commit (
#123,Closes #45, GitLab!67, etc.) — obténlos mediante el flujo de trabajo endocs/agents/issue-tracker.md. - Una ruta que el usuario haya pasado como argumento.
- Un archivo PRD/especificación bajo
docs/,specs/, o.scratch/que coincida con el nombre de la rama o funcionalidad. - Si no se encuentra nada, pregunta al usuario dónde está la especificación. Si dice que no hay, el subagente de Especificación se omitirá e informará "no hay especificación disponible".
3. Identificar las fuentes de estándares
Todo lo que haya en el repositorio que documente cómo debe escribirse el código, como CODING_STANDARDS.md o CONTRIBUTING.md.
4. Lanzar ambos subagentes en paralelo
Envía un único mensaje con dos llamadas a la herramienta Agent. Usa el subagente general-purpose para ambos.
Indicación para el subagente de Estándares — incluye:
- El comando diff completo y la lista de commits.
- La lista de archivos fuente de estándares que encontraste en el paso 3.
- La consigna: "Informe — por archivo/hunk donde sea relevante — cada lugar donde el diff viole un estándar documentado. Cita el estándar (archivo + regla). Distingue infracciones graves de juicios subjetivos. Omite cualquier cosa que las herramientas automatizadas ya verifiquen. Menos de 400 palabras."
Indicación para el subagente de Especificación — incluye:
- El comando diff y la lista de commits.
- La ruta o contenido obtenido de la especificación.
- La consigna: "Informe: (a) requisitos que la especificación pedía y que faltan o están incompletos; (b) comportamiento en el diff que no fue solicitado (scope creep); (c) requisitos que parecen implementados pero cuya implementación parece incorrecta. Cita la línea de la especificación para cada hallazgo. Menos de 400 palabras."
Si la especificación no está disponible, omite el subagente de Especificación y señálalo en el informe final.
5. Agregar
Presenta los dos informes bajo los encabezados ## Estándares y ## Especificación, textualmente o ligeramente limpiados. No combines ni reordenes los hallazgos — los dos ejes están deliberadamente separados (ver Por qué dos ejes).
Termina con un resumen de una línea: total de hallazgos por eje, y el peor problema dentro de cada eje (si lo hay). No elijas un único ganador entre ejes — esa es la reordenación que la separación busca evitar.
Por qué dos ejes
Un cambio puede aprobar un eje y fallar el otro:
- Código que sigue todos los estándares pero implementa lo incorrecto → Estándares aprueba, Especificación falla.
- Código que hace exactamente lo que pedía el issue pero rompe las convenciones del proyecto → Especificación aprueba, Estándares falla.
Informarlos por separado evita que un eje opaque al otro.