gdd¶
Construye software con agentes de IA, puerta a puerta. El riesgo decide cuántas puertas pasa cada Change; las máquinas comprueban lo que se puede comprobar, y tú solo decides lo que necesita a una persona, en las menos sentadas posibles.
-
Aprender
De una carpeta vacía a un Change publicado en una media hora, y después el método en una página.
-
Hacer
Lanzar Changes, escribir escenarios, responder a la puerta de salida, adoptar un proyecto existente, arreglar lo que falla.
-
Consultar
Cada comando, clave de configuración, puerta, rol, stack y fichero. Exacto y completo.
-
Entender
Por qué puertas, cómo se mide el riesgo, qué protege a los agentes, por qué paras tan poco.
Aprender¶
Paso a paso, de cero a un Change publicado.
- Tu primer Change: prepara un proyecto, escribe y aprueba un escenario, lanza el Change y responde a su puerta de salida.
- GDD en una página: las fases, las puertas y el semáforo, con un diagrama de cada cosa.
Hacer¶
Guías para un objetivo que ya tienes.
El día a día
- Instalar gdd: el binario, los agentes y las herramientas que usan las puertas.
- Ejecutar un Change: créalo, lánzalo y síguelo en el Board.
- Escribir y aprobar escenarios: Gherkin, ejemplos ocultos y la puerta de escenarios (G1).
- Responder a la puerta de salida: OK, KO o polish en G4.
- Volver a poner en marcha un Change aparcado: la Decision Inbox, los relanzamientos y los conflictos de fusión.
Dar forma al trabajo
- Mapear y aprobar zonas rojas: dile a gdd qué rutas son arriesgadas.
- Explorar con un Spike: un presupuesto fijo, variantes lado a lado y un ADR.
- Ejecutar Changes en paralelo: el límite, los solapes y la cola de fusión.
Preparar y ajustar
- Llevar gdd a un proyecto existente: init, bootstrap y adopt.
- Elegir agentes y modelos: quién construye y quién revisa, por color.
- Ajustar las puertas: los comandos que ejecuta cada puerta, los límites y mutation testing.
- Publicar versiones y llevar un changelog: tags,
gdd release, CHANGELOG.md. - Ejecutar las puertas en CI: qué comprueba el workflow en cada pull request.
- Medir el trabajo: tokens, tiempo de flujo, DORA y Learn.
- Actualizar gdd en un proyecto: versiones nuevas de los ficheros que escribió gdd.
- Solución de problemas: síntomas, causas y soluciones.
Consultar¶
Exacto y completo. La referencia de comandos se genera a partir del código.
- Referencia de comandos: todos los comandos de
gddy sus opciones. - Configuración: cada fichero de
gdd/y cada clave. - Puertas: qué comprueba cada puerta, quién decide y sus límites, por color.
- Roles: la persona, el Orchestrator, el Builder y el Reviewer.
- Stacks: las fichas de Python, Rust y TypeScript.
- Ficheros que escribe gdd: registros, el log, la Decision Inbox y las salidas.
- Variables de entorno: qué lee gdd y qué les da a los agentes.
- Glosario: las palabras que usan estas páginas.
Entender¶
Por qué GDD funciona como funciona.
- GDD en una página: fases, puertas, colores y roles.
- La vida de un Change: cada paso de un lanzamiento, en orden.
- Cómo elige el riesgo las puertas: el semáforo y por qué gana el color.
- Mantener honestos a los agentes: Path Guard, los ejemplos ocultos y lo que los agentes no pueden tocar.
- Pocas paradas para la persona: sentadas, polish y por qué hecho no es bueno.
- Medir lo que importa: tokens, DORA y la regla de abandono.
- Decisiones de diseño: qué se eligió y qué no.
Este proyecto, construido con GDD¶
gdd se construye con GDD, así que sus propios ficheros de GDD son ejemplos reales de cada artefacto (en inglés):
- Las reglas completas del método y la hoja de ruta.
- Brief del proyecto, estándares, decisiones y notas de Discover.
- Escenarios: la especificación ejecutable de gdd.
Contribuir¶
- Cómo contribuir: prepara el entorno, prueba y envía tu contribución.
- Escribir la documentación: cómo se organizan y se escriben estas páginas.
- Changelog.