Software Factory

Software Factory — firmas el plan y el PR entra solo a main

Dos agentes, Arqui (planea y revisa) y Worker (construye), trabajan tu repo desde el chat de Teams; tú firmas el plan y el PR entra solo a main cuando Arqui lo aprueba y el CI pasa. Cómo se instala, cómo se pide y qué trae cada PR.

Actualizado 2026-10-17

Pídeselo a tu agente de código

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.

Pégalo en Claude Code, Cursor o Codex con la skill ghosty-agent instalada.

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

AgenteQué haceQué no hace
Arqui (@arqui)Lee el repo y escribe el plan que firmas: historia con criterios de aceptación, brief técnico, riesgos y lo que no se hará. Después revisa el PR contra ese mismo plan: escribe sus propias pruebas de aceptación, prueba la preview y mira que el código siga siendo fácil de cambiar.No edita, no crea ramas ni empuja: si algo falta, se lo regresa a Worker (hasta 3 vueltas).
Worker (@worker)Construye el plan firmado en su propia caja de trabajo: rama nueva, código, pruebas, PR en borrador.No improvisa otro diseño ni se revisa a sí mismo.
@evalOpcional. Juez de los .No participa en los pedidos.

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

  1. Teams → Ajustes → Apps → Software Factory (sólo el dueño del espacio).
  2. Elige el repo y qué agente de Studio es Arqui y cuál es Worker. Conecta tu GitHub para firmar.
  3. 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.
  4. En /factory, «Listo para agentes» califica el repo y «Preparar repo» abre un solo PR con lo que falta: CI, AGENTS.md, CODEOWNERS y 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

text
@arqui agrega exportar citas a CSV desde la agenda
  1. Arqui publica la tarjeta del plan. Fírmala con el botón, con «✅» en el hilo, o pide ajustes con «cambios: …».
  2. 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.
  3. Arqui lo revisa. Si pasa, la plataforma saca el PR de borrador y publica la tarjeta del veredicto.
  4. 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íneas con 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:

NúmeroQué es
Pasan a la primeraDe los PRs que ya revisó una persona, cuántos aprobó sin pedir cambios (o mezcló directo). La métrica que importa.
Tiempo de revisiónMediana de «PR listo» a la primera revisión humana.
Se concretanMezclados entre los pedidos cerrados.
Correcciones de @checkVueltas promedio antes de aprobar.
Del pedido al PRMediana del pedido al PR listo.

Siguiente

  • : .ghosty/factory.md y «@build con opus».
  • : lo que los agentes deben saber de tu repo, en tu repo.
  • : comparar agentes y modelos con tus propios pedidos.