¿Por qué fab?
Construir un script que interactúe con un LLM es sencillo. Ejecutar un flujo continuo de ingeniería de software de forma autónoma, segura y predecible no lo es: se requiere aislamiento del espacio de trabajo, validación formal, control humano entre etapas y protección del sistema anfitrión.
fab resuelve este ciclo de desarrollo estructurado (SDLC) localmente:
- Aislamiento por cambio en Git Worktrees: Cada unidad de trabajo se investiga e implementa en un
git worktree dedicado sobre la rama fab/<changeId>. La rama principal de tu repositorio nunca se ensucia con pruebas parciales o código roto.
- Sandbox estricto (
bwrap): En Linux, los comandos de herramientas (Execute, Script) se confinan mediante bubblewrap con sistema raíz en solo lectura, /tmp privado en memoria, namespaces desasociados (PID, IPC, UTS, red) y permisos de red por llamada (deny, ask, auto) o modo efímero --yolo.
- Puntos de control humano (Gates): El operador supervisa y aprueba transiciones clave: revisión de la unidad de cambio (
Gate 1), aprobación de la especificación técnica (Gate 2) y autorización de fusión (Gate 3).
- Validadores automáticos independientes: Tras la implementación, una batería de validadores de solo lectura (
code_review, security_audit, qa) audita el cambio en busca de regresiones, fallos de seguridad o suites rotas.
- Puerta de fusión protegida (Merge Gate): El comando
fab merge bloquea de forma preventiva la integración si existen validadores pendientes o con veredicto en fallo (fail), admitiendo --force únicamente ante decisión explícita.
- Conectores bidireccionales con Jira y GitHub: Importa requerimientos de Jira como señales, abre Pull Requests vinculados en GitHub, publica resúmenes de auditoría y actualiza el ticket con el resultado final.
- Libertad de modelos y agentes: Compatible con proveedores líderes (Anthropic, OpenAI, suscripciones de ChatGPT, Ollama/vLLM local), selección automática de modelos con clasificador (
-m auto), soporte de protocolos MCP con OAuth, y adaptadores para Claude Code, Codex, Antigravity (agy), Droid y Fake.
- Persistencia local sin dependencias externas: Todo el estado de workstreams, señales, cambios, actividades y auditoría reside en una base de datos SQLite local (
~/.fabrica/fabrica.db). Sin Redis, sin Docker ni servicios externos obligatorios.
Quickstart
1. Instalación
Vía npm (recomendado)
Se distribuye el paquete global @okuanb/fab:
# Canal de prelanzamiento (versión actual recomendada)
npm install -g @okuanb/fab@next
# Canal estable
npm install -g @okuanb/fab@latest
Vía script instalador (binario autónomo compilado)
Detecta automáticamente Linux (glibc) o macOS (x64 y ARM64), verifica la firma criptográfica y ubica el binario en ~/.local/bin/fab sin requerir Node.js ni Bun previos:
# Canal de prelanzamiento (RC actual)
curl -fsSL https://raw.githubusercontent.com/DarkCodePE/sw-factory/main/scripts/install.sh | sh -s -- --channel prerelease
# Canal estable
curl -fsSL https://raw.githubusercontent.com/DarkCodePE/sw-factory/main/scripts/install.sh | sh
(Asegúrate de tener ~/.local/bin en tu variable de entorno PATH).
Autoactualización (fab update)
Detecta el método de instalación original y actualiza a la última versión disponible:
fab update --check # Comprueba si hay actualizaciones sin tocar el sistema
fab update # Descarga e instala la última versión de tu canal
fab update --channel prerelease # Cambia explícitamente de canal (stable | prerelease)
2. Primer uso
fab ofrece tres modos de entrada según la tarea:
A. Exploración interactiva en terminal (fab tui)
Inicia una sesión conversacional con el agente en el repositorio actual:
fab tui
Presiona / para abrir la paleta de comandos, Tab para ajustar el esfuerzo de razonamiento, o Ctrl+O para alternar la vista de diffs.
B. Ejecución de una tarea puntual autónoma (fab exec)
Ejecuta el agente de código sin interfaz gráfica para scripting o correcciones rápidas:
fab exec "Corrige el test fallido en tests/auth.test.ts y ejecuta la suite" --auto medium
C. Flujo de fábrica desatendida (fab ws)
Configura un flujo organizado por señales y cambios con revisión humana:
# 1. Registrar y activar un workstream
fab ws create mi-app --repo /ruta/a/mi-repo --goal "Estabilizar suite de pagos"
fab ws state mi-app active
# 2. Agregar una señal técnica y realizar triage
fab signal add mi-app "Error en cálculo de IVA" --body "Devuelve 0 cuando el país es PE"
fab triage --all mi-app
# 3. Revisar y autorizar el change en la bandeja
fab inbox mi-app
fab review <activityId> approve
# 4. Investigar el problema (solo lectura) y aprobar el plan
fab run mi-app --once
fab inbox mi-app
fab review <activityId> approve
# 5. Implementar en rama fab/<changeId> y fusionar
fab run mi-app --once
fab merge <changeId>
Arquitectura
La arquitectura de fab desacopla las interfaces de usuario, la persistencia local, la orquestación concurrente de actividades y el confinamiento de ejecución:
여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗
