Eidos

Cada parte de tu producto, un archivo que puedes validar.

Un Blueprint (el plano) es un archivo markdown simple: propiedades tipadas arriba, un cuerpo con la forma de un template (la plantilla) y un id permanente al que apuntan cada tarea, cada decisión y cada nodo del lienzo. Tú declaras el Framework (el marco) que sigue, y eidos check te dice dónde un archivo se ha desviado de él.

Gratis para macOS, Windows y Linux. Sin cuenta, sin suscripción.

El Blueprint Resume Playback abierto en Eidos: su id B-V63 y su ruta, un resumen de una línea, propiedades tipadas (variant, status, fechas, domain, type y un enlace Depends On a Profiles), y luego el cuerpo bajo los encabezados del template, Intent, Assumptions y Open Questions, con las secciones listadas a la derecha.
Un Blueprint se lee como el archivo que es: las propiedades arriba, las secciones del template debajo.

Tu Framework

Una estructura que tú declaras, no una que te imponen

El Framework vive en tu raíz: las colecciones que llevas (specs, capítulos, personajes, investigaciones, aquello de lo que esté hecho tu trabajo), un template para cada variant (la variante) con las secciones que ofrece y las que exige, y una tabla de Properties (las propiedades) con tipos, opciones y lo que significa cada una. Edítalo como formularios en Ajustes del Framework, o con eidos configure desde una terminal.

  • Colecciones y variants, nombradas con tus palabras
  • Secciones obligatorias y propiedades tipadas con opciones
  • Vocabulary (el vocabulario) y roles, para que personas y agentes usen las mismas palabras
Framework settings, en Templates: las variants de frames y specs listadas a la izquierda, y el template de spec completo abierto en el editor, con sus secciones en orden, cada una con un tipo y un interruptor Required, y la intención que le dice a quien escribe qué va ahí.

La revisión de salud

Una revisión de salud sobre la que puedes actuar

eidos check lee cada Blueprint contra tu Framework: un valor fuera de las opciones de una propiedad, una propiedad obligatoria vacía, un campo de seguimiento de trabajo en un Blueprint, un índice desactualizado, un enlace roto. La Revisión de salud lista cada hallazgo bajo su archivo, y Corregir todo lo que se puede aplica cada corrección que la app conoce, y pregunta antes de cualquiera que renombre un archivo o cambie un id.

  • Errores para lo que está mal se mire como se mire, advertencias para lo que falta
  • Si una advertencia hace fallar la revisión es un ajuste de la raíz, guardado en git
  • Los mismos hallazgos en la app, en una terminal y en CI
La Health Check con 0 errores y 9 advertencias y un botón Fix all supported issues (4). Los hallazgos se agrupan por archivo: un índice desactualizado, un archivo no declarado, un archivo de decisión que renombrar, un valor de status que no es una de sus opciones, un campo de seguimiento de trabajo, dos desvíos del linter con un botón Lint cada uno y una región de decisiones por proyectar.

El Registro

Parte de un Framework que alguien ya moldeó

El Registro reúne Frameworks que otras personas han publicado: software, un libro, investigación, un mundo de ficción, un canal, una escuela, una remodelación, una boda y más. Abre uno en la app y cada pieza aparece marcada como ausente en tu raíz, igual o distinta. Incluir en esta raíz trae el conjunto entero o solo la colección que quieras, y pregunta antes de reemplazar cualquier cosa que tengas de otra forma.

  • En la app, o con eidos install @owner/name
  • Conservar el actual o Aceptar el entrante, conflicto por conflicto
  • Publica el tuyo con un pull request
El Framework de investigación abierto desde el Registro dentro de Eidos: sus colecciones Frames e Investigations, cada variant y rol marcados Not in this root con un botón Include al lado, el README marcado como distinto del de la raíz, e Include in this root arriba.

Colecciones

Cada colección es una tabla

Cada colección se abre como una tabla de sus Blueprints, que ordenas, filtras y buscas por cualquier propiedad. Los filtros viven en la dirección, así que un enlace abre la misma vista, y Guardar como vista conserva una para ti o la comparte con todos en la raíz.

La colección specs como tabla, agrupada por dominio, con el resumen, el estado y el tipo de cada Blueprint.

Señalado, nunca rechazado

Las propiedades son el acuerdo y las secciones son una guía. Una propiedad que falta se señala y una sección que falta se ofrece; un archivo nunca se rechaza, porque una revisión que rechaza archivos acaba esquivándose. Una sección que le falta al Blueprint se dibuja en gris donde le corresponde, con un + que la agrega.

Un id permanente, vaya donde vaya el archivo

Cada Blueprint conserva un id como B-V63. Muévelo a otro grupo, o dale un id nuevo, y cada tarea, decisión, comentario, nodo del lienzo y enlace que apunta a él lo sigue. Encuentra cualquier cosa por id o por título desde Apertura rápida.

Configúralo con tu agente

Al crear una raíz nueva en la app de escritorio, Configurar con el Agente de IA puede hacer que tu agente lea primero la carpeta y luego recomiende un Framework del Registro o proponga uno propio. No se escribe nada hasta que lo revisas y presionas Crear la raíz.

Cómo se conecta

Todo lo demás apunta a un Blueprint.

Ningún plugin guarda una segunda copia de lo que dice un Blueprint. Cada uno se refiere a él por su id permanente, y la mayoría escribe en él lo que sabe.

  • Backlog

    Una tarea sirve a Blueprints por su id, y cada Blueprint lista sus tareas en Tareas adjuntas y en una sección Tasks.

  • Decisiones

    Una decisión nombra los Blueprints para los que se tomó y se escribe en su sección Decisions.

  • Lienzo

    Un nodo es un Blueprint dibujado en vivo desde su archivo, y un boceto se convierte en uno a través del mismo template.

  • Comentarios

    Un hilo se ancla a una sección o a un criterio de aceptación y se escribe al pie del archivo.

  • Agente de IA

    El Blueprint abierto acompaña a cada mensaje, y /check lleva la revisión de salud al chat.

  • Linter

    Un solo estilo de markdown en cada guardado, con los desvíos señalados en la revisión de salud.

  • Git

    Cada Blueprint tiene su historial y un diff, y entra en el mismo commit que el código que describe.

Desde la terminal

La revisión, desde una terminal

Los mismos hallazgos que muestra la página, con un código de salida para CI y --json para un agente. Una propiedad se fija desde la terminal, se convierte a su tipo declarado y se valida al escribirse.

$ eidos check specs/billing/gift-cards.md
Blueprints  (Eidos 5.5.0 · kebab-case)  1 blueprint

specs/billing/gift-cards.md
  ⚠ summary-missing      no `summary`; the collection index will flag it
  ⚠ work-tracking-field  `estimate` is a work-tracking field; a blueprint captures state and intent, not work (link to a tracker instead)
  ⚠ property-option      `status: WIP` is not one of its options (Draft, Intake, In Progress, Done, Archived, Deprecated)
  ⚠ linter/list-marker   one marker for every unordered list; the file drifted (eidos linter --fix)

⚠ 0 errors, 4 warnings
$ eidos property set @B-G24 status Draft
✓ specs/billing/gift-cards.md  status: Draft
  ⚠ summary-missing  no `summary`; the collection index will flag it
  ⚠ work-tracking-field  `estimate` is a work-tracking field; a blueprint captures state and intent, not work (link to a tracker instead)
Leer sobre Frameworks y Blueprints

Escribe qué estás creando.

Descarga Eidos MD, abre una carpeta y empieza por el Framework más cercano a tu trabajo. Todo lo que te da se puede remodelar después.

Gratis para macOS, Windows y Linux. Tus archivos siguen siendo texto simple en una carpeta que es tuya.