Durante muito tempo, código e documentação seguiram caminhos diferentes.
O código evoluía rápido.
A documentação, nem tanto.

Eu já perdi boas horas tentando entender um sistema que só fazia sentido pra quem escreveu.
E, claro, a documentação não ajudava.

Fazer diagramas bonitos dava trabalho.
Não dá mais.

Agora, fazer um bom diagrama é fazer código — coisa que todo programador gosta.
E o melhor é que ele fica versionado, revisável e sempre atualizado junto com o projeto.

Em tempos de IA, isso fica ainda mais interessante.
A IA pode ler esses diagramas, entender o sistema e até ajudar a gerar ou manter essa documentação viva.

O resultado é um ciclo em que o sistema se explica cada vez melhor.

Desenvolver nunca foi só programar.
Sempre foi construir conhecimento compartilhável.
Antes era com gente.
Agora, também é com a máquina.

Ver isso acontecendo é como ver o código ganhando voz.

E o ponto é: essa colaboração muda completamente a forma como a gente pensa arquitetura e comunicação técnica.

É sobre isso que vou falar na masterclass “Diagramas como Código e IA: um casamento perfeito”. Dia 21/10.

Um encontro com o pessoal do clube de estudos pra mostrar, na prática, como estou usando essa integração pra construir sistemas mais claros, vivos e fáceis de evoluir.

Se você quer enxergar além do código, essa conversa é pra você.