Frames

Um frame (o enquadramento) é um Blueprint que descreve a coisa inteira em vez de uma unidade dela. Os frames definem aquilo contra o que qualquer outro Blueprint é julgado, e vivem na coleção de enquadramento.

Todo Framework declara uma coleção de enquadramento, e a declara primeiro.

Por que ela é obrigatória

É a única coisa estrutural em que o Eidos insiste além das cinco propriedades centrais:

Todo Framework declara uma coleção de enquadramento. O nome dela, seus flavors e quantos frames ela carrega são do próprio Framework: um Framework precisa de enquadramento, não de um conjunto específico de frames.

O raciocínio é que Blueprints não têm sentido se não houver nada contra o que julgá-los. “Esta spec deveria existir?” é impossível de responder se algo já não disser a quem o produto serve e o que ele tenta alcançar. Sem frames, uma raiz vira uma pilha de Blueprints razoáveis individualmente e sem direção comum, que é justamente o modo de falha que o Eidos existe para evitar.

O que as sementes enquadram

As três sementes mostram a mesma exigência respondida de três maneiras diferentes:

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

Repare que não são as mesmas quatro ideias renomeadas. Um programa de pesquisa precisa enquadrar a ética; um livro não. Um livro precisa enquadrar a voz; software não. O seu Framework deveria enquadrar aquilo contra o que o seu trabalho é de fato julgado, e se isso são três coisas ou seis, esse é o número certo.

Com o que se parece um frame

Cada tipo de frame ganha o seu próprio arquivo de flavor, frame.<kind>.md. Da semente software:

# {{title}}

## Shape

## Components

## Data and flow

## Boundaries and dependencies

Prosa solta sob títulos estáveis. Um frame registra o que é verdade agora, e é revisado sempre que esse julgamento muda. Ninguém deveria sentir que precisa prever o futuro para escrever um.

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

Isso confunde, então vale ser direto.

	Frame	Documento de nível superior
Onde	Na coleção de enquadramento	Na raiz
Shape	Segue um	Não tem
Frontmatter	Contrato completo	Livre
Validado?	Sim	Não
Listado no `Framework.md` sob	`## Collections`	`## Top-Level`
Repetido?	Sim, um por tipo	Não, é único

Os dois são prosa solta, revisada no lugar. A diferença é a repetição: um shape se paga sendo estampado de novo, e um documento escrito uma única vez não precisa de fôrma.

Preencha-os primeiro

A forma mais comum de errar com o Eidos é pular os frames e ir direto escrever Blueprints, porque Blueprints parecem progresso e frames parecem preâmbulo.

Preencha os frames primeiro. Leva uma tarde, quase toda de discussão, e a discussão é o valor: você descobre que duas pessoas vêm construindo para públicos diferentes antes que qualquer uma escreva uma spec que pressuponha um deles.

Depois, quando você escrever um Blueprint, terá algo concreto contra o que conferi-lo: isto serve ao público que o frame de Audience descreve? Cabe no orçamento e no prazo que o frame de Criteria define? Se a resposta for não, você encontrou algo que vale a pena saber antes de o trabalho começar.

No canvas

A semente software declara - **Canvas:** file para a sua coleção de enquadramento: cada frame é desenhado como um nó de arquivo inteiro em vez de cartão, porque um frame é prosa feita para ser lida por completo. Os Blueprints de uma coleção de specs são desenhados como cartões a partir de uma seção, porque esses a gente escaneia. Mais sobre o canvas →