Empezar

Cómo trabaja Forjar

El camino de una issue hasta un PR mergeado, y quién decide en cada paso.

Forjar es una capa sobre GitHub y, si lo usas, Linear. El trabajo sigue viviendo allí. Forjar añade los agentes que lo hacen, el gate que decide cuándo se mergea y la cabina donde decides tú.

El camino de una issue

Entra el trabajo

Le das una issue a Forjar de una de estas formas:

  • En GitHub, con la etiqueta forja en una issue de un repositorio conectado.
  • En Linear, delegando la issue a la app Forjar.
  • En el chat, pidiéndole una tarea.

El planificador propone un plan

Antes de programar, un agente escribe qué va a hacer. Según tu política, el plan se aprueba solo o llega a la cabina para que lo apruebes tú. Si lo rechazas con un motivo, el planificador escribe una revisión nueva.

El implementador programa en un sandbox

Cada run trabaja en un sandbox aislado: un contenedor Docker o un sandbox de Daytona. Clona el repositorio, hace el cambio, sube una rama forja/… y abre el PR. Si duda, te pregunta y espera tu respuesta.

El revisor y el verificador comprueban

Un revisor contrasta el PR con lo que se pidió y anota sus dudas. Si el repositorio no tiene CI, un verificador ejecuta el comando que le diste y publica el check forja/verify.

El gate decide

Forjar calcula el nivel de riesgo del cambio con tus reglas y fija el check forja/gate. Según el nivel, el PR se mergea solo o espera a una persona en la cabina.

Decides y aprende

Apruebas y mergeas, pides cambios o rechazas con un motivo. Cada rechazo puede proponer una regla o una pauta nueva para que el siguiente intento salga mejor.

Los roles de agente

RolQué hace
PlanificadorPropone el plan antes de que nadie programe
ImplementadorPrograma el cambio en un sandbox y abre el PR
RevisorContrasta el PR con lo pedido y anota sus dudas
VerificadorEjecuta tu comando de verificación cuando el repo no tiene CI

Los agentes son Claude Code (Anthropic), Codex (OpenAI) y pi (el resto de modelos). Cada equipo conecta los suyos, con su suscripción o con una API key. Ver Agentes y modelos.

Los niveles de riesgo

NivelEjemploGate por defecto
MecánicoDependencias, lint, formatoUna aprobación, o merge solo si lo permites
AcotadoUn fix o una feature pequeña en código no críticoUna aprobación, o merge solo si lo permites
No trivialArquitectura o varios módulosPlan aprobado antes y aprobación después
SensibleAuth, pagos, datos, el propio gateSiempre una persona

Un cambio de más de 20 ficheros es no trivial por defecto. La regla del sistema protege los ficheros que gobiernan el propio gate y no se desactiva.

Qué guarda cada PR

Cada PR llega a la cabina con su paquete de evidencia, para que decidas sin abrir el diff si no quieres:

  • El plan aprobado, y quién lo aprobó.
  • Los checks del commit: tu CI o forja/verify.
  • El resumen del revisor y sus dudas.
  • La regla que fijó el nivel de riesgo.
  • El coste de todos los runs que trabajaron en él.

Una aprobación vale solo para el commit que viste. Un push nuevo vuelve a poner el PR bajo el gate.