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
forjaen 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
| Rol | Qué hace |
|---|---|
| Planificador | Propone el plan antes de que nadie programe |
| Implementador | Programa el cambio en un sandbox y abre el PR |
| Revisor | Contrasta el PR con lo pedido y anota sus dudas |
| Verificador | Ejecuta 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
| Nivel | Ejemplo | Gate por defecto |
|---|---|---|
| Mecánico | Dependencias, lint, formato | Una aprobación, o merge solo si lo permites |
| Acotado | Un fix o una feature pequeña en código no crítico | Una aprobación, o merge solo si lo permites |
| No trivial | Arquitectura o varios módulos | Plan aprobado antes y aprobación después |
| Sensible | Auth, pagos, datos, el propio gate | Siempre 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.