Un archivo, una unidad
Un solo archivo markdown es la fuente de verdad completa de una unidad de la cosa. Sin registros parciales repartidos entre una wiki, un ticket y la memoria de alguien.
εἶδοςeidos, sustantivo — de ἰδεῖν, ver
La forma o esencia de una cosa.
Platón lo usó para la Forma eterna; Aristóteles, para aquello que convierte la materia en una cosa concreta. Eidos es un estándar en markdown para poner esa forma por escrito.
Un solo archivo es la fuente de verdad completa de una unidad de lo que estás construyendo. Defínela con un estándar establecido, en archivos Markdown planos, guardados en el sistema que prefieras. Tus datos y tu contenido son tuyos.
---
id: resume-playback
title: Resume Playback
summary: Devuelve al espectador al segundo exacto en que lo dejó.
status: In Progress
domain: playback
connects_to:
- "[Watch History](../channels/watch-history.md)"
---
# Resume Playback
## Intent
Quien deja un vídeo a medias no debería tener que
buscar su sitio al volver…
## Behaviors & Acceptance Criteria
- AC1: La posición se guarda por espectador y por vídeo.
## Out of Scope
- Reanudar entre cuentas. Una tele compartida es un
dispositivo, no una persona.El frontmatter es el acuerdo. El cuerpo es la forma. Ambos viven en git.
El conocimiento del producto se pudre
Se dispersa en tickets que se cierran, wikis que nadie poda y las cabezas de quienes se van. Seis meses después, la única respuesta honesta a «¿qué se supone que es esta cosa?» es una reunión.
Lo que es, no el trabajo
Una tarea describe trabajo y muere cuando el trabajo se entrega. Un Blueprint describe la cosa, y sigue siendo exacto durante toda su vida: antes de existir, mientras se construye y después de retirarse.
Markdown plano, en tu repositorio
La carpeta vive junto al código que describe y se revisa en los pull requests. Sin SaaS, sin dependencia de proveedor, sin estado oculto.
La forma es portátil
Un Framework — colecciones, shapes, esquema, roles — es la pieza que un equipo entrega a otro. Un Framework, tantas raíces como quieras.
Cómo funciona
Dos palabras contienen toda la idea.
- Framework
- La forma: las colecciones, los shapes, los roles, la convención de nombres y el esquema de propiedades que rigen cómo escribes. Vive en el
_eidos/oculto de la raíz, y es la pieza portátil: la parte que un equipo entrega a otro. - Blueprint
- Una unidad, definida por completo: un solo archivo markdown, frontmatter más cuerpo, que es toda la fuente de verdad de una pieza de lo que estás construyendo.
Blueprints/ # la raíz — llámala como quieras
README.md # el "empieza aquí" humano
_eidos/ # el Framework — la forma
shapes/ # plantillas de cuerpo, una por flavor
roles/ # cómo habla el agente con cada rol
Framework.md # índice + configuración + esquema
frames/ # la colección de encuadre
specs/ # los Blueprints
index.md # hoja generada
playback/
resume-playback.md
roadmap.md # un documento de nivel superior — tuyoNada de lo anterior lo nombra el estándar
Una maquinaria, cualquier vocabulario.
EIDOS.md define colecciones, shapes, flavors y propiedades, nunca cómo se llama cada una. Eidos incluye tres frameworks semilla para que empieces por el más cercano y lo remodeles. Un framework que acabe sin parecerse a ninguno está funcionando como debe.
software
Un producto, servicio o sistema que se está construyendo.
- Encuadre
- frames — architecture, audience, criteria, market
- Unidades
- specs
- Agrupado por
- domain
- Flavors
- full · micro
book
Un libro, un argumento extenso o un curso.
- Encuadre
- frames — premise, reader, voice, market
- Unidades
- chapters
- Agrupado por
- part
- Flavors
- full · sketch
research
Una pregunta, un estudio o un programa de investigación.
- Encuadre
- frames — question, prior work, method, ethics
- Unidades
- investigations
- Agrupado por
- strand
- Flavors
- full · note
Primero las personas
La persona escribe. El agente facilita.
Una especificación es un control sobre el código, y un control solo es un control si viene de otro sitio. Deja que un agente escriba la especificación y luego el código, y cumplirá su propia especificación: todo concuerda, todas las revisiones pasan y no se ha verificado nada.
Un Blueprint que nadie ha pensado a fondo es peor que ninguno.
Por eso la intención, el alcance y las decisiones se quedan con una persona. El agente formatea, complementa, hace preguntas aclaratorias y presiona sobre el alcance. No escribe Blueprints por ti, y no marca la dirección.
Y si vas a ir totalmente autónomo, sin revisar ni decidir, entonces no escribas Blueprints en absoluto. Añadirían ceremonia, no corrección. Cuándo no usar Eidos →
Las herramientas son opcionales; el Framework no. Escribe cada archivo a mano si quieres, pero mantén _eidos/ en disco, porque un estándar que llevas en la cabeza se desvía. Si quieres ayuda, junto a él vienen nueve skills de agente, para Claude Code, Codex y cualquier otra cosa que lea un SKILL.md.
iteratecuestionar una idea hasta que deje de moverseeidosescribir y validarformatdar forma a un borrador en brutoinstallcrear una raíz nuevaconfigureañadir una colección, un flavor o una propiedadindexreconstruir el índice de una coleccióncanvasdibujar los Blueprints como un mapawhoamidecir quién está detrás del tecladomigratepasar a una nueva versión del estándar
Empieza por la semilla más cercana.
Eidos incluye tres frameworks de partida: uno para un producto, uno para un libro y uno para un programa de investigación. Toma el más cercano y remodélalo hasta que el vocabulario sea tuyo. Todo lo que te da una semilla se puede cambiar después, así que «lo bastante cerca» es la respuesta correcta.