Cada parte do seu produto, um arquivo que você pode verificar.
Um Blueprint (o plano) é um arquivo markdown simples: propriedades tipadas no topo, um corpo moldado por um template (o modelo) e um id permanente para o qual cada tarefa, decisão e nó da Tela aponta. Você declara o Framework (a estrutura) que ele segue, e o eidos check mostra onde um arquivo se afastou dele.
Grátis para macOS, Windows e Linux. Sem conta, sem assinatura.
O seu Framework
Uma estrutura que você declara, não uma que te entregam
O Framework vive na sua raiz: as coleções que você mantém (specs, capítulos, personagens, investigações, aquilo de que o seu trabalho é feito), um template para cada variant (a variante) com as seções que ele oferece e as que exige, e uma tabela Properties (as propriedades) com tipos, opções e o que cada uma significa. Edite tudo como formulários em Configurações do Framework, ou com eidos configure pelo terminal.
- Coleções e variants, com nomes nas suas palavras
- Seções obrigatórias e propriedades tipadas com opções
- Vocabulary (o vocabulário) e papéis, para que pessoas e agentes usem as mesmas palavras
A verificação de saúde
Uma verificação de saúde que leva à ação
O eidos check lê cada Blueprint contra o seu Framework: um valor fora das opções de uma propriedade, uma propriedade obrigatória vazia, um campo de acompanhamento de trabalho em um Blueprint, um índice desatualizado, um link quebrado. A Verificação de saúde lista cada apontamento sob o seu arquivo, e Corrigir tudo o que for possível roda todas as correções que o app conhece, perguntando antes de qualquer uma que renomeie um arquivo ou mude um id.
- Erros para o que está errado em qualquer leitura, avisos para lacunas
- Se um aviso reprova ou não é configuração da raiz, guardada no git
- Os mesmos apontamentos no app, no terminal e na CI
O Registro
Comece por um Framework que alguém já moldou
O Registro guarda Frameworks que as pessoas publicaram: software, um livro, pesquisa, um mundo de ficção, um canal, uma escola, uma reforma, um casamento e mais. Abra um no app e cada peça aparece marcada como ausente da sua raiz, igual ou diferente. Incluir nesta raiz traz tudo ou só a coleção que você quer, e pergunta antes de substituir qualquer coisa que você tenha de outro jeito.
- No app, ou com
eidos install @owner/name - Manter o atual ou Aceitar o que chega, conflito por conflito
- Publique o seu com um pull request
Coleções
Cada coleção é uma tabela
Cada coleção se abre como uma tabela dos seus Blueprints, ordenada, filtrada e pesquisada por qualquer propriedade. Os filtros ficam no endereço, então um link abre a mesma visão, e Salvar como visão guarda uma para você ou a compartilha com todos na raiz.
Apontado, nunca recusado
As propriedades são o acordo e as seções são orientação. Uma propriedade que falta é anotada e uma seção que falta é oferecida; um arquivo nunca é recusado, porque uma verificação que recusa arquivos acaba sendo contornada. Uma seção que o Blueprint não tem aparece esmaecida onde pertence, com um + que a adiciona.
Um id permanente, aonde quer que o arquivo vá
Cada Blueprint guarda um id como B-V63. Mova-o para outro grupo, ou dê a ele um id novo, e cada tarefa, decisão, comentário, nó da Tela e link que aponta para ele acompanha. Encontre qualquer coisa por id ou título na Abertura rápida.
Configure com o seu agente
Ao criar uma raiz nova no app de desktop, Configurar com o Agente de IA pode fazer o seu agente ler a pasta primeiro e depois recomendar um Framework do Registro ou propor um próprio. Nada é escrito até você revisar e apertar Criar a raiz.
Como se conecta
Todo o resto aponta para um Blueprint.
Nenhum plugin guarda uma segunda cópia do que um Blueprint diz. Cada um se refere a ele pelo id permanente, e a maioria escreve de volta nele o que sabe.
- Backlog
Uma tarefa serve a Blueprints pelo id, e cada Blueprint lista as suas tarefas em Tarefas anexadas e em uma seção de tarefas.
- Decisões
Uma decisão nomeia os Blueprints para os quais foi tomada e é escrita na seção de decisões de cada um.
- Tela
Um nó é um Blueprint desenhado ao vivo a partir do arquivo, e um esboço vira um Blueprint pelo mesmo template.
- Comentários
Um tópico se ancora em uma seção ou em um critério de aceitação e é escrito no pé do arquivo.
- Agente de IA
O Blueprint aberto vai junto com cada mensagem, e
/checkroda a verificação de saúde dentro do chat. - Linter
Um só estilo de markdown a cada salvamento, com os desvios apontados na verificação de saúde.
- Git
Cada Blueprint tem o seu histórico e um diff, com commit junto com o código que ele descreve.
Pelo terminal
A verificação, pelo terminal
Os mesmos apontamentos que a página mostra, com um código de saída para a CI e --json para um agente. Uma propriedade é definida pelo shell, convertida no tipo declarado e verificada no momento em que é escrita.
$ 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)Escreva o que você está criando.
Baixe o Eidos MD, abra uma pasta e comece pelo Framework mais próximo do seu trabalho. Tudo o que ele te dá pode ser remodelado depois.
Grátis para macOS, Windows e Linux. Seus arquivos continuam texto simples, em uma pasta que é sua.