tdd-workflow
Skill0 starsChanged 4 days agoMITView on GitHub
Desarrollo guiado por tests (TDD): ciclo Red → Green → Refactor con lista de tests, triangulación y test doubles, para frontend y backend. Úsala al implementar una feature o corregir un bug "con TDD", "test first" o "escribiendo los tests primero", o al reproducir un bug con un test que falle antes de arreglarlo.
135 other projects use a version of this.
Adopted by
Most recently taken up by
- AtilaMedeiros/skillstheir own version, first seen Nov 16, 2026
- Badhon-00/MDCPtheir own version, first seen Nov 16, 2026
- Red-Hat-AI-Innovation-Team/claude-skillstheir own version, first seen Nov 16, 2026
- Ivan-propio/claude-skillstheir own version, first seen Nov 16, 2026
- AndresArreguy/ecc-pi-porttheir own version, first seen Nov 16, 2026
- rajdeepbhattacharyya25-pixel/agents-for-antigravity-their own version, first seen Nov 15, 2026
Used with
Projects with it also use brand-discovery, configure-ecc and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
ysyecustSkillbrand-discovery
Use when a brand needs to discover or articulate its identity through structured multi-session interviews. Covers purpose, positioning, audience, personality, voice, narrative, and founder-brand tension across 8 modules using laddering, 5 Whys, and projective techniques. Produces a resumable session with disk-persisted state and a master brandbook (90_SYNTHESIS.md).
Also in 6 projects that use this
royaluniondesign-sysSkillconfigure-ecc
Interactive installer for Everything Claude Code — guides users through selecting and installing skills and rules to user-level or project-level directories, verifies paths, and optionally optimizes installed files.
Also in 12 projects that use this
junimnjwSkillralphinho-rfc-pipeline
RFC-driven multi-agent DAG execution pattern with quality gates, merge queues, and work unit orchestration.
Also in 12 projects that use this
loulanyueSkillnuxt4-patterns
Nuxt 4 app patterns for hydration safety, performance, route rules, lazy loading, and SSR-safe data fetching with useFetch and useAsyncData.
Also in 10 projects that use this
royaluniondesign-sysSkillcontent-hash-cache-pattern
Cache expensive file processing results using SHA-256 content hashes — path-independent, auto-invalidating, with service layer separation.
Also in 16 projects that use this
RojiosSkilldart-flutter-patterns
Production-ready Dart and Flutter patterns covering null safety, immutable state, async composition, widget architecture, popular state management frameworks (BLoC, Riverpod, Provider), GoRouter navigation, Dio networking, Freezed code generation, and clean architecture.
Also in 7 projects that use this
Other versions135 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 135
- affaan-m/ECC★ 246ksame name
- vudovn/ag-kit★ 8.2ksame name
- vudovn/antigravity-kit★ 8.2ksame name
- xu-xiang/everything-claude-code-zh★ 1.9ksame name
- loulanyue/awesome-claude-notes★ 272same name
- ab604/claude-code-r-skills★ 202same name
- cloudnative-co/claude-code-starter-kit★ 153same name
- xenitV1/Antigravity-Workflows★ 130same name
- cohen-liel/hivemind★ 108same name
- travisjneuman/.claude★ 106same name
125 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository22 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- git-cleanupSkill
- skill-creatorSkill
- astro-architectureSkill
- monorepo-architectureSkill
- nestjs-architectureSkill
- nextjs-architectureSkill
- react-native-architectureSkill
- gh-cliSkill
- git-cleanupSkill
- backend-best-practicesSkill
- clean-codeSkill
- code-quality-reviewSkill
- design-patternsSkill
- frontend-best-practicesSkill
- solid-principlesSkill
- ssh-connectSkill
- ts-import-organizerSkill
- idd-applySkill
- idd-exploreSkill
- idd-planSkill
The file
We split this skill into the rules it gives an agent
1 rule. 0 are common, 1 is distinctive, and 0 are very specific to this project.
0
Common
Most of the 124 edited versions we read keep these.
1
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 37
No la actives para "añade tests a este código" sin intención de cambiarlo: eso es escribir tests, no TDD (puedes usar sus reglas de diseño …
“Common” is measured: kept by at least 6 in 10 of the 124 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
TDD Workflow (Red → Green → Refactor)
🎯 Propósito
Guiar la implementación con tests escritos antes que el código de producción, en ciclos cortos y verificables. Cada ciclo deja evidencia: un test que falló por la razón correcta, el cambio mínimo que lo hizo pasar y un refactor con la suite en verde.
El objetivo no es "tener tests". Es diseñar con feedback rápido: un test difícil de escribir es una señal de diseño (demasiadas dependencias, responsabilidades mezcladas, efectos ocultos). Escúchala antes de forzar el test con mocks.
⚡ Cuándo Activar esta Skill
- El usuario pide implementar algo "con TDD", "test first", "escribiendo los tests primero" o "red-green-refactor".
- Hay que corregir un bug: primero se reproduce con un test que falla.
- Hay que cambiar código sin tests: primero se fijan tests de caracterización (ver Flujo C).
- El usuario pide practicar una kata o enseñar TDD paso a paso.
No la actives para "añade tests a este código" sin intención de cambiarlo: eso es escribir tests, no TDD (puedes usar sus reglas de diseño de tests, pero sin el ciclo).
📋 Flujo de Trabajo Paso a Paso
Paso 0 — Detectar el entorno de tests
node <skill-dir>/scripts/detect-test-runner.mjs<skill-dir> es el directorio que contiene este SKILL.md. Ejecútalo desde la raíz del proyecto (o del paquete, en un monorepo). Devuelve el runner, el comando para correr un solo archivo y la convención de nombres y ubicación de los tests existentes (--json para salida estructurada).
- Sigue la convención detectada (sufijo
.spec.tso.test.ts, carpetatest/o colocado junto al código). No inventes una nueva. - Si no hay runner, propón uno (Vitest para TS/JS moderno, Jest si el proyecto ya usa su ecosistema,
node:testsi no quieres dependencias) y pide confirmación antes de instalar nada. - Ejecuta la suite una vez antes de empezar. Si ya hay tests rojos, repórtalo: no puedes distinguir tus fallos de los heredados.
Paso 1 — Escribir la lista de tests
Antes de tocar código, escribe la lista de comportamientos a cubrir, del más simple al más complejo. Inclúyela en tu respuesta o como comentario temporal en el archivo de test.
[ ] carrito vacío → envío 0
[ ] pedido < 50 € → tarifa base 4,99
[ ] pedido ≥ 50 € → envío gratis
[ ] zona remota → recargo de 10 € incluso con envío gratis
[ ] peso negativo → lanza ValidationError- Un ítem = un comportamiento observable desde la API pública, no un método interno.
- Incluye bordes (vacío, cero, límite exacto, null, errores) y no solo el camino feliz.
- La lista está viva: cuando descubras un caso nuevo, añádelo; no lo resuelvas a la vez que otro.
Paso 2 — 🔴 Red: un test que falla por la razón correcta
- Elige el ítem más simple que aún no esté hecho.
- Escribe un solo test con estructura Arrange / Act / Assert y un nombre que describa el comportamiento (
devuelve envío gratis cuando el subtotal llega a 50). - Si el símbolo no existe, crea el stub mínimo (firma vacía,
throw new Error('not implemented')) para que el test compile y falle en la aserción, no en un import roto. - Ejecuta solo ese archivo con el comando de archivo detectado.
- Lee el fallo. Debe decir exactamente lo que esperas ("expected 0, received undefined"). Si falla por otra razón, arregla el test antes de seguir. Si pasa sin cambios, el test no aporta nada o el comportamiento ya existía: dilo y pasa al siguiente.
Paso 3 — 🟢 Green: el cambio mínimo
Haz pasar el test con el menor cambio posible, eligiendo una de estas tres estrategias:
| Estrategia | Cuándo usarla |
| Fake it (devolver una constante) | No ves aún la generalización. El siguiente test la forzará. |
| Triangulación | Con un segundo ejemplo distinto, generaliza solo lo que ambos tests exigen. |
| Implementación obvia | La solución es evidente y corta. Escríbela, pero si el test falla, vuelve a pasos más pequeños. |
Ejecuta el archivo de test: todo en verde. No añadas lógica que ningún test exija ("ya que estoy…"): apúntalo en la lista.
Paso 4 — 🔵 Refactor con la suite en verde
- Elimina duplicación (entre código y test también: las constantes mágicas del Green suelen esconderla), mejora nombres, extrae funciones.
- Refactoriza también los tests: helpers de construcción (
buildOrder({ subtotal: 49 })), nada de lógica condicional dentro de un test. - Tras cada refactor, ejecuta los tests. Si algo se pone rojo, deshaz el último paso en lugar de depurar.
- Nunca cambies comportamiento en esta fase: si hace falta, es un nuevo ítem de la lista.
Paso 5 — Repetir y cerrar
- Tacha el ítem y vuelve al Paso 2 hasta vaciar la lista.
- Ejecuta la suite completa (no solo tu archivo), y el typecheck/lint si el proyecto los tiene.
- Reporta con el formato de la sección "Reporte final".
Flujo B — Corregir un bug
- Escribe un test que reproduzca el bug con los datos del reporte. Ejecútalo y confirma que falla mostrando la salida.
- Si no logras reproducirlo, no "arregles" a ciegas: reporta qué probaste y pide más datos.
- Aplica la corrección mínima, ejecuta el test (verde) y luego la suite completa.
- Busca casos hermanos del mismo bug (otros formatos, límites) y añádelos a la lista.
Flujo C — Cambiar código sin tests (legacy)
- Escribe tests de caracterización: fijan lo que el código hace hoy, aunque parezca incorrecto. Nombra los sospechosos como tales (
conserva el comportamiento actual: redondea hacia abajo). - Si el código no es testeable (dependencias duras de BD, reloj, red), introduce una costura mínima (parámetro con valor por defecto, inyección por constructor) sin cambiar comportamiento.
- Con la red de seguridad en verde, aplica el ciclo normal para el cambio pedido.
🧪 Diseño de buenos tests
- Prueba comportamiento, no implementación. Usa la API pública; no verifiques métodos privados ni el orden de llamadas internas. Un refactor no debería romper tests.
- Un motivo para fallar por test. Varias aserciones están bien si describen el mismo comportamiento.
- Deterministas. Controla tiempo, aleatoriedad, zona horaria y red. Inyecta un reloj (
now: () => Date) en lugar de mockearDateglobal cuando el diseño lo permita. - Test doubles solo en los bordes (I/O, red, BD, reloj, servicios externos). Prefiere fakes en memoria a mocks con expectativas. No mockees lo que no te pertenece: envuelve la librería en un adaptador y mockea el adaptador. Detalles en Test doubles.
- Nivel adecuado: lógica de dominio → unitario; contrato con BD/HTTP → integración; flujo crítico de usuario → e2e (pocos). Guía por stack: Frontend y Backend.
- Datos explícitos y mínimos en el test: solo lo relevante para el comportamiento, el resto con builders o valores por defecto.
⚠️ Reglas Críticas
- Nada de código de producción sin un test rojo que lo pida mientras trabajes en modo TDD. Si escribes algo sin test (configuración, wiring), dilo explícitamente.
- Ejecuta el test y mira el rojo de verdad. Un test que nunca viste fallar no demuestra nada. No afirmes "falla" o "pasa" sin haber ejecutado el comando.
- No modifiques un test para que pase salvo que el test estuviera mal; si lo cambias, explica por qué en el reporte.
- No borres, saltes (
.skip,xit) ni debilites aserciones para dejar la suite en verde. - Pasos pequeños. Si llevas más de unos minutos en rojo, el paso era demasiado grande: deshaz y divídelo.
- No instales dependencias ni cambies la configuración de tests sin confirmación del usuario.
- Reporta con honestidad: si la suite tenía fallos previos o no pudiste ejecutar los tests, dilo con la salida real.
📤 Reporte final
### Ciclos TDD
| # | Test (comportamiento) | Rojo (motivo del fallo) | Verde (estrategia) | Refactor |
|---|---|---|---|---|
| 1 | carrito vacío → envío 0 | expected 0, received undefined | fake it | — |
| 2 | subtotal ≥ 50 → gratis | expected 0, received 4.99 | triangulación | extraer FREE_SHIPPING_THRESHOLD |
### Resultado
- Suite completa: `<comando>` → N tests, todos en verde.
- Pendiente / fuera de alcance: …📚 Referencias
- Test doubles: dummy, stub, spy, mock y fake
- Testing en frontend (componentes, hooks, e2e)
- Testing en backend (servicios, HTTP, base de datos)
- Ejemplo completo de una sesión TDD
🛠️ Scripts
scripts/detect-test-runner.mjs: detecta vitest, jest, mocha,node:test, playwright, cypress, pytest,go testycargo test, el gestor de paquetes y la convención de tests. Solo lectura. Opciones:--cwd <dir>,--json,--help.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

