εἶδοςeidos, substantivo — de ἰδεῖν, ver

A forma ou essência de uma coisa.

Platão a usou para a Forma eterna; Aristóteles, para aquilo que torna a matéria uma coisa particular. Eidos é um padrão em markdown para colocar essa forma no papel.

Um único arquivo é a fonte de verdade completa de uma unidade do que você está construindo. Defina-a com um padrão estabelecido, em arquivos Markdown simples, guardados no sistema que você quiser. Seus dados e seu conteúdo são seus.

Ler a documentação

Blueprints/specs/playback/resume-playback.md

---
id: resume-playback
title: Resume Playback
summary: Devolve o espectador ao segundo exato em que parou.
status: In Progress
domain: playback
connects_to:
  - "[Watch History](../channels/watch-history.md)"
---

# Resume Playback

## Intent
Quem sai no meio de um vídeo não deveria ter que
procurar onde parou ao voltar…

## Behaviors & Acceptance Criteria
- AC1: A posição é salva por espectador e por vídeo.

## Out of Scope
- Retomar entre contas. Uma TV compartilhada é um
  dispositivo, não uma pessoa.

O frontmatter é o acordo. O corpo é a forma. Os dois vivem no git.

O conhecimento do produto apodrece

Ele se espalha por tickets que fecham, wikis que ninguém poda e as cabeças de quem vai embora. Seis meses depois, a única resposta honesta para “o que essa coisa deveria ser?” é uma reunião.

Um arquivo, uma unidade

Um único arquivo markdown é a fonte de verdade completa de uma unidade da coisa. Sem registros parciais espalhados por uma wiki, um ticket e a memória de alguém.

O que é, não o trabalho

Uma tarefa descreve trabalho e morre quando o trabalho é entregue. Um Blueprint descreve a coisa, e continua exato por toda a vida dela: antes de existir, enquanto é construída e depois de ser aposentada.

Markdown simples, no seu repositório

A pasta fica ao lado do código que descreve e é revisada nos pull requests. Sem SaaS, sem aprisionamento, sem estado escondido.

A forma é portátil

Um Framework — coleções, shapes, esquema, papéis — é a peça que um time entrega a outro. Um Framework, quantas raízes você quiser.

Como funciona

Duas palavras carregam a ideia inteira.

Framework: A forma: as coleções, os shapes, os papéis, a convenção de nomes e o esquema de propriedades que regem como você escreve. Vive no _eidos/ oculto da raiz, e é a peça portátil: a parte que um time entrega a outro.
Blueprint: Uma unidade, definida por completo: um único arquivo markdown, frontmatter mais corpo, que é toda a fonte de verdade de uma peça do que você está construindo.

Framework e Blueprint, em detalhe

Blueprints/       # a raiz — dê o nome que quiser
  README.md       # o "comece aqui" humano
  _eidos/         # o Framework — a forma
    shapes/       #   modelos de corpo, um por flavor
    roles/        #   como o agente fala com cada papel
    Framework.md  #   índice + configuração + esquema
  frames/         # a coleção de enquadramento
  specs/          # os Blueprints
    index.md      #   folha gerada
    playback/
      resume-playback.md
  roadmap.md      # um documento de nível superior — seu

Nada acima é nomeado pelo padrão

Uma máquina, qualquer vocabulário.

EIDOS.md define coleções, shapes, flavors e propriedades, nunca como cada uma se chama. O Eidos vem com três frameworks semente para você começar pelo mais próximo e remodelá-lo. Um framework que acabe não se parecendo com nenhum deles está funcionando como deveria.

`software`

Um produto, serviço ou sistema em construção.

Enquadramento: frames — architecture, audience, criteria, market
Unidades: specs
Agrupado por: domain
Flavors: full · micro

`book`

Um livro, um argumento longo ou um curso.

Enquadramento: frames — premise, reader, voice, market
Unidades: chapters
Agrupado por: part
Flavors: full · sketch

`research`

Uma pergunta, um estudo ou um programa de investigação.

Enquadramento: frames — question, prior work, method, ethics
Unidades: investigations
Agrupado por: strand
Flavors: full · note

Ver os três, desenvolvidos

Pessoas primeiro

A pessoa escreve. O agente facilita.

Uma especificação é uma checagem do código, e uma checagem só é uma checagem se vier de outro lugar. Deixe um agente escrever a especificação e depois o código, e ele vai satisfazer a própria especificação: tudo concorda, toda revisão passa e nada foi verificado.

Um Blueprint que ninguém pensou é pior do que nenhum.

Por isso a intenção, o escopo e as decisões ficam com uma pessoa. O agente formata, complementa, faz perguntas de esclarecimento e pressiona sobre o escopo. Ele não escreve Blueprints por você, e não define a direção.

E se você vai ser totalmente autônomo, sem revisar nem decidir, então não escreva Blueprints de jeito nenhum. Elas acrescentariam cerimônia, não correção. Quando não usar o Eidos →

As ferramentas são opcionais; o Framework não é. Escreva cada arquivo à mão se quiser, mas mantenha _eidos/ em disco, porque um padrão que você guarda na cabeça se desvia. Se quiser ajuda, nove skills de agente vêm junto, para Claude Code, Codex e qualquer outra coisa que leia um SKILL.md.

Ver as skills

Comece pela semente mais próxima.

O Eidos vem com três frameworks de partida: um para um produto, um para um livro e um para um programa de investigação. Pegue o mais próximo e remodele até o vocabulário ser seu. Tudo o que uma semente te dá pode ser mudado depois, então “perto o suficiente” é a resposta certa.

Início rápido Por que o Eidos existe