# Workshop IA — contexto oficial para agentes de IA

Versão: `1.0.0`  
Atualizado em: `2026-07-16`  
URL canônica: `https://workshop.razoesparaacreditar.com/design-system/`

## Instrução de uso

Este diretório é a fonte oficial do Design System Mestre do Workshop IA — Transformando Histórias em Conteúdos que Emocionam com IA.

Ao criar páginas, anúncios, apresentações, documentos, e-mails ou materiais de aula:

1. leia primeiro o manual completo;
2. use os tokens como fonte da verdade para valores;
3. consulte as regras específicas do canal;
4. preserve a hierarquia entre história, método e tecnologia;
5. não invente métricas, datas, preços ou provas que não estejam no briefing atual;
6. trate fatos variáveis de campanha como conteúdo externo ao design system;
7. não use o sistema como justificativa para futurismo neon, robôs ou clichês visuais de IA.

## Essência

**Editorial de histórias + laboratório de garimpo.**

Princípio visual:

> Petróleo estrutura. Papel respira. Magenta emociona. Lima comprova.

A identidade deve parecer humana antes de parecer tecnológica. A tecnologia aparece como ferramenta; histórias, repertório, observação e significado são protagonistas.

## Ordem de autoridade dos arquivos

1. [`tokens.json`](https://workshop.razoesparaacreditar.com/design-system/tokens.json) — valores portáveis e automações.
2. [`tokens.css`](https://workshop.razoesparaacreditar.com/design-system/tokens.css) — implementação web.
3. [`components.css`](https://workshop.razoesparaacreditar.com/design-system/components.css) — componentes reutilizáveis.
4. [`README.md`](https://workshop.razoesparaacreditar.com/design-system/README.md) — decisões e regras completas.
5. [`content-guidelines.md`](https://workshop.razoesparaacreditar.com/design-system/content-guidelines.md) — voz e arquitetura da mensagem.
6. [`application-matrix.md`](https://workshop.razoesparaacreditar.com/design-system/application-matrix.md) — regras por canal e formato.
7. [`assets/manifest.json`](https://workshop.razoesparaacreditar.com/design-system/assets/manifest.json) — função e restrições dos assets.
8. [`index.html`](https://workshop.razoesparaacreditar.com/design-system/) — referência visual.

## Recursos para consumo automatizado

- [Design system completo em um único arquivo](https://workshop.razoesparaacreditar.com/design-system/llms-full.txt)
- [Índice llms.txt](https://workshop.razoesparaacreditar.com/design-system/llms.txt)
- [Manifesto do sistema](https://workshop.razoesparaacreditar.com/design-system/design-system.json)
- [Changelog](https://workshop.razoesparaacreditar.com/design-system/CHANGELOG.md)

## Resumo operacional

- Fraunces: títulos, teses, descobertas e emoção.
- Manrope: explicação, interface, leitura e conversão.
- IBM Plex Mono: dados, etapas, datas, etiquetas e processo.
- Petróleo: base, autoridade e estrutura.
- Papel: leitura e espaço negativo.
- Magenta: emoção, palavra-chave, rota e descoberta.
- Lima: prova, conclusão, status e número relevante.
- Logo do Workshop: assinatura principal de produtos e eventos.
- Logo do Razões: chancela de origem e autoridade.
- Beija-flor: sinal de passagem e origem, usado com parcimônia.

## Critério final

Uma aplicação correta deve:

- ser compreensível sem depender de efeitos;
- possuir um foco visual principal;
- tornar visível observação, descoberta, significado ou transformação;
- usar IA como ferramenta, não como protagonista;
- respeitar contraste, área segura e hierarquia;
- conter evidência concreta quando houver promessa;
- usar somente informações variáveis confirmadas no briefing atual.