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](quality/quality-gates.md), usa los [QC checklists](quality/qc-checklists.md), revisa cambios generados por IA con [AI Output Review](quality/ai-output-review.md), y toma failure modes del [general edge case catalogue](quality/edge-cases/general.md).
## 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](prompts/) — **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.
| Fase | Prompts |
|---|---|
| **(P)** Plan | [Definición de Alcance](prompts/plan/scope-definition.md) · [Borrador de Arquitectura](prompts/plan/architecture-draft.md) · [Evaluación de Riesgos](prompts/plan/risk-assessment.md) · [Esquema de Base de Datos](prompts/plan/database-schema-design.md) · [Contrato de API](prompts/plan/api-contract-design.md) · [Modelo de Amenazas de Seguridad](prompts/plan/security-threat-model.md) |
| **(U)** Understand | [Análisis de Banco de Código](prompts/understand/codebase-analysis.md) · [Auditoría de Dependencias](prompts/understand/dependency-audit.md) · [Reconocimiento de Patrones](prompts/understand/pattern-recognition.md) · [Análisis de Registros de Fallos](prompts/understand/crash-log-analysis.md) |
| **(D)** Develop | [Implementación de Función](prompts/develop/feature-implementation.md) · [Test-Driven Dev (TDD)](prompts/develop/test-driven-dev.md) · [Andamiaje de Componentes](prompts/develop/component-scaffold.md) · [Suite de Pruebas de Integración](prompts/develop/integration-test-suite.md) · [Suite de Pruebas E2E](prompts/develop/e2e-test-suite.md) |
| **(O)** Optimize | [Revisión de Rendimiento](prompts/optimize/performance-review.md) · [Lista de Revisión de Código](prompts/optimize/code-review-checklist.md) · [Oportunidades de Refactorización](prompts/optimize/refactor-opportunities.md) · [Análisis de Perfil de Memoria](prompts/optimize/memory-profiling.md) · [Solución de Problemas de Red](prompts/optimize/network-troubleshooting.md) |
| **Skills** | [Arquitectura y Planificación](skills/plan/SKILL.md) · [Ingeniería de Software](skills/code/SKILL.md) · [Resolución de Problemas y Diagnóstico](skills/debug/SKILL.md) · [Ingeniería DevOps](skills/devops/SKILL.md) · [Ingeniería de Pruebas (Test)](skills/test/SKILL.md) |
| **Herramientas DevOps** | [GitHub Actions](skills/devops/github-actions/SKILL.md) · [GitLab CI](skills/devops/gitlab-ci/SKILL.md) · [Argo CD](skills/devops/argo-cd/SKILL.md) · [Jenkins](skills/devops/jenkins/SKILL.md) · [Terraform](skills/devops/terraform/SKILL.md) · [Docker](skills/devops/docker/SKILL.md) · [Kubernetes](skills/devops/kubernetes/SKILL.md) |
## 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](AGENTS.md), [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.md), [claude/CLAUDE.md](claude/CLAUDE.md), [.claude/settings.json](.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](cursor/.cursor/rules/pudo-core.mdc), [legacy .cursorrules](cursor/.cursorrules) | Prefiere `.cursor/rules/*.mdc`; conserva `.cursorrules` para versiones antiguas de Cursor | Migrado |
| **GitHub Copilot** | [.github/copilot-instructions.md](.github/copilot-instructions.md), [.github/instructions/](.github/instructions/) | Usa instrucciones de repositorio más archivos `.instructions.md` por ruta | Añadido |
| **OpenCode** | [opencode/opencode.md](opencode/opencode.md) | Añádelo a los system prompts o workspace instructions de OpenCode | OK |
| **Antigravity / Gemini-style** | [antigravity/instructions.xml](antigravity/instructions.xml) | Cópialo a `.gemini/antigravity/instructions.xml` en el workspace destino | OK |
| **Kiro** | [kiro/system-prompt.md](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](docs/philosophy.md) 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](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](https://github.com/sponsors/DongDuong2001)
- [Patreon](https://patreon.com/DongDuong2001)
- [Ko-fi](https://ko-fi.com/dongphuduong)
- [Buy Me a Coffee](https://buymeacoffee.com/lab68dev)
- **PayPal:** dongduong840@gmail.com
## Licencia
[MIT](LICENSE) — Úsalo, haz un fork, hazlo tuyo.
---
Deja de improvisar. Empieza con PUDO.
Plan → Understand → Develop → Optimize