Design Briefs

Um design brief é um pacote de arquivos de referência HTML e CSS que você envia para que o tooling de geração de temas : o Claude via MCP, ou qualquer assistente a quem entregar o brief : veja exatamente o visual que você quer. Briefs são somente leitura: não tocam no seu site até um tema gerado os usar.

O fluxo de trabalho

Envie o brief (do painel Generate Theme da tela de Themes ou do painel compartilhado de Themes).
Crie um scaffold de tema : nomeie o tema, anexe o brief (e opcionalmente uma frase curta de “intent de design”), e o Chinaski produz tanto os arquivos iniciais clonados quanto um prompt pronto-para-copiar.
Entregue o prompt ao seu assistente : o prompt nomeia o ID do brief e diz ao leitor exatamente quais chamadas de ferramenta buscam cada arquivo de brief, para que o Claude (ou outro cliente MCP) possa ler seu design de referência antes de escrever arquivos de tema.
Itere : reenvie ou apague briefs a qualquer momento; briefs não têm efeito sobre o site ao vivo.

Enviando um brief

Do painel Generate da tela de Themes : ou da tela dedicada de Design Briefs : você envia:

um único arquivo .html ou .css, ou
um arquivo .zip desses arquvos (mantidos planos; arquivos em subdiretórios são pulados)

Regras que o upload impõe:

Tamanho: 3 MB por upload no máximo (a checagem no lado do navegador evita surpresas de início).
Tipos de arquivo: apenas .html, .css e .zip. Dentro de um zip, apenas arquivos .html/.css são mantidos : outros formatos e extensões desconhecidas são ignorados.
Contagem: no máximo 20 arquivos por zip.
Ao menos um HTML: um brief deve conter ao menos um arquivo .html; uploads sem um são rejeitados com um erro.
Padrão de nome de arquivo: letras minúsculas, dígitos, underscore, traço, ponto, com uma extensão .html ou .css. Entradas de diretório num zip são descartadas (achatadas) para que nenhum conteúdo de path-traversal seja extraído.

Rotule seu brief primeiro (por exemplo “Kitchen Sink”) para que a lista e o dropdown Generate sejam fáceis de usar. Briefs sem rótulos exibem como “(untitled)”.

Onde os briefs vivem

Cada brief ganha um UUID e um diretório próprio: uploads/design-briefs/<uuid>/.
As telas listam os briefs com Label, contagem de arquivos, Uploaded (UTC), e um botão Delete em cada linha (com uma confirmação de exclusão irreversível).
Tanto a página de Design Briefs quanto o seletor de arquivos em Themes impõem o mesmo limite de 3 MB antes do upload.

De onde os briefs são lidos

Os arquivos de referência voltam por três canais:

Ferramentas MCP para o Claude e todo outro cliente MCP: list_design_briefs (id, label, timestamp de envio, contagem de arquivos), list_design_brief_files, e read_design_brief_file (consumindo o HTML/CSS cru do brief como texto puro).
A API REST (chaves de API de permissão de leitura): /api/themes/design-briefs para a lista, a lista de arquivos do brief, e o conteúdo cru arquivo a arquivo.
O prompt do painel Generate : o prompt de criação de tema diz à sua IA para chamar a ferramenta-helper listada com o ID do brief para ler todos os arquivos de referência antes de escrever código de template.

Apagando

Apagar um brief remove tanto a linha de metadados quanto os arquivos dele, após uma confirmação explícita (“Delete this design brief and its files? This cannot be undone.”).

O que os briefs não podem fazer

Briefs são material de referência puro : o Chinaski nunca chama uma IA por si mesmo. O painel Generate devolve um prompt pronto-para-copiar para você executar no seu próprio assistente; aquele prompt aponta aos arquivos do brief por seus IDs, e seu assistente os busca através das ferramentas MCP ou da API somente leitura.