Una spec por funcionalidad, en el repositorio junto al código, para que los agentes de tus ingenieros construyan a partir del mismo archivo que escribiste tú. Cada decisión tomada después de la aprobación queda en la spec, con quién la confirmó y cuándo. Para el product manager y el líder técnico de un equipo que entrega con agentes de código.
Gratis para macOS, Windows y Linux. Sin cuenta, sin suscripción.
¿Te suena?
El PRD se aprobó. Después los requisitos siguieron moviéndose, en reuniones, hilos, demos y tickets.
La decisión se tomó en una llamada y vive en lo que dos personas recuerdan de un hilo. Cuando vuelve a salir, la reunión es sobre qué se decidió, no sobre qué construir.
El alcance cambia en el tracker mientras el documento se queda como se firmó. Seis meses después, la mitad está desactualizada, y quien acaba de entrar no sabe cuál mitad.
Los agentes de tus ingenieros construyen a partir de lo que hay en el repositorio. El PRD vive en otro lado, así que les llega pegado a pedazos, si es que les llega.
Cómo encaja
Instala el Framework (el marco) de software y cada funcionalidad tiene un archivo markdown en el repositorio: por qué existe, qué promete y qué no hará. El trabajo vive en tareas que apuntan a la spec, así que la spec describe el producto y nunca se llena del estado del sprint.
Lo que más vas a usar
Registra lo que se acordó en una reunión como una decisión de tipo Meeting en la spec. Espera en la bandeja hasta que la persona que decide la confirma, y guarda su nombre y la fecha.
Un hilo empieza en el criterio de aceptación que cuestiona, lo sigue a través de las ediciones y se cierra cuando está respondido. Está en el archivo, así que quien revisa lo ve en el merge request.
Tareas en un tablero, cada una con la spec a la que sirve. Cierra el ticket y la spec sigue siendo cierta, porque nunca guardó el estado del ticket.
Bosqueja el flujo con tu diseñador y luego convierte un boceto en una spec real. Conserva su lugar en el lienzo y abre su archivo.
Claude Code o Codex junto a la página, con la spec adjunta. /grill hace que pregunte dónde la spec es vaga antes de que nadie construya a partir de ella.
Un historial y un diff para cada spec, y una versión con nombre para lo que se aprobó, sin abrir una terminal.
Quién lo acordó, y cuándo
Cada decisión tomada para una spec aparece en su sección Constraints & Decisions, marcada cuando una persona la confirma. Una decisión que un agente tomó por su cuenta llega como Proposed y sigue sin confirmar hasta que alguien la respalda. «Yo no recuerdo haberlo aprobado» tiene respuesta: el nombre y la fecha están en el archivo.
Nada cambia en silencio
Abre el Historial del archivo de una spec para ver quién la cambió y cuándo, y el diff de cualquier commit frente a la spec tal como está. Las decisiones y los hilos de comentarios son parte del archivo, así que aparecen en el mismo diff y en el merge request.
Del discovery a una spec
Organiza un flujo en un lienzo cuyas tarjetas son tus specs, dibujadas en vivo a partir de sus archivos. Cuando una idea esté lista, convierte el boceto: pasa a ser una spec en la colección que elijas, y las flechas se quedan donde las dibujaste.
Para el líder técnico
Instala el Framework en el repositorio, dirige hacia él a cada agente que lee AGENTS.md y ejecuta eidos check en tu CI para que falle un pull request que rompe una spec (un job de CI de un solo comando, eidos ci, llega en la próxima versión). Los product managers usan la app de escritorio; nadie tiene que aprender git para escribir una spec.
$ npm install -g eidosmd
$ eidos install @BuildableWorks/software
$ eidos agents --write
✓ created AGENTS.md with the Eidos nudge
$ eidos checkEmpieza aquí
Frames para el producto y specs para las funcionalidades, con Out of Scope en cada plantilla. Elígelo en la app cuando crees una raíz nueva en el repositorio, o instálalo desde una terminal. Después activa el Backlog y Decisiones en Plugins del núcleo.
Una app, un servicio o un sistema
Frames (los encuadres) de arquitectura, audiencia, criterios y mercado, y specs agrupadas por dominio.
$ eidos install @BuildableWorks/softwareEn la app: configura una raíz nueva y elígelo de la lista.
Descarga Eidos MD, instala el Framework de software en tu repositorio y escribe la spec de la funcionalidad que tu equipo empieza a continuación.
Gratis para macOS, Windows y Linux. Tus archivos siguen siendo texto simple en una carpeta que es tuya.