Tutorial: Implementando Gas Town y Beads (Orquestación Multi-Agente Real)

¡Hola, equipo! Aquí El Equipo PAI. Hoy vamos a dejar los juguetes de lado.

Han escuchado el hype: "Agentes que codifican solos". La realidad suele ser un script de Python frágil que se rompe al segundo loop. Pero Gas Town es diferente. Creado por el legendario ingeniero Steve Yegge, no es una simple demo; es una arquitectura de "fuerza bruta" inteligente que usa Git como sistema de archivos y Beads como memoria persistente.

En este Manual de Laboratorio, no vamos a filosofar. Vamos a levantar una infraestructura donde un Alcalde (Mayor) coordina a 20+ Gatos (Polecats) para programar en paralelo. Como mencionan los expertos, Gas Town es una nueva visión del IDE para 2026, pero requiere manos expertas.

⚠️ Advertencia de Senior: Esto es Vibe Coding extremo. Maggie Appleton advierte que este enfoque quema tokens como si no hubiera un mañana. Úsalo para aprender o en proyectos con presupuesto, no en tu side-project gratuito.

---

1. El Objetivo: Tu propia Fábrica de Software

Al final de esta guía, tendrás una CLI operativa donde podrás decir: "Refactoriza el módulo de autenticación", y el sistema:

1. Planificará: El Alcalde descompondrá la tarea en sub-tareas usando Beads.
2. Paralelizará: Asignará agentes (Polecats) en paralelo.
3. Aislará: Cada agente trabajará en su propio Git Worktree (sin colisiones).
4. Integrará: La Refinería mergeará el trabajo automáticamente.

Tu terminal se verá algo así:

bash

---

2. Prerrequisitos

Necesitas esto instalado AYER:

• Go (1.21+): El motor de Gas Town está escrito en Go.
• Node.js & NPM: Para herramientas auxiliares.
• Git: Es el sistema nervioso central.
• API Keys de Anthropic: Gas Town está optimizado para Claude Code.
• Una billetera valiente: Monitoriza tus costos en tiempo real.

---

3. Paso a Paso (The Guide)

Paso 1: Instalar el Cerebro (Beads)

Gas Town no funciona si los agentes no tienen memoria. Beads reemplaza los archivos .md desordenados con una estructura de datos basada en grafos dentro de Git. Es, esencialmente, una actualización de memoria para tu agente.

bash

💡 Lightbulb Moment: ¿Por qué Beads? Los agentes de IA normales pierden el contexto o llenan la ventana de tokens releyendo todo el historial. Beads guarda el estado en archivos JSON pequeños (bd-xc21.json). Si un agente crashea, el siguiente lee el JSON y sigue exactamente donde se quedó. Persistencia barata y a prueba de fallos.

Paso 2: Configurar las "Reglas del Juego" (AGENTS.md)

Los agentes necesitan contexto. No asumas que saben qué hacer. Crea un archivo AGENTS.md en la raíz. Según la documentación de Gas Town Hall, definir roles claros es vital.

markdown

Paso 3: Instalar Gas Town (La Maquinaria)

Ahora traigamos a los trabajadores. Gas Town actúa como un gestor de espacio de trabajo multi-agente.

bash

Paso 4: Desplegar la Ciudad (Configuración)

Gas Town necesita saber qué modelos usar. La jerarquía de roles es una de sus fortalezas clave:

• Mayor (Alcalde): Planifica y divide tareas (Usa modelos inteligentes como Opus).
• Polecat (Gato): Ejecuta el código (Modelos rápidos como Haiku/Sonnet).
• Witness (Testigo): Verifica y testea.

Crea tu config.json:

json

Paso 5: Ejecución (El Ciclo GUPP)

Aquí es donde ocurre la magia. Vamos a simular el flujo.

bash

💡 Lightbulb Moment: Git Worktrees. Gas Town no clona el repo 20 veces. Usa git worktree add, que crea copias de trabajo vinculadas al mismo repo local. Esto permite que el Polecat 1 edite auth.ts y el Polecat 2 edite database.ts simultáneamente sin bloquearse mutuamente por archivos .lock.

---

4. Reality Check: Dónde vas a sufrir

1. Costos de "Vibe Coding": Es fácil lanzar un comando y gastar $200 en una hora. Algunos críticos advierten que el 99% de los desarrolladores no deberían usar esto sin supervisión estricta.
2. Merge Conflicts en la Refinería: Aunque usen worktrees, si dos agentes tocan las mismas líneas, habrá conflicto. La Refinería (el componente de merge) puede fallar. Revisa los PRs manualmente al principio.
3. Alucinación de Dependencias: A veces el Alcalde crea dependencias circulares en los Beads. Revisa con bd show si ves que nadie trabaja.

---

5. Siguientes Pasos

Ya tienes la infraestructura básica. ¿Cómo llevar esto a "Producción"?

• Automatiza el Triage: Conecta un script que lea Issues de GitHub y use al Alcalde para convertirlos en Beads automáticamente.
• Define "Wisps" (Recetas): Crea runbooks estándar para tareas repetitivas. Los agentes funcionan 10x mejor con plantillas.
• Observabilidad: Instala un dashboard. Sin ojos en el sistema, es una caja negra de dinero.

Gas Town es el futuro (a medio construir), pero entender Beads y Worktrees te pone años luz por delante del dev promedio.

✅ Próximos pasos: Si quieres profundizar en cómo los agentes autónomos están cambiando el desarrollo, lee nuestro artículo sobre más allá del chatbot: agentes que actúan.

¡A codificar (o dejar que ellos codifiquen)! 🚀