Usar Forjar
Política y autonomía
Reglas que fijan el riesgo de cada cambio, cuánto decide Forjar solo, pautas para los agentes, presupuesto y pausa.
Cada proyecto tiene su política, en Factory › Política. Todo lo que hay aquí también se cambia hablando con el chat. Solo un propietario la cambia.
Cómo se decide el nivel de riesgo
Forjar mira los ficheros que cambia el PR y tus reglas activas. Es un cálculo determinista: la misma entrada da siempre el mismo nivel, y siempre puedes ver qué regla lo decidió.
Parte de un nivel base
Acotado, o no trivial si el cambio toca más de 20 ficheros.
Aplica las reglas de «solo»
Una regla de nivel mecánico o acotado aplica cuando todos los ficheros cambiados encajan con sus patrones y, si pone un máximo, el cambio no lo pasa. «Si solo toca package.json y el lockfile, es mecánico».
Aplica las reglas de «toca»
Una regla de nivel no trivial o sensible aplica cuando algún fichero encaja. «Si toca src/auth/**, es sensible». Gana el nivel más alto.
La IA solo puede subirlo
Si el juez de riesgo está encendido (por defecto no lo está), un modelo puede subir el nivel. Nunca bajarlo.
La regla del sistema
Protege los ficheros que gobiernan el propio gate: workflows, CODEOWNERS, la configuración de lint y tests y la configuración de Forjar. Un cambio que los toca es sensible y espera a una persona. Es una regla más en la lista, pero no se desactiva.
La autonomía
Para los niveles mecánico y acotado eliges qué hace Forjar cuando un cambio está listo:
| Modo | Qué hace |
|---|---|
ask | Decide una persona |
propose | Decide una persona, y Forjar dice si él lo aprobaría |
auto | Forjar aprueba y mergea |
Todo empieza en propose. Los cambios no triviales y sensibles nunca son autónomos.
En auto, Forjar solo aprueba cuando los checks del commit han corrido, ninguno falló ni está pendiente y al menos uno pasó, y el revisor no tiene dudas. Si no, el cambio espera como cualquier otro.
Te propongo pasar un nivel a auto cuando coincides con nueve de mis diez
últimas propuestas. Es solo una sugerencia: subirlo siempre lo confirmas tú.
Aprobar planes
| Opción | Cuándo aprueba una persona el plan |
|---|---|
none | Nunca: los planes se aprueban solos |
rules | Cuando una regla de planes de nivel no trivial o sensible encaja con el título o el cuerpo de la issue |
all | Siempre |
Un cambio no trivial necesita siempre el plan aprobado antes y una aprobación después.
Pautas
Una pauta es una instrucción para los agentes de un proyecto: «usa siempre el cliente HTTP del módulo shared». Se añade a lo que se le dice a cada run. Las retiras cuando dejan de servir.
Propuestas
Cuando rechazas un PR con un motivo, Forjar puede proponerte una regla o una pauta que habría evitado el problema. No hace nada hasta que la aceptas.
Presupuesto
- Por mes y proyecto. Cuando el gasto lo alcanza, los runs en curso se paran y no empieza ninguno hasta que lo subes o empieza el mes.
- Por run. Un run que lo supera se corta y falla con
budget_exceeded.
El coste se calcula con los precios del catálogo de cada modelo, que pecan de altos a propósito: un run se corta pronto, no tarde. Un modelo sin precio necesita un máximo de tokens por run.
Pausar la factory
Un interruptor por proyecto. En pausa no empieza ningún run y los que están en curso se paran. Reanudar no reintenta lo que se paró.
Repositorios sin CI
Sin CI, un PR no tiene checks y Forjar nunca aprueba solo lo que no ha visto pasar. Dale un comando de verificación: «verifica cada PR con corepack enable && pnpm check». Un verificador lo ejecuta en un sandbox limpio, sin credenciales, con 20 minutos de límite, y publica el check forja/verify. Si tu repositorio tiene CI, déjalo vacío.