ACUERDOS, EVIDENCIA Y DECISIONES HUMANAS.
Factory conecta un acuerdo escrito, una tarea, una revisión externa y el juicio de Oracle. Vos construís —con ayuda de IA si querés— y decidís qué merece avanzar.
Entrá a la fábricaYo decido qué avanza: el alcance, las medidas, los hallazgos y el cierre.
Yo propongo y construyo. Lo que propongo no cuenta hasta que lo confirmás.
LÍNEA DE PRODUCCIÓN / 01
Avanzá a tu ritmo o reproducí el recorrido.
01 / 08PERSONA + FACTORY
Disponible hoy“Quiero que ninguna nota tenga el título vacío.” Vos aportás el contexto y Factory crea una tarea y documentos iniciales para el cambio.
Esta escena es una simulación, incluido el defecto que vuelve a corrección. El rombo ◆ señala decisiones humanas: en el modo por defecto, una persona confirma desde su terminal lo que propone un agente. Sus decisiones solo cambian la demostración. La guía usa un validador de títulos ya escrito, sin pantalla, base de datos ni guardado de notas. Factory no ejecuta agentes, pruebas ni revisores automáticamente.
EL MISMO PEDIDO. DISTINTOS CAMINOS.
Imaginá que querés guardar notas sin títulos vacíos. Estos enfoques cambian cómo organizamos el trabajo y comprobamos el resultado. Pueden combinarse entre sí.
Le contás a una IA qué querés y vas ajustando el resultado mientras lo probás.
“Hacé una app de notas.” La probás y pedís que no permita guardar un título vacío.
Podés agregar pruebas y acuerdos escritos para ampliar las comprobaciones.
CADA HERRAMIENTA, UN TRABAJO
El alpha actual registra el acuerdo, importa requisitos, conserva una revisión externa y evalúa hechos para permitir el cierre local. Construir, ejecutar pruebas y revisar el código siguen siendo trabajos externos.
Vos escribís promesas y escenarios en documentos con formato OpenSpec. Factory los muestra para aprobación y Oracle importa sus requisitos. No hace falta instalar la CLI de OpenSpec. Al cerrar cada cambio, Factory fusiona su spec en openspec/specs/, donde queda lo vigente de cada capacidad.
Conserva tareas, bloqueos, evidencia y el próximo paso. Une lo que se pidió con lo que efectivamente se hizo.
Disponible en el prototipoPodés usar una persona o una IA para escribir código y ejecutar pruebas por fuera de Factory. El alpha no elige, invoca ni coordina esos agentes.
Coordinación automática previstaEl alpha de Clue prepara contexto y valida informes externos; aún no busca defectos con IA. Factory no invoca Clue: registra un informe creado por una persona u otro revisor —idealmente otro modelo, distinto del que escribió el código— y, con la revisión guiada, separa el informe de las decisiones sobre cada hallazgo.
Clue alpha: contexto e informes · IA pendienteEvalúa hechos contra las medidas acordadas. Un requisito sin medir o sin evidencia suficiente permanece visible.
Disponible en el prototipoAceptás el alcance, elegís las medidas, resolvés los hallazgos y confirmás el cierre de la tarea. Publicar o desplegar el producto requiere un trabajo posterior.
Decisiones humanas explícitasEL ELENCO DE LA FÁBRICA
Los agentes construyen y los revisores miran; Oracle juzga con las medidas que acordaste y Clue cuida lo que cada revisor ve. Ninguno decide por la persona: cada decisión queda a nombre de quien la tomó.
Decido qué avanza: el alcance, las medidas, los hallazgos y el cierre. Todo queda a mi nombre.
Propongo la spec y las medidas, y escribo el código. Mis propuestas no cuentan hasta que las confirmás.
Leo el código que no escribí y dejo hallazgos con su severidad. Sólo un medio o más pide otra vuelta.
Reviso a la vez que codex, con otro modelo. Dos miradas distintas encuentran más.
Comparo los hechos de las pruebas con las medidas que acordaste: verde, rojo o sin juicio. No adivino.
Preparo lo que ve cada revisor y valido sus informes. Un informe que no valido no cuenta.
MINIJUEGO / VOS DECIDÍS
Un pedido, cinco paradas y las mismas reglas que la terminal: no se aprueba con un hallazgo medio abierto, un riesgo aceptado lleva su motivo y unas medidas sin acordar dejan el requisito sin juicio. Al final, el registro dice quién decidió cada cosa.
El minijuego necesita JavaScript.
Es una simulación: no corre la CLI ni registra nada. Las reglas son las de Factory; los nombres de las medidas, los del ejemplo de notas de la guía desde cero.
CUATRO PARADAS CON PROPÓSITO
Cuatro paradas, cuatro decisiones mías. El resto lo hacen los demás.
Qué vamos a construir y qué queda afuera.
Elegir las reglas que van a juzgar cada requisito. Un agente puede proponerlas; según el modo de trabajo, una persona las confirma desde su terminal y queda registrado quién decidió.
Decidir cada hallazgo: corregido, descartado o riesgo aceptado. Con la revisión guiada, Factory comprueba la estructura del informe y calcula los abiertos; no juzga si el análisis es bueno.
Revisar los artefactos y cerrar la tarea local. La entrega del producto se organiza después.
LO QUE TRAE LA 0.1.0a13
Lo que se agregó desde la primera guía. Todo está en el paquete publicado en PyPI y se usa desde la terminal.
Qué te necesita a vos, la línea de tiempo de cada cambio con quién decidió qué, los hallazgos y las métricas. Cada commit dice de qué cambio es, y cada cambio, quién lo tiene y con qué agentes. De a dos, con Live Share y un chat guardado en el cambio.
tablero · tomar · logkb/ se genera del registro y no se desactualiza; por-que va de una línea a su cambio; preguntar responde con los pasajes vigentes y su cita, con la calidad medida por preguntas de oro.
Un banco de 13 escenarios con dos personas y sus agentes: el registro de un cambio editado en dos ramas se une solo, lo que las dos decidieron distinto lo elige una persona y ninguna decisión se pierde ni queda a nombre de otro.
decidir-unionoracle-factory mcp deja que un agente consulte el proyecto sin poder cambiarlo, y oracle-factory agentes le escribe la guía en AGENTS.md, armada desde la CLI y verificada.
juzgar acepta un archivo de hechos por sensor y Oracle los juzga juntos. Si dos sensores emiten la misma relación, no hay veredicto: Oracle nombra la relación y los dos archivos.
Decidí como persona con las reglas de la CLI y mirá el registro al final: quién decidió cada cosa y por qué Oracle dio verde, rojo o sin juicio.
JugarLa extensión de editores/vscode/ muestra los cambios abiertos con sus requisitos, revisión, veredicto y artefactos, y escribe el próximo paso en la terminal sin ejecutarlo: la decisión sigue siendo de la persona.
Si revisar corta sin registrar la revisión, queda constancia con su causa y estado lo avisa. Dos procesos ya no se pisan el registro.
pedir-revision cuenta los hallazgos por severidad: sólo un medio o más sin aceptar pide otra vuelta. Los riesgos que una persona acepta pasan a las vueltas siguientes, varios revisores se lanzan a la vez y el paquete deja fuera los registros de Factory.
trazabilidad cruza cada requisito con los casos que lo prueban y con las líneas que cambió el candidato, y dice cuáles no tienen respaldo.
estado, donde y resumen con --json, con un esquema versionado, para un IDE, un panel o un agente.
Un repositorio que ya tiene su proyecto Oracle en una carpeta (por ejemplo medidas/) lo adopta con init --oracle; sus escalares se ejecutan sólo si declara confiar_escalares.
estado calcula el próximo paso según lo que está vigente y, en una terminal, ofrece ejecutarlo. Los errores dicen qué pasó y cómo seguir.
Cada decisión de una persona se toma eligiendo una opción numerada. revisar lleva la revisión de punta a punta y el motivo se elige: el que propuso el agente, uno armado con los datos del cambio o uno propio. medir --confirmar confirma de una vez las medidas propuestas.
pedir-revision lanza un revisor declarado en .factory/config.json, valida su informe con Oracle Clue y lo guarda en el candidato. El revisor no decide: lo que trae se decide en revisar.
Cada cambio elige cuánto decide una persona: confirmacion (por defecto: el agente propone, la persona confirma, y el cierre lo toma la persona), funcional (la persona decide los requisitos funcionales) o autonomo. Un agente actúa con --agente y queda registrado como agente; Factory no autentica, así que es un acuerdo entre quienes trabajan juntos.
revision-preparar deja un informe y un documento de decisiones por completar; revision --formato guiado los valida y calcula los hallazgos abiertos. Una revisión vale mientras no cambien los archivos del producto, aunque cambie el commit.
El estado de cada cambio, la configuración y lo que se produce sobre cada candidato viven en .factory/. donde, ruta y buscar dicen dónde está o dónde va cada artefacto; los comandos encuentran el proyecto desde cualquier subcarpeta.
Al cerrar, la spec del cambio se fusiona en openspec/specs/<capacidad>/spec.md: para saber qué hace el sistema hoy se lee una spec por capacidad, no todas las propuestas. estado dice qué requisitos siguen vigentes y cuáles reemplazó otro cambio.
oracle-factory resumen escribe .factory/resumen.md: lo vigente, los cambios abiertos y lo que les falta, los riesgos aceptados y los límites declarados. Se regenera al cerrar; con formato se lee con glow -p .factory/resumen.md.
Cada persona trabaja en su checkout o su máquina con sus agentes; las decisiones quedan a nombre de quien las toma y una persona integra y cierra. Cómo se trabaja en equipo.
Probado con agentes · piloto con personas pendienteVISIÓN DEL PRODUCTO / AÚN NO IMPLEMENTADA
La interfaz futura que proponemos pone tu próximo paso al frente. Las herramientas y sus artefactos siguen disponibles para cuando quieras profundizar.
Te dejo el próximo paso escrito en la terminal. Lo ejecutás vos.
Una entrada única en lenguaje cotidiano. Factory reúne el contexto y te muestra una propuesta concreta.
Un tablero de decisiones pendientes, con el motivo, la evidencia y las opciones para continuar.
La spec, la rama, las pruebas, los hallazgos y el veredicto enlazados a la misma tarea.
Ya podés instalar el paquete desde PyPI y usarlo desde la terminal, una ventana donde escribís comandos. La herramienta crea una tarea y plantillas que vos completás para definir qué debe hacer el programa. La generación automática de software y el panel de trabajo forman parte de la siguiente etapa.
oracle-factory --helpSeguir la guía desde cero