forge

Configura cualquier proyecto para trabajar con agentes IA en un comando.

Wizard interactivo que detecta tu stack, instala agentes especializados, genera guardrails y mantiene un manifest con SHA-256 para auditar cada cambio.

⚠️ Deprecation Notice: forge.py y los scripts Python (scripts/*.py) están deprecados y serán removidos en v3.0.0. Usa npx @cristiancorreau/forge para todos los comandos (Node/Bun, sin Python). Ver MIGRATION.md.

Instalación

forge corre con Node.js 20+ (sin Python) y funciona con cualquier gestor.

Probar sin instalar (one-off con npx):

npx @cristiancorreau/forge init

Instalar el comando global forge (para usar forge init, forge doctor, … directo):

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

Luego:

forge init
forge doctor
forge --version

El comando forge no se reconoce tras el install global? El directorio de binarios globales no está en tu PATH. npx @cristiancorreau/forge <cmd> siempre funciona sin instalar; para el comando pelado:

• npm: export PATH="$(npm prefix -g)/bin:$PATH"
• pnpm: corré pnpm setup y reabrí la terminal
• bun: agregá export PATH="$HOME/.bun/bin:$PATH" a tu shell rc

Cómo funciona

El wizard detecta y configura el proyecto en cinco pasos:

1. Detecta el stack — lee package.json, lockfiles y Dockerfile para identificar framework, lenguaje y dependencias.
2. Selecciona agentes — muestra un selector de flechas con los agentes disponibles para tu stack (TypeScript, Python, Ruby, Go, PHP).
3. Instala configuración — escribe .claude/agents/, CLAUDE.md, settings.json y architecture.rules en el repositorio.
4. Instala hooks — genera hooks de guardrail en JavaScript puro; sin dependencias de Python ni binarios externos.
5. Crea el manifest — forge/.forge/manifest.json con SHA-256 de cada archivo gestionado para rastrear derivaciones futuras.

Funcionalidades

Leyenda: ✅ disponible · 🚧 parcial · ❌ pendiente.

Comandos

Dashboard post-install. Cuando forge init corre con Bun, al terminar abre un dashboard interactivo navegable con OpenTUI: panel con paneles para explorar agentes instalados, skills, profiles activos y estado del manifest sin salir de la terminal. Con Node.js el wizard cae al flujo de prompts estándar.

Runtimes soportados

Stacks soportados

Cada stack instala agentes especializados con reglas de arquitectura, convenciones de código y patrones específicos del framework.

Sistema de TIERs

forge organiza agentes y configuración en tres niveles que se componen de lo general a lo específico. Cada tier hereda y especializa al anterior, y la resolución de colisiones favorece siempre al tier más concreto.

Tier 1 — core (universal). Agentes definidos por su output, no por el stack: orchestrator, backend-engineer, frontend-engineer, test-engineer, docs-writer, compliance-reviewer, security-auditor. Sirven en cualquier proyecto sin modificación y son la base sobre la que se montan los demás tiers.

Tier 2 — profile (stack). Los mismos roles que Tier 1 pero con instrucciones específicas del stack (Hono+Drizzle, FastAPI, Django, Rails, Laravel, Go-Gin, Next.js, Expo, Astro, SvelteKit, WordPress, Playwright…). Un proyecto puede activar varios profiles a la vez; ante una colisión, gana el profile.

Tier 3 — project (dominio). Agentes que conocen el negocio concreto del proyecto (dsar-specialist, gcm-engineer, policy-engineer, banner-engineer). Viven dentro del repositorio y se registran en agents.specialized.

Detalle completo en docs/tiers.md.

Skills

forge incluye 14 skills invocables que encapsulan flujos completos: session-start (abre sesión), session-close (cierra sesión), spec (redacta specs SDD), new-feature (kickoff de feature spec-first), security-audit, db-migrate, local2prod (deploy con gate de producción), browser-test, phase-kickoff, obsidian-sync, aitmpl-search y la familia wiki-* (wiki-ingest, wiki-lint, wiki-query) para la knowledge base del proyecto. Se invocan como slash commands (/spec, /new-feature, /db-migrate, …) y se mapean por runtime.

Catálogo completo en docs/skills.md.

Sin Python requerido

Toda la CLI corre en Node.js. Los hooks de guardrail son JavaScript puro.

No hay pip install, no hay requirements.txt, no hay dependencias de sistema fuera de Node.js 20+.

El forge.py y los scripts scripts/*.py que aún viven en el repositorio son la implementación legacy y están deprecados: serán removidos en v3.0.0. No los necesitás para usar forge vía npx @cristiancorreau/forge. Ver MIGRATION.md.

Comparativa

Documentación

• Guía completa
• Skills
• Wiki / knowledge base
• Runtimes

Licencia

Apache 2.0 — Copyright Cristian Correa, 2026.