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ábricaLÍ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ícitasCUATRO PARADAS CON PROPÓSITO
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.0a8
Lo que se agregó desde la primera guía. Todo está en el paquete publicado en PyPI y se usa desde la terminal.
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, la persona confirma todo), funcional (la persona decide los requisitos funcionales) o autonomo. Un agente actúa con --agente y queda registrado como agente; nunca como persona.
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.
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