Decisões
ADR-0005 — Rabiscos desenhados por código
- Status: aceita
- Data: 2026-10-18
- Cumpre: ORG-0005
Contexto
Cada documento abre com um rabisco (ORG-0005). Desenhos feitos à mão numa ferramenta gráfica não se revisam em diff, não acompanham os tokens do design system e não se regeram quando um texto muda.
Decisão
- Os rabiscos são desenhados por código, em
eng/sketches/: o kitsketch.mjs(traço de lápis, Caveat, ícones, setas), o estilostyle.mjs(tokens do design system, dois temas) e um arquivo de quadros por documento emboards/. As fontes (Caveat e IBM Plex Mono) vêm de pacotes@fontsourcecom versão exata, as mesmas famílias da biblioteca: o kit não depende devendor/hibex/e desenha desde a Fase 0. node eng/sketches/build.mjsescreve um SVG autônomo por quadro emdocs/imagens/desenhos/, com as fontes embutidas, e copia o título de cada quadro para o texto alternativo da imagem nos documentos.- O texto ao redor diz o mesmo que o rabisco.
- O mesmo kit vai no modelo zerado, para as stacks seguirem a recomendação da ORG-0005.
- Enquanto o rabisco não for peça da biblioteca, as classes
sk-*ficam aqui, comhibex-pendentee um pedido ao design system.
Alternativas consideradas
| Alternativa | Por que não |
|---|---|
| Mermaid em todos os documentos | Por que não: sem a identidade da Hibex; pouco legível em diagramas grandes |
| Ferramenta gráfica (Excalidraw, Figma) | Por que não: não se revisa em diff; não segue os tokens nem os temas |
Consequências
- Mudar um rabisco é mudar código: revisável, e regerado com o design system.
- Cada quadro novo é conferido renderizado, nos dois temas, antes de entrar.