Forge

Convierte Claude Code en un bucle de entrega estructurado: planifica el trabajo, ejecuta módulos en paralelo, valida profundamente, reintenta de forma inteligente y aprovecha lo que funcionó.

Instalación

Copia y pega:

claude plugin marketplace add TT-Wang/forge
claude plugin install forge@tt-wang-plugins

El primer inicio puede tardar unos segundos porque Forge arranca automáticamente las dependencias de su servidor MCP.

Después de la instalación:

1. reinicia Claude Code si ya estaba abierto

2. abre cualquier repositorio en el que quieras trabajar

3. ejecuta /forge <objetivo>

Ejemplo:

/forge add audit logging for admin actions

Related MCP server: KIA - Kaizen Intelligent Agent

La propuesta

Forge es para el punto en el que el prompting simple deja de ser suficiente.

Si la tarea afecta a varios archivos, necesita coordinación entre módulos o requiere pruebas de que realmente funciona, Forge le da a Claude Code un flujo de trabajo en lugar de solo otro prompt:

• divide el trabajo en módulos

• ejecuta lo que se pueda paralelizar

• valida cada módulo rigurosamente

• reintenta los fallos con contexto del depurador

• recuerda lo que funcionó para la siguiente tarea

Sigues usando Claude Code. Forge simplemente añade estructura alrededor de las partes difíciles.

Qué obtienes

• Planificación estructurada: divide una funcionalidad en módulos con dependencias y comandos de verificación

• Ejecución paralela: ejecuta módulos independientes al mismo tiempo en árboles de trabajo aislados

• Validación profunda: comprueba archivos, comandos, sintaxis y contratos de API entre módulos

• Reintento inteligente: rastrea intentos, detecta estancamiento y escala a un agente depurador

• Reanudación de sesiones: retoma el trabajo incompleto en lugar de empezar desde cero

• Memoria entre sesiones: recuerda convenciones, patrones de fallo y comandos de prueba

• Visibilidad del estado: expone el progreso en la salida de Claude y en una línea de estado del terminal

¿Por qué no usar Claude Code directamente?

Para muchas tareas, deberías hacerlo.

Forge no intenta reemplazar el uso normal. Es para las tareas donde la orquestación importa.

Inicio rápido

Configuración en 60 segundos

1. Instala Forge con los dos comandos anteriores

2. Reinicia Claude Code

3. Abre tu proyecto

4. Pega un objetivo:

/forge add JWT auth with refresh tokens

5. Aprueba el plan generado

Ejecución

/forge build an audit log for admin actions

Comprobar progreso

/forge-status

Volver a comprobar un módulo

/forge-validate m2

Una sesión típica

/forge add JWT auth with refresh tokens

[forge] Phase 1: Planning...
[forge] Proposed Plan: 4 modules, 2 parallel groups
[forge] Proceed with this plan? (yes / modify / abort)

[forge] Phase 2: Executing m1...
[forge] Phase 2: Executing m2, m3 in parallel...
[forge] ✓ m2: DONE — validated, score 1.0
[forge] ✗ m3: FAILED — retrying with debugger
[forge] ✓ m3: DONE — validated after retry

[forge] ## Forge Complete
[forge] 4/4 modules completed

Esa es la experiencia que busca Forge: menos dirección manual, más progreso visible y menos fallos silenciosos.

Qué esperar en la primera ejecución

• Forge creará un directorio local .forge/ en tu proyecto

• el servidor MCP puede tardar unos segundos en instalar sus dependencias de Node

• tu primera interacción real es el paso de revisión del plan

• no se ejecuta nada hasta que apruebes explícitamente el plan

Estructura actual del proyecto

forge/
├── .claude-plugin/
│   ├── plugin.json
│   └── marketplace.json
├── .claude/
│   ├── settings.json
│   └── settings.local.json
├── agents/
│   ├── planner.md
│   ├── worker.md
│   ├── reviewer.md
│   └── debugger.md
├── skills/
│   ├── forge/
│   │   └── SKILL.md
│   ├── forge-status/
│   │   └── SKILL.md
│   └── forge-validate/
│       └── SKILL.md
├── forge-mcp-server/
│   ├── index.mjs
│   ├── start.sh
│   ├── package.json
│   └── tests/
├── statusline/
│   └── forge-status.sh
├── docs/
│   ├── architecture.md
│   ├── mcp-tools.md
│   └── launch/
├── CHANGELOG.md
├── CONTRIBUTING.md
├── SECURITY.md
├── CLAUDE.md
└── README.md

En tiempo de ejecución, Forge también crea un directorio local .forge/ en el proyecto de trabajo para almacenar planes, registros, memoria, historial de reintentos y estado reanudable.

Las piezas principales

Agentes

Forge incluye cuatro agentes especializados:

• planner: explora el código base y propone el plan de módulos

• worker: implementa un módulo en un árbol de trabajo aislado

• reviewer: comprueba la corrección, seguridad y discrepancias de contrato

• debugger: investiga módulos fallidos y gestiona el reintento

Comandos

Los comandos orientados al usuario son:

• /forge: flujo de trabajo del orquestador completo

• /forge-status: plan actual, progreso del módulo y patrones aprendidos

• /forge-validate: volver a ejecutar la validación para un módulo

Servidor MCP

El servidor MCP incluido proporciona las capacidades de tiempo de ejecución compartidas que Forge necesita:

• validate

• validate_plan

• memory_recall

• memory_save

• iteration_state

• forge_logs

• session_state

Estas herramientas permiten que múltiples agentes se coordinen sin depender de una memoria conversacional dispersa.

Línea de estado

Forge puede mostrar el progreso en vivo en tu terminal:

[forge] ████░░░░░░ 2/5 | VALIDATE | refresh endpoint | 3m19s | ~2m30s left

Para usarla:

claude statusline set "bash /path/to/forge/statusline/forge-status.sh"

Qué reside en tu proyecto

Forge mantiene su estado de ejecución en un directorio local .forge/ dentro del proyecto de trabajo. Eso incluye:

• planes de ejecución

• historial de reintentos

• patrones aprendidos

• registros estructurados

• estado de sesión reanudable

Esto mantiene el flujo de trabajo inspeccionable en lugar de ocultar todo detrás de un estado de agente opaco.

Documentación

• Arquitectura — orquestador, agentes, servidor MCP y flujo de estado

• Referencia de herramientas MCP — esquemas de entrada/salida y ejemplos para las 7 herramientas

• Registro de cambios — notas de la versión

• Contribución — configuración de desarrollo, pruebas, linting y proceso de PR

• Seguridad — reporte de vulnerabilidades y alcance de seguridad

Instalación manual

Si no quieres instalar desde el marketplace de Claude Code, puedes configurar Forge manualmente:

git clone https://github.com/TT-Wang/forge.git /tmp/forge
mkdir -p .claude/agents .claude/skills
cp /tmp/forge/agents/*.md .claude/agents/
cp -r /tmp/forge/skills/* .claude/skills/
cp -r /tmp/forge/forge-mcp-server ./forge-mcp-server/
cd forge-mcp-server && npm install && cd ..

Luego conecta el servidor MCP usando la configuración de referencia en .claude/settings.json.

Desarrollo

git clone https://github.com/TT-Wang/forge.git
cd forge/forge-mcp-server
npm install
npm test

Funciona muy bien con

• memem — memoria persistente entre sesiones para Claude Code. Forge maneja la planificación y ejecución; memem ayuda a llevar patrones útiles entre ejecuciones.

• Vibereader — noticias tecnológicas seleccionadas mientras Claude trabaja

Licencia

MIT — ver LICENSE