Agentica, o sistema de decisão para humanos e agentes de AI

Um design system pessoal construído para provar uma tese: decisões de design deveriam sobreviver às ferramentas, aos frameworks e às pessoas que as construíram. Zero dependência de fornecedor.

Contexto / problema

A maioria dos design systems documenta o que foi construído. Poucos preservam o porquê. As equipes perdem decisões em comentários do Figma, threads do Slack e conhecimento tácito, então os mesmos debates se repetem, a documentação fica desatualizada, e o sistema se torna dependente da única pessoa que se lembra do raciocínio. Eu construí a Agentica para testar se esse problema é solucionável, não para um cliente, mas como prova de um modelo de governança que, na minha opinião, falta na maioria dos design systems corporativos.

Decisões e governança

Cada escolha significativa na Agentica é registrada como um Architecture Decision Record versionado, contexto, alternativas consideradas, trade-offs e o raciocínio por trás da decisão final. Isso não é documentação feita depois; é o mecanismo que permite ao sistema evoluir sem apagar sua própria história.

A Agentica também é construída com agentes de AI como um ator definido no sistema, com um limite explícito. Os agentes podem detectar inconsistências, propor componentes e redigir documentação. Eles não podem aprovar, implantar ou contornar a governança. O humano mantém a palavra final, por design, não por convenção.

  1. Decidir
  2. Governar
  3. Sistematizar
  4. Executar

Arquitetura

Uma única fonte de verdade alimenta quatro níveis: fundações (tokens), contratos semânticos, componentes e aplicações. Os componentes são construídos como Web Components nativos, independentes de framework, compilados para CSS, JS, Tailwind, Angular, iOS e Android. Se o ferramental de AI ao redor desaparecesse amanhã, o sistema continuaria funcionando: documentado, com scripts e testado para provar isso.

Resultado / prova

Site ao vivoGitHubStorybook