Instalar gdd¶

Instala el binario gdd, al menos un agente de programación que pueda manejar y las herramientas que ejecutan las puertas de tu stack. Al final compruebas que las tres cosas están en su sitio.

Antes de empezar¶

• Linux o macOS. gdd ejecuta sus puertas con sh y los agentes en worktrees de git.
• git.
• Rust 1.98 o posterior, para compilar gdd. rustup update pone al día un toolchain más antiguo.

gdd 0.1.0 solo se instala con cargo. Los binarios precompilados, crates.io y Homebrew están en la hoja de ruta y todavía no están disponibles.

1. Instala el binario¶

Instala la versión etiquetada desde GitHub. Es el mismo comando que ejecuta el workflow de CI que escribe gdd init:

cargo install --locked --git https://github.com/MarsGotta/gdd --tag v0.1.0 gdd

cargo compila gdd y lo deja en ~/.cargo/bin, que rustup añade a tu PATH.

O compílalo desde el código fuente¶

Clona el repositorio e instala desde esa copia:

git clone https://github.com/MarsGotta/gdd
cd gdd
cargo install --locked --path crates/gdd

El repositorio fija su toolchain en rust-toolchain.toml, así que rustup descarga Rust 1.98.1 la primera vez que compilas en él. Para trabajar en el propio gdd, sigue CONTRIBUTING.md en su lugar: compila el binario que usan las puertas del propio proyecto.

Comprueba el binario¶

gdd --version

Deberías ver:

gdd 0.1.0

En un proyecto, gdd siempre se llama a través de bin/gdd, un script corto que escribe gdd init. Ese script ejecuta el gdd de tu PATH, o el binario que indique la variable GDD_BIN:

GDD_BIN=/home/me/src/gdd/target/release/gdd bin/gdd status

2. Instala un agente de programación¶

gdd no habla con ningún modelo por sí mismo. Arranca el programa de línea de comandos de cada agente de programación, en modo headless (sin interfaz), con los argumentos del rol que desempeña. Conoce tres agentes, cada uno con su ficha de datos:

Instala los que quieras siguiendo sus propias instrucciones e inicia sesión en cada uno una vez, de forma interactiva. gdd usa esas sesiones (sirve una suscripción). Nunca entrega tus claves de API a un agente: quita del entorno del agente toda variable cuyo nombre contenga una palabra como KEY, TOKEN, SECRET o PASSWORD, y toda URL que lleve una contraseña, salvo que [env] pass en gdd/models.toml nombre esa variable a propósito. Variables de entorno tiene la regla completa.

Instala agentes de dos familias de modelos. El Reviewer tiene que ser de una familia distinta a la del Builder, para que no comparta sus puntos ciegos: por ejemplo, Claude Code para construir y Codex para revisar. Con una sola familia, gdd init se niega y te dice qué hacer:

error: one model family only (anthropic): the Reviewer would share the Builder's blind spots. Install an agent of another family (OpenCode takes models from many providers) or run again with --accept-same-family.

gdd init --agents indica los agentes de un proyecto; el primero es el que construye. Sin esa opción, init toma los que encuentra en el PATH. Elegir agentes y modelos explica cómo cambiarlos más adelante.

3. Instala las herramientas de tu stack¶

Cada ficha de stack indica los comandos que ejecutan sus puertas. Algunas herramientas llegan con las dependencias del propio proyecto, que instala gdd bootstrap; las demás tienen que estar en tu PATH.

Python¶

Rust¶

El mutation testing en Rust enlaza con mold cuando está instalado, y limita cada proceso de test con prlimit donde existe (Linux). Los dos son opcionales.

TypeScript¶

gdd stacks show NAME imprime la ficha completa de un stack, con todos los comandos que ejecutan sus puertas. La referencia de stacks las recoge todas.

4. Comprueba la instalación¶

Las comprobaciones que leen una ficha de stack se ejecutan dentro de un proyecto GDD. Crea uno de usar y tirar:

mkdir notes && cd notes
git init -b main
gdd init --name notes --platform cli --stack python --agents claude codex
bin/gdd bootstrap

gdd init lista todos los ficheros que ha escrito y hace commit de ellos; gdd bootstrap instala las dependencias del stack y hace commit del fichero de bloqueo (lock file). Después comprueba cada pieza:

bin/gdd stacks
bin/gdd agents check
bin/gdd selftest

Deberías ver:

python · Python · pytest-bdd
rust · Rust · cucumber-rs
typescript · TypeScript · cucumber-js
{"ok":true}
OK a failing test turns G2 red
OK editing a protected file is blocked (Path Guard and CI)
OK rollback works in pre (simulated)
OK zero scenarios counts as a failure
harness 4/4

• gdd stacks lista las fichas de stack que trae gdd.
• gdd agents check confirma que los comandos de GDD de la carpeta de cada agente son los que escribe gdd.
• gdd selftest demuestra que el arnés funciona: un test que falla pone G2 en rojo, Path Guard bloquea un fichero protegido, el rollback funciona en pre y cero escenarios hacen fallar G3. Cualquier resultado que no llegue a harness 4/4 nombra la comprobación que ha fallado.

El autotest no ejecuta todos los comandos de las puertas. El primer Change que lances es la prueba real de las herramientas del paso 3: si falta alguna, aparece como una puerta fallida en su Decision Inbox.

Siguientes pasos¶

• Tu primer Change: prepara un proyecto y lleva un Change desde el escenario hasta la publicación.
• Llevar gdd a un proyecto existente: cuando la carpeta ya tiene código.
• Elegir agentes y modelos: qué agente y qué modelo desempeña cada rol.