Progressive Change-Driven Development · desarrollo progresivo guiado por cambios
Programá con IA.Sin perderel hilo.
PCDD le da a cada cambio el proceso justo: una spec cuando importa, un registro que sobrevive a la sesión y una línea de llegada que aprobás vos.
$ curl -fsSL https://pcdd.dev/install.sh | sho uv tool install pcdd · pipx install pcdd · Python 3.9+, sin dependencias
$ pcdd init ›_ pcdd · cada cambio, el proceso justo. PCDD está listo. Crear .pcdd/core.md Crear AGENTS.md Crear CLAUDE.md Tu contenido propio se conserva. $ pcdd new rate-limit Change creado: pcdd/changes/rate-limit.md Definí las specs antes de implementar. $ pcdd time status rate-limit 2/3 tareas completadas · 2880 s registrados
Otros agentes que leen AGENTS.md pueden seguir el núcleo; todavía sin probar.
El problema
Programar con IA falla de dos formas opuestas.
La mayoría oscila entre las dos. Un arreglo chico recibe una spec de diez páginas; la migración riesgosa siguiente, un prompt y una plegaria.
Rápido hoy. Perdido mañana.
- Una sesión nueva olvida qué se decidió y por qué.
- «Listo» significa que compila, no que funciona.
- Un cambio riesgoso recibe el mismo trato que un typo.
Seguro en papel. Salteado en la práctica.
- Una spec completa para un arreglo de una línea.
- La ceremonia consume contexto, tokens y paciencia.
- Entonces se deja de seguir, incluso cuando importa.
Proceso proporcional al riesgo.
- Lo chico y claro avanza directo.
- Lo sustancial lleva specs aprobadas y un registro.
- Lo riesgoso lleva revisión independiente antes del commit.
Por qué importa
Jueves a la mañana.
Sesión nueva.
Empezaste una feature el lunes. Mismo pedido, mismo agente: lo único que cambia es lo que puede leer.
Volvés a explicar. El bug aparece después.
make ready). Está terminado cuando vos lo aceptes; te explico cómo probarlo.Lee el registro. Vos decidís cuándo está listo.
Cómo funciona
Elegí un cambio. Mirá cómo se ajusta el proceso.
El agente evalúa el riesgo por lo que el cambio toca, no por la cantidad de líneas. El tamaño solo nunca decide.
- Leer contexto
- Specs aprobadas (omitido)
- Tareas (omitido)
- Implementar
- Checks
- Evidencia (omitido)
- Revisión independiente (omitido)
- Tu aceptación
Corregir un typo en la documentación: Directo.
Bien entendido y acotado. El agente lee el contexto justo, hace el cambio y corre los checks. El diff es el registro: sin documento de cambio, sin ceremonia.
- Leer contexto
- Specs aprobadas
- Tareas
- Implementar
- Checks
- Evidencia
- Revisión independiente (omitido)
- Tu aceptación
Agregar rate limiting al login: Definí, después construí.
El agente propone specs verificables y espera tu aprobación. Tareas, resultados de tests y el próximo paso se escriben en pcdd/changes/rate-limit.md, así cualquier sesión puede retomarlo.
- Leer contexto
- Specs aprobadas
- Tareas
- Implementar
- Checks
- Evidencia
- Revisión independiente
- Tu aceptación
Migrar la autenticación a otro proveedor: Revisión antes del commit.
Hay efectos irreversibles y seguridad en juego. Después de pasar los checks, una revisión independiente verifica el trabajo y vos aprobás a partir de un resumen que se entiende.
Continuidad
Cerrá la notebook.
El contexto queda.
Cada cambio sustancial vive en un archivo Markdown en tu repo: specs, tareas, evidencia y el próximo paso exacto. Una sesión nueva, o incluso otro agente, lee eso y no todo tu historial.
Contexto inicial chico. Las skills se cargan solo cuando hacen falta. Sin servicio de memoria externo.
## Specs S1 — Limitar intentos de login por IP. Aprobada. ## Tasks - [x] T1 (S1) Escribir el test que falla - [x] T2 (S1) Implementar el limitador - [ ] T3 (S1) Verificar y aceptar ## Continuation Next step: el usuario prueba el bloqueo tras 5 intentos.
Empezar
Tres pasos.
Nada nuevo que aprender.
Sin app nueva, sin cuenta, sin configuración que escribir. Seguís usando tu agente como ya lo hacés.
- 1
Instalá una vez
$ curl -fsSL https://pcdd.dev/install.sh | shUna línea. Instala uv si falta. Python 3.9+, sin dependencias de runtime.
- 2
Sumalo a tu proyecto
$ pcdd initMirá antes la vista previa con
--dry-run. Tu contenido se conserva ypcdd rollbacklo deshace. - 3
Contale el cambio
«Agregá rate limiting al endpoint de login.»Abrí Codex, Claude Code o Antigravity. El agente elige cuánto proceso hace falta y pregunta solo lo necesario.
Vos tenés el control
El agente propone.
Vos decidís.
Vos aprobás las specs
Criterios verificables, con tus palabras citadas, antes de escribir código.
Evidencia, no intuición
Test primero cuando el resultado es claro; si no, el registro dice qué queda sin verificar.
Sin commits sorpresa
Commits, push y publicación requieren tu permiso explícito. Sin atribución de IA.
Tuyo, en local
Markdown plano en tu repo. Instalaciones con vista previa, actualización y rollback. Sin servicio ni lock-in.
Comparación
No es el más liviano.
Es el que encaja.
El mismo cambio, tres enfoques. Mirá cuánto proceso pide cada uno.
Corregir un typo en la documentación
- Spec
- Plan
- Implementar
- Checks
- Implementar
- Checks
- Implementar
- Checks
- Tu aceptación
Los flujos que exigen spec primero pagan la ceremonia completa por un cambio de una línea. PCDD avanza directo, y vos igual revisás el resultado.
La forma de cada columna sigue la idea organizadora de cada enfoque; las implementaciones reales varían. Todavía no medimos tiempo ni tokens: cuando lo hagamos, publicaremos el método junto con los números.
Agregar rate limiting al login
- Spec
- Plan
- Tareas
- Implementar
- Checks
- Notas de contexto
- Implementar
- Checks
- Specs aprobadas
- Tareas
- Implementar
- Checks
- Registro de cambio
- Tu aceptación
Acá PCDD se parece a SDD, más un registro de cambio que cualquier sesión o agente puede retomar y tu aprobación al final.
La forma de cada columna sigue la idea organizadora de cada enfoque; las implementaciones reales varían. Todavía no medimos tiempo ni tokens: cuando lo hagamos, publicaremos el método junto con los números.
Migrar la autenticación a otro proveedor
- Spec
- Plan
- Tareas
- Implementar
- Checks
- Notas de contexto
- Implementar
- Checks
- Specs aprobadas
- Tareas
- Implementar
- Checks
- Registro de cambio
- Revisión independiente
- Tu aceptación
Cuando hay seguridad y efectos irreversibles en juego, PCDD suma una revisión independiente después de los checks y antes de cualquier commit.
La forma de cada columna sigue la idea organizadora de cada enfoque; las implementaciones reales varían. Todavía no medimos tiempo ni tokens: cuando lo hagamos, publicaremos el método junto con los números.
Cada cambio,
el proceso justo.
Se instala en una línea. Probalo en tu próximo cambio.
$ curl -fsSL https://pcdd.dev/install.sh | sh