Deep Wiki: E se cada repositório do GitHub fosse um wiki?
Vi o Akita falando sobre o deepwiki.com e achei bem interessante. A IA Devin indexa automaticamente repositórios no GitHub e cria wikis explicando vários pontos do repositório.
Devin now automatically indexes your repos and produces wikis with architecture diagrams, links to sources, and summaries or your codebase.
Fonte: Devin Wiki.
Como é um conteúdo gerado por LLM, tem erros, mas tem bastante coisa útil. Eu vi como exemplo a Wiki do repositório do TabNews: deepwiki.com/filipedeschamps/tabnews.com.br. Lá tem detalhes sobre a arquitetura do frontend, backend, a economia dos TabCoins e TabCash, documentação da API, guia para desenvolver o projeto etc.
Exemplo de lista de endpoints na documentação da API:
Exemplo de diagrama do contexto geral de sessões:
Acho que se você tem interesse em algum repositório público, vale a pena dar uma olhada no site deepwiki.com para entender melhor o projeto. Mesmo que não esteja tudo certo, ou que tenham pontos faltando, é uma base decente se você estiver com dificuldade de entender diretamente o repositório. Vale lembrar que a fonte mais confiável continua sendo o código no repositório.
A wiki também parece uma boa inspiração para você documentar um projeto seu, em especial porque você deve entender bem do projeto e conseguirá identificar o que está certo e o que é importante na Deep Wiki.
Legal o Deep Wiki. Bonito ver uma IA criando diagramas, explicações e documentações inteiras de um projeto alheio. Mas me pergunto: estamos ficando mais eficientes ou só mais preguiçosos?
Porque, convenhamos, a maioria já não lê o README. Agora então, com tudo digerido por LLM, tem gente que vai achar que entende o projeto só porque leu o resumo do resumo feito por um modelo que nunca rodou o código.
Sim, ajuda. Sim, pode servir de porta de entrada. Mas e se a gente estiver substituindo o entendimento real por um consumo instantâneo de pseudo-conhecimento?
Deep Wiki é útil. Mas perigoso. Porque seduz. Seduz quem quer parecer que entendeu sem precisar abrir o código. Seduz quem quer diagramas bonitos em vez de leitura cuidadosa. Seduz quem acha que contexto é commodity.
E o pior: vai ter dev usando isso pra documentar o próprio projeto como se fosse suficiente. Spoiler: não é.
Você pode usar a Deep Wiki como base, mas se não souber revisar, corrigir, e principalmente explicar melhor do que ela… então talvez nem seja o seu projeto, só o seu repositório hospedando uma abstração rasa.
A ferramenta é boa. O risco é o uso passivo.
Porque o que está em jogo não é a qualidade da IA. É a profundidade do seu pensamento.
Eu tenho muita dificuldade em ler código alheio, em especial de repositórios grandes como o React. Não consigo achar o entry point da aplicação naquele monte de pastas. Imagino que minha mente funcione melhor com coisas lineares (não sei se é bom o ruim).
Achei muito interessante isso e é uma ideia muito boa. Quem criou isso certamente está utilizando tecnologia do jeito certo, resolver problemas.
Interessante, estarei salvando para aplicar nos meus projetos. Automatiza e acelera produtividade,