Forge AI

Agentic Development Framework · Apache-2.0

Configura tu proyecto para agentes de IA en un comando.

Un equipo de agentes, cualquier runtime. forge detecta tu stack, instala agentes especializados, hooks de guardrail y un manifest auditable — para 19 runtimes (Claude Code, Cursor, Copilot, Gemini y 15 más) desde un solo project.yaml.

Empezar Ver en GitHub

$npx @cristiancorreau/forge init

forge init — ~/mi-proyecto

$ npx @cristiancorreau/forge init
 ███████╗ ██████╗ ██████╗  ██████╗ ███████╗
 ██╔════╝██╔═══██╗██╔══██╗██╔════╝ ██╔════╝
 █████╗  ██║   ██║██████╔╝██║  ███╗█████╗
 ██╔══╝  ██║   ██║██╔══██╗██║   ██║██╔══╝
 ██║     ╚██████╔╝██║  ██║╚██████╔╝███████╗
 ╚═╝      ╚═════╝ ╚═╝  ╚═╝ ╚═════╝ ╚══════╝
✔ Stack detectado  TypeScript · Node 20
✔ Runtime          Claude Code
? Selecciona agentes para tu equipo
   ◉ orchestrator        tier 1
   ◉ backend-engineer    tier 1
   ◉ compliance-reviewer veto
   ◯ security-auditor
✔ Agentes instalados .claude/agents/
✔ Hooks de guardrail JS · sin Python
✔ Manifest SHA-256   .forge/manifest.json
▲ forge listo. Ejecuta /spec para tu primera feature.

comandos de CLI: 17
stack profiles · tier 2: 19
skills invocables: 15
runtimes soportados: 19
capas de arquitectura: 5

Por qué forge

Gobernanza de agentes, no solo prompts.

forge no es un archivo de reglas: es una capa de arquitectura, compliance y delegación que se regenera desde una sola fuente de verdad.

Multi-runtime real

Un project.yaml genera la config de 19 runtimes (4 nativos + 15 basados en reglas) mediante adaptadores de distribución.

Spec-first (SDD)

Ninguna tarea de código sin una spec aprobada. El orchestrator veta implementaciones sin spec en docs/specs/.

Compliance con veto

El compliance-reviewer tiene poder de veto vinculante sobre GDPR, LGPD y CCPA antes de que el código avance.

Guardrail hooks en JS

Cero Python. Hooks puros en JavaScript: branch-guard y detección de debug, secrets y operaciones de producción.

Operaciones reversibles

Manifest con SHA-256 y modo --dry-run: update re-sincroniza el catálogo preservando tus ediciones locales.

Base de conocimiento

Wiki del proyecto: ingest, lint y query con citas. 15 skills invocables y 17 comandos en la CLI.

Adopta y documenta tu repo

forge adopt instala forge en un proyecto existente; forge analyze lo lee (stack, hotspots, TODOs) y el skill /onboard genera arquitectura, onboarding y revisión de seguridad con agentes especializados.

Arquitectura

Las 5 capas de forge.

Cada capa tiene una responsabilidad clara, de la memoria del proyecto a la distribución por runtime.

Memory project.yaml

El project.yaml es la única fuente de verdad: stack, equipo, agentes, skills y compliance. Todo se regenera desde acá.

Knowledge agentes + perfiles

7 agentes Tier 1 universales, 19 perfiles de stack Tier 2 y agentes Tier 3 de proyecto. El conocimiento que el equipo necesita por dominio.

Guardrail compliance + seguridad

Hooks que imponen cumplimiento y seguridad: branch-guard, detección de secrets, debug y operaciones de producción. Pura prevención.

Delegation orquestación

El orchestrator coordina y despacha skills al agente correcto. La delegación es explícita y auditable, no implícita.

Distribution adaptadores

Adaptadores por runtime traducen la config a los 19 runtimes soportados. Escribes una vez, corre en cualquiera.

Panel interactivo

Configura y monitorea desde un panel.

El comando forge panel abre un panel OpenTUI a pantalla completa con Bun — config, monitor, skills, hooks y templates. Con Node hace fallback a prompts de @clack; consolas legacy caen a ASCII.

Panel interactivo OpenTUI de forge mostrando la configuración del proyecto, los agentes instalados y el estado del runtime. — forge panel — config, monitor, skills, hooks y templates en la terminal.

Distribution

Un equipo, diecinueve runtimes.

Defines el equipo una vez en project.yaml y los adaptadores escriben la config nativa de cada herramienta.

4 nativos · 15 basados en reglas

Claude Code.claude/

OpenCodeAGENTS.md

Codex CLIAGENTS.md

Kiro.kiro/

Cursor.cursor/rules/

Windsurf.windsurf/rules/

GitHub Copilot.github/

Gemini CLIGEMINI.md

Zed.zed/rules.md

Cline.clinerules

AiderCONVENTIONS.md

Continue.continue/rules/

Roo Code.roo/rules/

AmpAGENTS.md

Augment Code.augment/rules/

Google Antigravity.antigravity/rules/

OpenClaw.openclaw/rules/

Pi.pi/rules/

Hermes.hermes/rules/

Quickstart

De cero a un equipo de agentes.

Un proyecto nuevo o uno que ya existe: forge se adapta a ambos. Requiere Node.js 20+ (con Bun se desbloquea el panel a pantalla completa).

Instala forge
Pruébalo sin instalar con npx @cristiancorreau/forge init, o instala la CLI global con tu gestor preferido — npm, pnpm o bun:

npm i -g @cristiancorreau/forge
pnpm add -g @cristiancorreau/forge
bun add -g @cristiancorreau/forge

El wizard full-screen (OpenTUI) corre con Bun; con npm/node funciona igual vía prompts.
Inicializa o adopta
init arranca el wizard en un proyecto nuevo; adopt incorpora forge a un codebase existente, lo analiza y genera la wiki.
Trabaja spec-first
Ejecuta /spec para tu primera feature. Sin spec aprobada, el orchestrator veta la implementación.
Mantén sincronizado
update re-sincroniza los archivos gestionados con el catálogo preservando tus ediciones; doctor y validate verifican el estado.

terminal

# proyecto nuevo
$ npx @cristiancorreau/forge init

# proyecto existente
$ npx @cristiancorreau/forge adopt
$ npx @cristiancorreau/forge analyze   # leer el código; /onboard documenta

# primera feature, spec-first
$ /spec
▲ forge — listo para construir.