Como a Credit Genie mantém a documentação de código sempre atualizada com o OpenWiki

Como a Credit Genie mantém a documentação de código sempre atualizada com o OpenWiki

Documentação desatualizada é um problema universal de engenharia — e piora com o tempo: conhecimento fica preso a indivíduos, o “conhecimento tribal” se acumula e agentes de codificação passam a agir com contexto incompleto. A Credit Genie, fintech de bem-estar financeiro, resolveu isso adotando o OpenWiki, o agente open-source de documentação de repositórios da LangChain.

O problema antes do OpenWiki

Antes, a equipe mantinha páginas no Notion, arquivos README e AGENTS.md por projeto. Num ambiente que muda rápido, esse conteúdo ficava obsoleto — e era difícil de encontrar, não só para pessoas. Agentes de codificação esbarravam no mesmo obstáculo: sem uma fonte confiável, tinham dificuldade de entender o que um repositório fazia ou como um subsistema funcionava.

A solução: documentação como parte do ciclo de vida do código

O que começou como um projeto paralelo de Mattia Ciollaro, Head de AI e ML da Credit Genie, virou uma “apólice de seguro de conhecimento institucional”. Mattia adaptou o OpenWiki para construir um portal self-service hospedado no GitHub Pages, que agrega a documentação de todos os repositórios integrados numa interface única e pesquisável.

A documentação vive dentro de cada repositório, na pasta openwiki/. O OpenWiki roda diariamente, verifica mudanças de commit e gera atualizações quando encontra diferenças significativas, abrindo um pull request. Para integrar um novo repositório, basta uma mudança na configuração do portal, que dispara um pull request automatizado adicionando o workflow do OpenWiki ao repositório-alvo.

Removendo o atrito

Para eliminar gargalos de merge, a Credit Genie adicionou uma ação que aprova e mescla automaticamente os PRs de atualização do OpenWiki. Um job de varredura roda diariamente em todos os repositórios, mescla as atualizações pendentes e reconstrói o portal — sempre com o conteúdo mais recente. O resultado, nas palavras de Mattia: “OpenWiki nos permite fazer da documentação parte do ciclo de vida do código, em vez de tratá-la como uma tarefa separada.”

Próximos passos

O próximo objetivo é incorporar o grafo de conhecimento entre repositórios ao OpenWiki, mostrando não apenas o que cada repositório faz, mas como ele se conecta a outros sistemas e como mudanças podem se propagar — dando a engenheiros e agentes uma visão clara do “raio de impacto” antes de alterar código.