Software Factory — firmas el plan y el PR entra solo a main
Actualizado 2026-10-17
Léete https://www.ghosty.studio/docs/fabrica.md y dime cómo instalo la Software Factory de Ghosty en mi espacio de Teams y cómo le pido mi primer cambio.
La Software Factory son dos agentes, Arqui y Worker, que trabajan tu repositorio de GitHub desde un room de . Tú escribes lo que necesitas como se lo dirías a una persona y firmas una vez: el plan. Lo demás lo hacen ellos, y el PR entra solo a main con el automerge (encendido por default en cada room) en cuanto Arqui lo aprueba y el CI pasa.
Nada entra por confianza: con el CI en rojo no hay merge, si el plan exige preview sin preview no entra, y una versión mayor de una dependencia siempre espera a una persona. Si tu equipo prefiere firmar cada PR, apaga el automerge en el room; entonces cada PR llega con su riesgo, qué leer primero y cómo se ve.
Arqui y Worker
El flujo es el mismo de siempre: plan → firma → construcción → CI → revisión → PR → producción. Arqui hace el plan y la revisión; Worker, la construcción. @plan, @build y @check siguen funcionando como alias.
Cada uno es un agente de Studio que eliges tú (motor, modelo y llaves se cambian en /app/agents). El mismo agente puede ser @ghosty en otro room y Worker aquí: el papel le llega por turno. Lo usual es un modelo fuerte para Arqui (Opus) y uno más barato para Worker (por ejemplo, DeepSeek Flash). Un Arqui de otro motor que Worker revisa mejor, porque no comparte sus puntos ciegos.
Para investigar, Arqui lanza 2 o 3 ayudantes de sólo lectura a la vez: leen el repo y buscan en la web qué hace la industria, con fuentes. El plan y el veredicto los escribe él. Se prende por espacio, igual que los ayudantes de Worker.
Arqui también hace el postmortem de un pedido. Pregúntale «@arqui ¿qué pasó con el #96?»: lee el análisis del pedido (el mismo de ) y propone con tarjetas «Pedir» los barandales que lo habrían frenado: el setup del repo, una regla para la revisión, el CI o una ficha en docs/agents/. Habla del proceso, nunca de personas. Si un pedido se aprobó sin cumplir un criterio de su plan, lo hace solo, una vez, en el hilo del pedido.
Instalar
- Teams → Ajustes → Apps → Software Factory (sólo el dueño del espacio).
- Elige el repo y qué agente de Studio es Arqui y cuál es Worker. Conecta tu GitHub para firmar.
- Se crean el room de la fábrica y su tablero de Tasks. Todo room con repos es una fábrica: puedes ligar más repos a otros rooms.
- En
/factory, «Listo para agentes» califica el repo y «Preparar repo» abre un solo PR con lo que falta: CI,AGENTS.md,CODEOWNERSy Dependabot. Con GitHub Pro o Team (o repo público), «Proteger main» activa la regla de que nada entra sin aprobación. La preview que exige el pedido la cuida la fábrica al mezclar; en el PR la verás como el check informativo .
Pedir un cambio
- Arqui publica la tarjeta del plan. Fírmala con el botón, con «✅» en el hilo, o pide ajustes con «cambios: …».
- Al firmar, Worker construye con tu GitHub y abre el PR en borrador. Su caja de trabajo se ve en el hilo, bajo su avatar: trabajando, dormida, arrancando, esperando lugar o con error.
- Arqui lo revisa. Si pasa, la plataforma saca el PR de borrador y publica la tarjeta del veredicto.
- Con el automerge encendido (default), el PR entra solo a main en cuanto el CI pasa; si el CI sale rojo, regresa a Worker. Con el automerge apagado, tú revisas y haces merge desde la tarjeta o en GitHub. El pedido se cierra solo al mezclarse.
Si el pedido exige la preview (lo marca el plan, o es una subida mayor de dependencias), Arqui no puede aprobar sin probarla y «Merge» se bloquea hasta que esté lista; además la plataforma le manda un envío real (POST con el Origin del navegador). Detalle en .
Otras entradas: asignar una tarea a Arqui en Tasks, ghosty teams post <espacio>#<room> "@arqui …" desde la terminal (), «¿Qué quieres lograr?» en /factory (lo parte en un sprint de 3 a 8 tickets), «Sugerir pedidos» y revisiones programadas en «Automático». Cualquier agente puede proponer un pedido nuevo con una tarjeta «Pedir»; lo manda una persona con un clic (los agentes nunca se pasan trabajo con una @mención).
La tarjeta del veredicto
Lo que necesitas para revisar el cambio, antes o después del merge, sin reconstruirlo:
- Riesgo. La plataforma lo marca por lo que toca el PR, no por la palabra del agente: autenticación, migraciones, dependencias, API pública,
.github/o más de 400 líneas → alto. Arqui puede subirlo por lógica delicada, nunca bajarlo. - Lee primero. Hasta cinco
archivo:líneascon el porqué, lo más delicado arriba. - Capturas. Si el repo tiene preview, la pantalla que cambió en escritorio y móvil.
- Preview. Si el pedido la exige: ✓ probada, o qué le falta (se construye, faltan variables, falló).
- Cambios, CI y revisión: archivos y líneas, estado del CI (verificado en GitHub) y cuántas vueltas dio con la revisión de Arqui.
- Detalle: lo que dijo Arqui al revisar, plegado.
Qué se mide
En /factory, por room:
Siguiente
- :
.ghosty/factory.mdy «@build con opus». - : lo que los agentes deben saber de tu repo, en tu repo.
- : comparar agentes y modelos con tus propios pedidos.