v0.4Código abierto · MIT · Codex, Claude Code, Antigravity

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 | sh

o uv tool install pcdd · pipx install pcdd · Python 3.9+, sin dependencias

~/tu-proyecto
$ 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
Funciona con tu agenteCodexOpenAIClaude CodeAnthropicAntigravityGoogle

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.

Poco proceso

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.
Demasiado proceso

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.
PCDD

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.

Sin PCDD
Sigamos con el rate limiting.
¡Claro! ¿Me recordás qué enfoque acordamos y qué está hecho?
¿Está terminado?
¡Sí, listo! La feature está implementada.

Volvés a explicar. El bug aparece después.

Con PCDD
Sigamos con el rate limiting.
Retomo rate-limit: 2/3 tareas hechas, tests en verde. Próximo paso: probás el bloqueo después de 5 intentos.
¿Está terminado?
Pasó el gate (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.

  1. Leer contexto
  2. Specs aprobadas (omitido)
  3. Tareas (omitido)
  4. Implementar
  5. Checks
  6. Evidencia (omitido)
  7. Revisión independiente (omitido)
  8. 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.

## RiesgoRisk: noneRegistro: el diff
  1. Leer contexto
  2. Specs aprobadas
  3. Tareas
  4. Implementar
  5. Checks
  6. Evidencia
  7. Revisión independiente (omitido)
  8. 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.

## RiesgoRisk: item 2 (seguridad)Registro: pcdd/changes/rate-limit.md
  1. Leer contexto
  2. Specs aprobadas
  3. Tareas
  4. Implementar
  5. Checks
  6. Evidencia
  7. Revisión independiente
  8. 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.

## RiesgoRisk: items 1, 2, 3 (datos, seguridad, contratos)Registro: change + revisión independiente

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.

Sesión 1 · CodexSesión 2 · Claude Code
pcdd/changes/rate-limit.md2/3 tareas
## 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. 1

    Instalá una vez

    $ curl -fsSL https://pcdd.dev/install.sh | sh

    Una línea. Instala uv si falta. Python 3.9+, sin dependencias de runtime.

  2. 2

    Sumalo a tu proyecto

    $ pcdd init

    Mirá antes la vista previa con --dry-run. Tu contenido se conserva y pcdd rollback lo deshace.

  3. 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

SDDSpec-Driven
4 pasos
  • Spec
  • Plan
  • Implementar
  • Checks
ODDOrganic Driven
2 pasos
  • Implementar
  • Checks
PCDDProgressive Change-Driven
3 pasos
  • 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

SDDSpec-Driven
5 pasos
  • Spec
  • Plan
  • Tareas
  • Implementar
  • Checks
ODDOrganic Driven
3 pasos
  • Notas de contexto
  • Implementar
  • Checks
PCDDProgressive Change-Driven
6 pasos
  • 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

SDDSpec-Driven
5 pasos
  • Spec
  • Plan
  • Tareas
  • Implementar
  • Checks
ODDOrganic Driven
3 pasos
  • Notas de contexto
  • Implementar
  • Checks
PCDDProgressive Change-Driven
7 pasos
  • 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
Dale una estrella en GitHub