Frames

Um frame (o enquadramento) é um Blueprint (plano) que descreve o produto inteiro em vez de uma unidade dele: a quem serve, o que tenta alcançar, como é construído. Todos os outros Blueprints são julgados contra eles. Os frames vivem em uma coleção de enquadramento, uma coleção como qualquer outra, cujos templates (modelos) se chamam frame.<variant>.md.

O padrão não exige uma. Toda semente abre com uma, eidos install a inclui a menos que você passe --no-framing, e o Eidos recomenda uma para todo produto.

Por quê

“Esta spec deveria existir?” é impossível de responder a menos que algo já diga a quem o produto serve e para que ele é. Sem frames, uma raiz vira uma pilha de Blueprints razoáveis individualmente e sem direção comum.

O que as sementes enquadram

Semente	Seus frames
`software`	architecture · audience · criteria · market
`book`	premise · reader · voice · market
`research`	question · prior work · method · ethics

Não são as mesmas quatro ideias renomeadas. Pesquisa precisa enquadrar a ética; um livro precisa da voz. Enquadre aquilo contra o que o seu trabalho é de fato julgado, sejam três coisas ou seis.

Com o que se parece um frame

Cada tipo de frame é a sua própria variant (variante). Da semente software:

# {{title}}

## Shape

## Components

## Data and flow

## Boundaries and dependencies

Prosa solta sob títulos estáveis, registrando o que é verdade agora e revisada sempre que esse julgamento muda. Os frames ficam planos na sua coleção, um arquivo por tipo.

Frames são Blueprints, não documentos de nível superior

Os dois são prosa solta revisada no lugar. A diferença é a repetição: um frame segue um template, carrega o contrato de propriedades e é validado, porque há um por tipo. Um documento de nível superior é escrito uma vez e não recebe nada disso.

Preencha-os primeiro

O jeito mais comum de errar o Eidos é pular os frames, porque Blueprints parecem progresso e frames parecem preâmbulo. Preenchê-los leva uma tarde, a maior parte discussão, e a discussão é o valor: você descobre que duas pessoas estavam construindo para audiências diferentes antes de qualquer uma escrever uma spec que assumisse uma delas.

Um frame declarado e não escrito é uma lacuna que o eidos check traz à tona, nunca uma falha.