abrahamvilchesdelacruz/ididntcatchthat/tdd-workflow
Claude Code and agent skill by abrahamvilchesdelacruz/ididntcatchthat
- community
Checking that the SKILL.md file is still in the repository.
Workflow obligatorio de TDD antes de escribir cualquier código nuevo: Red → Green → Refactor. Aplica a api (Jest) y client (Vitest + RTL). Trigger: Antes de implementar cualquier feature, use case, hook o componente nuevo.
Install
npx vskill@latest install abrahamvilchesdelacruz/ididntcatchthat/tdd-workflowSKILL.md
The same SKILL.md was published earlier as abrahamvilchesdelacruz/ididntcatchthat/tdd-workflow.
When to Use
Cargar esta skill ANTES de escribir cualquier código nuevo:
- Nuevo use case o domain service (api)
- Nuevo aggregate o value object (api)
- Nuevo hook de pod (client)
- Nuevo Container o Component (client)
- Nuevo mapper, helper o función utilitaria (api o client)
Leereferences/docs.mdpara skills relacionadas, ADRs y documentación externa.
NO aplica a: cambios de configuración, migraciones, refactors puros sin nuevo comportamiento.
El Workflow — Siempre en Este Orden
Paso 1 — Entender qué se va a construir
Antes de escribir ni una línea, responder:
- ¿Qué comportamiento nuevo estamos añadiendo? (en lenguaje de negocio, no técnico)
- ¿En qué capa vive? (domain, application, infrastructure, client-hook, client-component)
- ¿Cuáles son los escenarios happy path y los casos de error?
Paso 2 — RED: escribir el test que falla
El test se escribe antes que la implementación. Sin excepciones.
En api (Jest):
En client (Vitest + RTL):
Verificar que el test falla: correr el test y confirmar que el error es el esperado (not found, not implemented), no un error de sintaxis o import.
Paso 3 — GREEN: mínimo código para pasar el test
Escribir solo lo necesario para que el test pase. Sin optimizar. Sin anticipar casos futuros.
Reglas:
- Si hay que crear el archivo de implementación, crearlo ahora.
- Si el test pide un
FlashcardMotherque no existe, crearlo también. - No añadir lógica que el test no exige todavía.
Paso 4 — Refactor: limpiar manteniendo verde
Con el test en verde:
- Eliminar duplicación
- Renombrar para claridad
- Extraer métodos si el método hace más de una cosa
- Los tests deben seguir en verde después de cada cambio
Paso 5 — Repetir por cada escenario
Volver al Paso 2 para el siguiente escenario. Un ciclo Red → Green → Refactor por comportamiento.
Qué Testear Según la Capa
| Capa | Qué testear | Tool | |
|---|---|---|---|
| Use Case (api) | Flujo completo: happy path + errores de dominio | Jest + jest-mock-extended | |
| Domain Service (api) | Comportamiento de negocio aislado | Jest | |
| Hook del pod (client) | Estado, handlers, side effects | Vitest + renderHook | |
| Mapper (api/client) | Transformación entrada → salida | Jest / Vitest (función pura) | |
| Component (client) | Renderizado, interacciones UI | Vitest + RTL | |
| Container (client) | Flujo completo con HTTP mockeado | Vitest + RTL + MSW |
El Domain (aggregates, VOs) no se testea en aislamiento — se ejercita a través de los tests del Use Case que los invoca.
Reglas No Negociables
- El test se escribe antes. Siempre. No hay excepción.
- Un test = un comportamiento observable. No testear implementación interna (
calls repository.match), sino efecto (saves the flashcard). - El nombre describe el comportamiento:
it('throws FlashcardNotFound when flashcard does not exist'), noit('calls repository.match'). - Verificar que el test falla antes de implementar — un test que nunca falla no prueba nada.
- Object Mothers siempre para construir datos de test. Nunca literales inline.
- No mockear lo que no controlás — usar abstracciones propias en lugar de mockear
DateoMath.randomdirectamente.
Relación con Otras Skills
- Para el CÓMO crear Mothers, mocks y estructura de
/testen api → cargarapi-testing - Para el CÓMO testear hooks, RTL y MSW en client → cargar
client-testing - Esta skill define el CUÁNDO y EN QUÉ ORDEN — siempre va primero
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/tdd-workflow/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/abrahamvilchesdelacruz/ididntcatchthat/tdd-workflow)