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:

ModoQué hace
askDecide una persona
proposeDecide una persona, y Forjar dice si él lo aprobaría
autoForjar 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ónCuándo aprueba una persona el plan
noneNunca: los planes se aprueban solos
rulesCuando una regla de planes de nivel no trivial o sensible encaja con el título o el cuerpo de la issue
allSiempre

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.