JSPM

Configura cualquier proyecto para trabajar con agentes de IA en un solo comando

Un equipo de agentes, todos los runtimes — Claude Code · OpenCode · Codex CLI · Kiro desde un único project.yaml.

Landing   •   Documentación   •   npm   •   Issues

npx @cristiancorreau/forge init

_{El panel interactivo de forge (forge panel) requiere Bun (OpenTUI) — explora agentes, skills, hooks y profiles sin salir de la terminal.}

¿Qué es forge?

forge es un framework de agentic development multi-runtime. Un solo comando analiza tu proyecto, instala un equipo de agentes especializados, cablea guardrails de seguridad y deja un project.yaml como única fuente de verdad desde la que se regenera la configuración nativa de cada runtime de IA.

En vez de copiar y pegar reglas de agentes entre proyectos y entre herramientas, defines el equipo una vez y forge lo materializa para Claude Code, OpenCode, Codex CLI y Kiro.

• 🤖 Equipos de agentes multi-runtime — 7 agentes universales + 19 profiles de stack
• 📐 Flujo SDD spec-first — ninguna tarea de código sin una spec APPROVED
• 🪝 Guardrail hooks en JS puro — branch-guard, debug, secretos y prod-safety, cero Python
• 🔁 Un project.yaml, cada CLI — Claude Code, OpenCode, Codex, Kiro
• ⚖️ Compliance con veto vinculante — revisor GDPR/LGPD/CCPA que bloquea el merge
• 🔄 Operaciones reversibles — manifest SHA-256 + --dry-run para auditar cada cambio
• 📚 Knowledge base del proyecto — wiki que ingesta, lintea y responde con citas

¿Por qué forge?

vs. reglas de agente hechas a mano

• Un project.yaml, cuatro runtimes — escribes el equipo una vez, no cuatro.
• Spec-first por defecto — el orchestrator rechaza spawnear agentes sin spec aprobada.
• Guardrails ya cableados — hooks de seguridad listos, sin instalar nada de Python.
• Regenerable — forge generate reconstruye todo el equipo desde la fuente de verdad.

vs. copiar y pegar agentes entre proyectos

• TIERs componibles — universal → stack → dominio, con resolución de colisiones predecible.
• 19 profiles de stack listos — Next.js, FastAPI, Django, Rails, Laravel, Go, Rust, Flutter…
• Operaciones reversibles — manifest SHA-256 detecta drift; forge teardown desinstala limpio.
• Drift bajo control — forge update re-sincroniza con el catálogo preservando tus ediciones.

Instalación

forge corre con Node.js 20+. Con Bun se desbloquea el panel full-screen (OpenTUI, @opentui/core); en Node cae a prompts @clack; en consolas legacy, a ASCII.

Probar sin instalar:

npx @cristiancorreau/forge init

Instalar el comando global forge:

npm install -g @cristiancorreau/forge

pnpm add -g @cristiancorreau/forge     # pnpm  (requiere `pnpm setup` una vez)
bun add -g @cristiancorreau/forge      # bun   (requiere ~/.bun/bin en el PATH)

Quickstart (30 s)

# 1. Inicializa forge en tu proyecto
#    (wizard: detecta stack, instala agentes + hooks, escribe el manifest)
npx @cristiancorreau/forge init

# 2. Verifica el entorno y la conformidad
forge doctor
forge validate

# 3. Regenera la configuración nativa de cada runtime desde project.yaml
forge generate

¿Ya tienes un codebase en marcha? Intégralo sin partir de cero:

forge adopt        # analiza el repo existente + auto-wiki

Las 5 capas

forge se organiza en cinco capas que van de la fuente de verdad a la materialización por runtime.

Sistema de TIERs

Tres niveles componibles, de lo general a lo específico. Cada tier hereda y especializa al anterior; ante una colisión, gana el más concreto.

Detalle completo en docs/tiers.md.

Comandos

Los 16 comandos de la CLI.

Panel interactivo. Con Bun, forge panel (y el dashboard post-init) abre un panel navegable OpenTUI para explorar agentes, skills, hooks y profiles sin salir de la terminal. Con Node cae al flujo de prompts estándar.

Stacks / Profiles (19)

Profiles Tier 2 listos para activar. Cada uno aporta reglas de arquitectura, convenciones de código y patrones del framework.

Runtimes

Un mismo proyecto forge se adapta a cuatro runtimes, cada uno con su salida nativa.

Detalle por runtime en docs/runtimes/.

Skills

12 skills generales que encapsulan flujos completos, mapeados por runtime y disparables como slash commands (/spec, /new-feature, /db-migrate…), más skills por stack.

Además, session-start y session-close están disponibles como comandos de la CLI.

Skills por stack. El profile Laravel suma 5 skills orientados a Laravel 13: /laravel-eloquent, /laravel-pest, /laravel-security, /laravel-verify y /laravel-mcp (Boost, laravel/mcp, AI SDK, embeddings/pgvector).

Catálogo completo en docs/skills.md.

SDD: spec-first, no opcional

forge aplica Spec-Driven Development con un gate real, no una sugerencia:

• Ninguna tarea de código arranca sin una spec en estado APPROVED dentro de docs/specs/.
• El orchestrator veta spawnear agentes de implementación si no hay spec aprobada.
• El skill /spec redacta la spec; /new-feature la lleva de plan a deploy.

El resultado: el equipo de agentes no improvisa código sobre requisitos ambiguos — primero se acuerda el qué, después se genera el cómo.

Compliance con veto vinculante

El agente compliance-reviewer (Tier 1, model opus) revisa cada PR contra los marcos de compliance activos — GDPR / LGPD / CCPA — con poder de veto vinculante antes de mergear.

Sumado a los guardrail hooks en JavaScript puro (cero Python):

• 🚫 branch-guard — evita commits directos sobre ramas protegidas.
• 🐛 debug detection — bloquea console.log / print de depuración.
• 🔐 secret detection — frena secretos hardcodeados antes del commit.
• 🚀 prod-safety — protege operaciones sensibles contra producción.

Comparativa

Documentación

• 🌐 Landing — el pitch en una página.
• 📖 Guía completa
• 🧩 Skills
• 🏗️ TIERs
• 📚 Wiki / knowledge base
• 📡 Runtimes

npx @cristiancorreau/forge init

Licencia

Apache-2.0 — Copyright © 2026 Cristian Correa.