Começar
Aparência

Vale na hora e fica lembrada neste navegador.

Decisões

ADR-0005 — Rabiscos desenhados por código

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

  1. Os rabiscos são desenhados por código, em eng/sketches/: o kit sketch.mjs (traço de lápis, Caveat, ícones, setas), o estilo style.mjs (tokens do design system, dois temas) e um arquivo de quadros por documento em boards/. As fontes (Caveat e IBM Plex Mono) vêm de pacotes @fontsource com versão exata, as mesmas famílias da biblioteca: o kit não depende de vendor/hibex/ e desenha desde a Fase 0.
  2. node eng/sketches/build.mjs escreve um SVG autônomo por quadro em docs/imagens/desenhos/, com as fontes embutidas, e copia o título de cada quadro para o texto alternativo da imagem nos documentos.
  3. O texto ao redor diz o mesmo que o rabisco.
  4. O mesmo kit vai no modelo zerado, para as stacks seguirem a recomendação da ORG-0005.
  5. Enquanto o rabisco não for peça da biblioteca, as classes sk-* ficam aqui, com hibex-pendente e um pedido ao design system.

Alternativas consideradas

AlternativaPor que não
Mermaid em todos os documentosPor 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.