Lab 06 — Dry Run & Preview

Usa el modo dry-run para analizar y planificar cambios sin ejecutar ninguna escritura. Ideal como fase de revisión previa o pre-check en CI.

Setup

Nivel: Básico

Duración estimada: 10 minutos. Feature principal: --dry-run.

mkdir -p ~/architect-labs/lab-06 && cd ~/architect-labs/lab-06
git init && mkdir -p src

src/api.py

from flask import Flask, jsonify

app = Flask(__name__)

@app.route("/health")
def health():
    return jsonify({"status": "ok"})

@app.route("/users")
def get_users():
    return jsonify([{"id": 1, "name": "Alice"}])

.architect.yaml

llm:
  model: openai/gpt-4.1
  api_base: http://localhost:4000/v1
  api_key_env: LITELLM_API_KEY

git add -A && git commit -m "initial"

Ejercicio 1: Dry run básico

architect run "Añade endpoints CRUD completos para users: \
  GET /users/:id, POST /users, PUT /users/:id, DELETE /users/:id. \
  Añade validación de input y manejo de errores." \
  --config .architect.yaml \
  --dry-run

Qué observar:

Architect analiza los archivos, planifica los cambios, pero NO escribe nada
Muestra un plan de ejecución: qué archivos tocaría, qué funciones añadiría
Ningún archivo se modifica

# Verificar que nada cambió
git status
# -> nothing to commit, working tree clean

Consejo

El dry-run es equivalente a terraform plan: te permite ver el impacto de los cambios antes de aplicarlos. Úsalo siempre antes de tareas grandes o en entornos sensibles.

Ejercicio 2: Dry run como fase de revisión

Usa dry-run para evaluar antes de ejecutar:

# Paso 1: Preview
architect run "Refactoriza src/api.py separando rutas en blueprints \
  y creando modelos con SQLAlchemy" \
  --config .architect.yaml \
  --dry-run \
  --report-file preview.json

# Paso 2: Revisar el plan
cat preview.json | python -m json.tool

# Paso 3: Si te gusta, ejecutar de verdad
architect run "Refactoriza src/api.py separando rutas en blueprints \
  y creando modelos con SQLAlchemy" \
  --config .architect.yaml \
  --confirm-mode yolo

Importante

El patrón dry-run → revisar → ejecutar es especialmente útil en CI/CD. El reporte JSON del dry-run puede ser analizado programáticamente para decidir si se aprueba la ejecución real.

Resumen

Concepto	Descripción
`--dry-run`	Planifica sin ejecutar escrituras
Uso típico	Pre-check antes de lanzar en CI, o review de impacto

Siguiente lab

Lab 07: Ralph Loop — El corazón de la automatización autónoma: fix → test → verify.