pudo-code-system
Una metodología estructurada de 4 fases para programar con asistentes de IA.
🌍 Idiomas: English | Tiếng Việt | Português | Español | Русский
🎥 Watch the PUDO Code System overview video
El Problema
Abres tu editor. Escribes una solicitud vaga a tu asistente de IA. Este genera algo. Lo pegas. Funciona a medias. Pides una corrección. Rompe otra cosa. Repites el proceso durante 3 horas.
Esto es la programación del caos. Parece productivo, pero no lo es.
El problema no es la IA — es la falta de estructura. Sin una metodología clara, el desarrollo asistido por IA se convierte en un paseo aleatorio por tu base de código.
La Solución: PUDO
PUDO te ofrece un ciclo repetible de 4 fases que convierte a la IA de una máquina tragamonedas en una herramienta de precisión.
| Fase | Objetivo | Tú Haces | La IA Hace |
|---|---|---|---|
| (P) Plan (Planificar) | Definir qué y por qué | Establecer alcance, restricciones, criterios de éxito | Redactar plan de implementación, identificar riesgos |
| (U) Understand (Entender) | Saber dónde y cómo | Señalar código relevante, explicar contexto | Analizar la base de código, mapear dependencias, buscar patrones |
| (D) Develop (Desarrollar) | Construir eso | Revisar, aprobar, probar | Escribir código, ejecutar pruebas, seguir el progreso |
| (O) Optimize (Optimizar) | Hacerlo mejor | Validar mejoras, integrar (merge) | Refactorizar, hacer benchmark, documentar cambios |
Concepto clave: PUDO es un ciclo, no un proceso lineal (pipeline). Vuelves a visitar las fases a medida que aprendes más. Un descubrimiento en el Desarrollo podría enviarte de vuelta a la Planificación. Eso es lo esperado.
Puertas de Calidad
Cada fase termina con una puerta de control. No avances hasta que esa puerta pase, o hasta que el riesgo haya sido aceptado de forma explícita.
| Puerta | Se ejecuta antes de | Debe demostrar |
|---|---|---|
| Plan Gate | Understand | El alcance, los criterios de éxito, las restricciones y lo que queda fuera de alcance están claros |
| Understand Gate | Develop | Los archivos relevantes, la arquitectura, las APIs y los patrones fueron verificados |
| Develop Gate | Optimize | La implementación se mantiene dentro del alcance, tiene pruebas y cubre los casos límite principales |
| Optimize Gate | Release | Los refactors no cambian el comportamiento; rendimiento, seguridad, documentación y riesgos fueron revisados |
| Release Gate | Merge/deploy | Changelog, migración, rollback, monitoreo y aprobación del owner fueron cubiertos |
Empieza con Quality Gates, usa los QC checklists, revisa cambios generados por IA con AI Output Review, y toma failure modes del general edge case catalogue.
Impacto Esperado
Estos números son estimaciones prácticas orientativas, no garantías. El beneficio depende del tamaño de la tarea, de la calidad del repositorio y de qué tan consistentemente el equipo siga PUDO.
| Tipo de tarea | Reducción de token desperdiciado | Reducción del tiempo de desarrollo |
|---|---|---|
| Arreglo de una línea / script pequeño | 0-8% | -5% a +5% |
| Función pequeña o mediana | 25-38% | 12-20% |
| Bug difícil / incidente de producción | 22-35% | 10-18% |
| Función con muchos archivos / pruebas / handoff de equipo | 35-48% | 18-28% |
| Promedio práctico para comunicar | 34% | 18% |
Inicio Rápido
1. Comienza con la Planificación (Plan)
Antes de escribir cualquier código, define lo que estás construyendo:
Necesito construir [FUNCIÓN].
Los criterios de éxito son [CRITERIOS].
Las restricciones son [RESTRICCIONES].
Crea un plan de implementación antes de escribir código.
2. Pasa al Entendimiento (Understand)
Investiga antes de construir:
Antes de implementar, analiza el código existente:
- ¿Qué patrones ya están establecidos?
- ¿Qué dependencias están involucradas?
- ¿Qué se podría romper?
3. Ejecuta en el Desarrollo (Develop)
Construye con estructura:
Implementa el plan. Sigue el progreso con una lista de tareas (checklist).
Escribe pruebas junto a la implementación.
Señala cualquier desviación del plan.
4. Cierra con la Optimización (Optimize)
No lances el primer borrador:
Revisa la implementación:
- ¿Hay mejoras de rendimiento?
- ¿Es el código consistente con los patrones existentes?
- Escribe un resumen (walkthrough) explicando qué cambió y por qué.
5. Repite
Para cada tarea, cada función, cada corrección de errores. Plan → Understand → Develop → Optimize.
Biblioteca de Prompts
PUDO viene con una biblioteca de prompts lista para usar — 21 prompts a lo largo de 4 fases y habilidades de dominio que puedes copiar y pegar en cualquier asistente de IA. Cada directorio de fase incluye un README.md detallado que explica cómo modificar y extender los prompts para las necesidades de tu equipo.
Integraciones con IA
PUDO está diseñado para ser el sistema operativo por defecto de los agentes de programación con IA. Conviene usar el formato de configuración actual de cada herramienta y mantener los archivos legacy cuando todavía sirvan para workspaces antiguos.
| Herramienta | Archivos actuales | Configuración recomendada | Estado |
|---|---|---|---|
| Codex | AGENTS.md, codex/AGENTS.md | Mantén AGENTS.md en la raíz; copia codex/AGENTS.md al repositorio destino cuando necesites una plantilla de Codex más completa |
OK |
| Claude Code / Projects | CLAUDE.md, claude/CLAUDE.md, .claude/settings.json | Usa CLAUDE.md en la raíz como archivo puente; conserva el flujo detallado de Claude en claude/CLAUDE.md |
Actualizado |
| Cursor | Project Rules, legacy .cursorrules | Prefiere .cursor/rules/*.mdc; conserva .cursorrules para versiones antiguas de Cursor |
Migrado |
| GitHub Copilot | .github/copilot-instructions.md, .github/instructions/ | Usa instrucciones de repositorio más archivos .instructions.md por ruta |
Añadido |
| OpenCode | opencode/opencode.md | Añádelo a los system prompts o workspace instructions de OpenCode | OK |
| Antigravity / Gemini-style | antigravity/instructions.xml | Cópialo a .gemini/antigravity/instructions.xml en el workspace destino |
OK |
| Kiro | kiro/system-prompt.md | Úsalo como system prompt de Kiro | OK |
Filosofía
PUDO no es solo una lista de verificación — es una mentalidad. Lee la filosofía completa para entender los principios detrás del método.
Resumen (TL;DR):
- Anti-caos — La estructura supera a la improvisación a escala.
- Iterativo — Es un ciclo, no una cascada.
- Nativo para IA — Diseñado para la programación en pareja entre humanos e IA.
- Integridad de fase — Cada fase tiene criterios claros de entrada y salida.
Cuándo No Usar PUDO
PUDO puede ser excesivo para arreglos de una sola línea, prototipos desechables, exploración pura o scripts no críticos. Usa el ciclo completo cuando importen la corrección, la mantenibilidad, la seguridad o la transferencia de trabajo en equipo.
Limitaciones Actuales
- PUDO no garantiza que la salida de la IA sea correcta.
- La revisión humana sigue siendo obligatoria.
- Los cambios sensibles de seguridad siguen necesitando una revisión de seguridad dedicada.
- Los ejemplos son ilustrativos, no universales.
- El método requiere disciplina; si saltas las quality gates vuelves al prompting ad hoc.
¿Para Quién Es Esto?
- Desarrolladores usando asistentes de IA (ChatGPT, Claude, Gemini, Copilot, etc.) que desean mejores resultados.
- Líderes de equipo que buscan una metodología compartida para el desarrollo asistido por IA.
- Estudiantes que aprenden a programar con IA de la manera correcta desde el primer día.
Contribuir
PUDO crece con la comunidad. Mira CONTRIBUTING.md para saber cómo:
- Añadir nuevos prompts a la biblioteca.
- Enviar ejemplos prácticos (walkthroughs).
- Mejorar la documentación.
Soporte y Financiación
Si encuentras útil a PUDO, considera apoyar el proyecto:
- GitHub Sponsors
- Patreon
- Ko-fi
- Buy Me a Coffee
- PayPal: dongduong840@gmail.com
Licencia
MIT — Úsalo, haz un fork, hazlo tuyo.
Deja de improvisar. Empieza con PUDO.
Plan → Understand → Develop → Optimize