Recipe: Add Integration Tests

Deriva pruebas de integración/E2E de tu Design Doc en lugar de del código

Por shinpr · shinpr/codex-workflows

Funciona con configuración ★ 8.0/10

Recipe: Add Integration Tests — Deriva pruebas de integración/E2E de tu Design Doc en lugar de del código

Qué hace

Una receta de orquestador que convierte un Design Doc existente en esqueletos de pruebas de integración y E2E, los implementa capa por capa y ejecuta un ciclo de revisión y calidad antes de confirmar. Se activa cuando solicitas añadir cobertura de integración o E2E a código que ya tiene un documento de diseño. Escrito para OpenAI Codex CLI, por lo que sus cinco subagentes nombrados no existen en Claude Code.

Informe de la prueba

Lo ejecuté contra una pequeña API HTTP en memoria con un documento de diseño cuya tabla de contratos decía que la finalización repetida debía ser idempotente, mientras que la implementación devolvía 409. La línea base sin skill leyó el código fuente primero y escribió siete pruebas que todas pasaron — incluyendo una que afirmaba el 409, bloqueando permanentemente el error. Siguiendo la receta, el esqueleto provino del documento de diseño en lugar del código, y el conjunto resultante falló exactamente en esa fila (409 !== 200), además de afirmar un error.code legible por máquina en cinco rutas de falla donde la línea base no afirmó ninguna. El costo es una configuración real: necesita un Design Doc ya ubicado en docs/design con un nombre de archivo backend/frontend, cuatro skills hermanas copiadas junto a él, y llama a cinco subagentes de Codex CLI (acceptance-test-generator, task-executor, integration-test-reviewer, quality-fixer) que un usuario de Claude Code no tiene.

Probado el: 2026-07-28 · Claude Code 2.x (agent harness)

Instalación

git clone --depth 1 https://github.com/shinpr/codex-workflows.git
mkdir -p ~/.claude/skills
cd codex-workflows && for s in recipe-add-integration-tests testing integration-e2e-testing documentation-criteria llm-friendly-context; do cp -r .agents/skills/$s ~/.claude/skills/$s; done

Comandos y prompts de ejemplo

  • /recipe-add-integration-testsDeriva pruebas de integración/E2E de tu Design Doc en lugar de del código

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

  • Add integration tests to this API using our existing design doc
  • Generate E2E tests from docs/design/auth-design.md for the auth service
  • We have no integration coverage, build it from the tasks API design doc