Organic Driven Development (ODD) — Índice
Organic Driven Development (ODD)
Organic Driven Development (ODD) es el flujo de desarrollo que Gentle AI™ instala en los agentes de programación que ya usas. Parte de una idea concreta: el trabajo pequeño no debería necesitar un proceso de planificación, y el trabajo grande no debería perder su contexto entre sesiones.
Este curso reúne, ordena y explica todo lo que el repositorio del proyecto documenta sobre ODD. La información está dispersa entre la guía de uso, el texto que se instala en cada agente, los contratos compartidos, las tareas de diseño y el código en Go. Aquí se presenta como un solo recorrido, de los fundamentos a la aplicación en un proyecto real.
Curso no oficial. Este material es independiente y no está afiliado, patrocinado ni avalado por Gentle AI, Engram, Gentleman Programming ni Alan Buscaglia. Los nombres Gentle AI™ y Engram™ son marcas de Alan Buscaglia y se usan aquí de forma nominativa para referirse al proyecto, tal como permite su política de marcas. El software del proyecto se distribuye bajo licencia MIT. El repositorio oficial es Gentleman-Programming/gentle-ai.
A quién está dirigido
- Personas que programan con agentes como Claude Code, Codex, OpenCode, Cursor o Pi y quieren entender qué hace ODD cuando se instala Gentle AI.
- Líderes técnicos que evalúan cómo coordinar trabajo con agentes sin imponer un proceso pesado a cada cambio.
- Quienes diseñan su propio arnés de agentes y buscan un caso documentado de reglas de enrutamiento, verificación y memoria.
- Quienes venían usando SDD u OpenSpec en Gentle AI y necesitan entender qué lo reemplazó en la versión 4.
Se asume experiencia básica con Git, pruebas automatizadas y algún agente de programación. No se requiere conocer Go: el código se cita solo para confirmar lo que hace el sistema.
Versión que describe este curso
| Referencia | Valor |
|---|---|
| Fuente | Rama main de Gentleman-Programming/gentle-ai |
| Commit revisado | f1c35b4 (6 de noviembre de 2026) |
| Última versión publicada en esa fecha | v4.3.1 |
| ODD como único flujo | Desde v4.0.0 |
La documentación del proyecto advierte que sigue a main, que puede incluir cambios no publicados. Este es un proyecto muy activo, de modo que números, comandos y modelos pueden cambiar. Ante una diferencia, la referencia vigente es el repositorio.
Cómo se resolvieron las contradicciones de la fuente
Algunas páginas de la documentación quedaron atrás respecto del código. Cuando dos fuentes difieren, este curso aplica este orden de precedencia y avisa en el capítulo correspondiente:
flowchart LR
A["Código en Go"] --> B["Texto instalado<br/>routing.go y secciones compartidas"]
B --> C["Contrato de revisión<br/>review-integration.md"]
C --> D["Guías generales<br/>usage.md, README, agents.md"]Las diferencias detectadas se resumen en el capítulo 22.
Mapa del curso
flowchart LR
subgraph M1["Módulo 1 · Fundamentos"]
C1["01 Qué es ODD"] --> C2["02 Principios"] --> C3["03 El protocolo"]
end
subgraph M2["Módulo 2 · El protocolo paso a paso"]
C4["04 Autorizar"] --> C5["05 Explorar e incertidumbre"] --> C6["06 Tamaño y riesgo"] --> C7["07 Documento de feature"] --> C8["08 Test-first"] --> C9["09 Cerrar y continuar"]
end
subgraph M3["Módulo 3 · Enrutamiento"]
C10["10 Rutas y presupuestos"] --> C11["11 Disparadores"] --> C12["12 Escritores paralelos"] --> C13["13 Verificación"] --> C14["14 Los tres roles"]
end
subgraph M4["Módulo 4 · Entrega y revisión"]
C15["15 Commits y entrega"] --> C16["16 RDD y ODD"]
end
subgraph M5["Módulo 5 · Práctica"]
C17["17 Memoria"] --> C18["18 Runtimes"] --> C19["19 Instalar y operar"] --> C20["20 Casos reales"] --> C21["21 Caso guiado"] --> C22["22 Evidencia"] --> C23["23 Antipatrones"]
end
C3 --> C4
C9 --> C10
C14 --> C15
C16 --> C17Contenido
Módulo 1 · Fundamentos
| Capítulo | Tema | Qué te llevas |
|---|---|---|
| 01 | Qué es ODD y de dónde viene | Gentle AI, el retiro de SDD y qué agrega ODD realmente |
| 02 | Los principios | Las ideas que explican cada regla posterior |
| 03 | El protocolo en siete pasos | La vista completa antes de entrar al detalle |
Módulo 2 · El protocolo paso a paso
| Capítulo | Tema | Qué te llevas |
|---|---|---|
| 04 | Autorizar | Distinguir una pregunta de un encargo de cambio |
| 05 | Explorar y resolver incertidumbre | Investigación opcional, una pregunta y un desafío de supuestos |
| 06 | Tamaño de tarea y riesgo | La prueba de reanudación, los seis puntos de alto riesgo y la línea Risk |
| 07 | El documento de feature | ## Specs, ## Tasks, ## Log y el traspaso por referencia |
| 08 | Test-first | RED, GREEN, PRESERVE, REFACTOR y la comprobación diferencial |
| 09 | Cerrar y continuar | Estados públicos, continuidad y Needs your decision |
Módulo 3 · Enrutamiento
| Capítulo | Tema | Qué te llevas |
|---|---|---|
| 10 | Rutas y presupuestos | Inline o delegado, y los límites de evidencia |
| 11 | Disparadores de delegación | Delegar por un motivo con nombre |
| 12 | Escritores paralelos | Superficies de edición, invariantes y comprobación de costura |
| 13 | Verificación por riesgo | Niveles, límites de corrección y severidad |
| 14 | Explorador, worker y verificador | El contrato de cada subagente y sus modelos |
Módulo 4 · Entrega y revisión
| Capítulo | Tema | Qué te llevas |
|---|---|---|
| 15 | Commits por unidad de trabajo | Estrategias de entrega y PR encadenados |
| 16 | RDD y su relación con ODD | review assess, las 4R, el consentimiento y el interruptor |
Módulo 5 · Práctica
| Capítulo | Tema | Qué te llevas |
|---|---|---|
| 17 | Memoria y reanudación | El espejo en Engram y el orden para retomar |
| 18 | ODD en cada runtime | Qué cambia entre agentes y el caso de Pi |
| 19 | Instalar y operar | Instalación, sincronización y diagnóstico |
| 20 | Casos reales del repositorio | Documentos de feature auténticos analizados |
| 21 | Caso guiado de principio a fin | Tres pedidos, tres recorridos distintos |
| 22 | Evidencia y lecciones | Benchmarks, pruebas y diferencias en la documentación |
| 23 | Antipatrones y evaluación final | Lista de control y examen de cierre |
Cómo trabajar el curso
- Lee el módulo 1 completo: da el vocabulario que usan todos los demás.
- Cada capítulo cierra con una actividad, preguntas de autoevaluación con respuestas y una lista de control.
- Si instalaste Gentle AI, compara lo que lees con el bloque
## Implementation Routingque quedó en la configuración de tu agente. - Usa los casos reales como modelo cuando escribas tu primer documento de feature.
Cursos relacionados en este sitio
- Engram: la memoria persistente que usa ODD para reanudar trabajo.
- Harness Engineering y Learn Harness Engineering: el marco general en el que se ubica un arnés como este.
- OpenSpec y GitHub Spec-Kit: enfoques basados en especificaciones, útiles como contraste.
Vocabulario esencial
Los términos del protocolo se mantienen en inglés porque así aparecen en la configuración, los comandos y los archivos.
| Término | Significado |
|---|---|
| Parent | La sesión principal del agente: conversa contigo, decide las rutas y por defecto escribe el código |
| Worker o writer | Subagente que implementa una unidad acotada |
| Explorer | Subagente de solo lectura que devuelve un mapa |
| Verifier | Subagente de solo lectura que comprueba un cambio de alto riesgo |
| Inline | Trabajo que hace el propio parent, sin subagentes |
| Feature document | El archivo odd/tasks/<feature-name>.md de una tarea grande |
| Runtime | El agente concreto donde corre ODD, como Claude Code o Codex |
| Candidate | El cambio exacto que se somete a revisión nativa |
| RDD | Receipt-Driven Development, la revisión independiente descrita en el capítulo 16 |
| Engram | La memoria persistente donde se guarda la copia de recuperación |
Fuentes principales
Todas pertenecen al repositorio Gentleman-Programming/gentle-ai:
docs/usage.md, sección Organic Driven Development.docs/trigger-rules.md,docs/intended-usage.mdy elREADME.md.internal/components/agentguidance/routing.go: el texto canónico que se instala en cada agente.internal/assets/skills/_shared/odd-orchestrator-sections.mdy los demás contratos compartidos.internal/assets/opencode/agents/: las definiciones de explorador, worker y verificador.internal/assets/skills/work-unit-commits/yinternal/assets/skills/chained-pr/.docs/review-integration.md,docs/architecture/organic-rdd.mdydocs/architecture/the-organic-rdd-story.md.odd/tasks/: los documentos de feature reales del proyecto.- Notas de versión e issues públicos del repositorio.