Forge

License: MIT Node Glama

Planificación estructurada, ejecución paralela y validación profunda para Claude Code.

Instalación

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

Qué hace

Forge convierte un objetivo vago en trabajo estructurado, validado y paralelo. Tú dices /forge add JWT auth with refresh tokens y él planifica, ejecuta en árboles de trabajo paralelos, valida profundamente, reintenta de forma inteligente y aprende para la próxima vez.

Planifica — descompone las tareas en un grafo de dependencias de módulos
Ejecuta — trabajadores paralelos en árboles de trabajo de git aislados
Valida — comprobaciones de sintaxis, verificación de contratos de API, detección de estancamiento
Reintenta — agente depurador con análisis de causa raíz en caso de fallos
Revisa — comprobaciones de corrección y seguridad con verificación de contratos
Aprende — guarda convenciones y patrones de fallo en la memoria
Reanuda — retoma donde lo dejaste después de un bloqueo

Uso

/forge add JWT authentication with refresh tokens
/forge-status
/forge-validate m2

Usa Forge para funciones de múltiples archivos, tareas que necesitan validación, cambios ambiciosos. Evítalo para ediciones rápidas o preguntas simples: usa Claude Code directamente.

Cómo funciona

┌─────────────────────────────────────────────────────────────┐
│  /forge "add JWT auth with refresh tokens"                   │
└──────────────────────────┬──────────────────────────────────┘
                           │
                           ▼
              ┌────────────────────────┐
              │    Forge Orchestrator   │
              │    skills/forge/SKILL   │
              └─────┬──────────────────┘
                    │
    ┌───────────────┼───────────────┬───────────────┐
    ▼               ▼               ▼               ▼
┌────────┐   ┌──────────┐   ┌──────────┐   ┌──────────┐
│Planner │   │ Worker   │   │ Reviewer │   │ Debugger │
│        │   │ (×N      │   │          │   │          │
│ Explore│   │ parallel)│   │ Security │   │ Root     │
│ codebase   │          │   │ + API    │   │ cause    │
│ → DAG  │   │ Isolated │   │ contract │   │ analysis │
│ plan   │   │ worktree │   │ checks   │   │ + logs   │
└────┬───┘   └────┬─────┘   └────┬─────┘   └────┬─────┘
     │            │               │               │
     └────────────┴───────┬───────┴───────────────┘
                          │
                          ▼
              ┌────────────────────────┐
              │     MCP Server         │
              │     (Node.js, 7 tools) │
              │                        │
              │  validate              │
              │  validate_plan         │
              │  memory_recall/save    │
              │  iteration_state       │
              │  forge_logs            │
              │  session_state         │
              └───────────┬────────────┘
                          │
                          ▼
              ┌────────────────────────┐
              │   .forge/ (persistent) │
              │                        │
              │   plans/    memory/    │
              │   iterations/  logs/   │
              │   state/               │
              └────────────────────────┘

4 agentes + 1 servidor MCP (7 herramientas) + 3 comandos de barra diagonal. Todo en markdown y Node.js — sin tiempo de ejecución personalizado.

Herramientas MCP

Herramienta	Qué hace
`validate`	Comprobaciones de sintaxis, contratos de API, análisis de estancamiento/velocidad/oscilación
`validate_plan`	Detección de ciclos en DAG, advertencias de superposición de archivos, validación de esquemas
`memory_recall`	Buscar en el proyecto y en la memoria global
`memory_save`	Persistir patrones aprendidos con deduplicación
`iteration_state`	Rastrear intentos de reintento por módulo
`forge_logs`	Consultar registros JSONL estructurados por ejecución, módulo, fase, gravedad
`session_state`	Guardar/cargar el estado de la sesión para la capacidad de reanudación

Desarrollo

Consulta CONTRIBUTING.md para la configuración de desarrollo, comandos de prueba y el proceso de PR. Consulta SECURITY.md para saber cómo informar vulnerabilidades de forma privada.

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

Documentación

Arquitectura — orquestador, agentes, servidor MCP, estado
Referencia de herramientas MCP — esquemas de entrada/salida para las 7 herramientas
Registro de cambios — notas de la versión

Funciona muy bien con

memem — Memoria persistente entre sesiones para Claude Code. Forge + memem es la combinación recomendada: forge planifica y ejecuta, memem recuerda lo que funcionó entre ejecuciones. Los patrones que forge guarda a través de memory_save aterrizan en el índice de recuperación de memem, por lo que la ejecución de la próxima semana comienza con las lecciones de la semana pasada ya cargadas.

Ver también

Vibereader — Noticias tecnológicas seleccionadas mientras Claude trabaja

Licencia

MIT — ver LICENSE

forge