Pitch: Fiz uma ferramenta que analisa seu projeto antes de exportar contexto pra IA
Provavelmente já existe algo parecido por aí, mas eu precisava de uma coisa
assim com frequência e acabei construindo do zero. No meu fluxo de trabalho,
fico constantemente juntando contexto de projetos pra mandar pra uma IA, e
fazer isso na mão toda vez estava ficando chato demais.
Primeiro fiz o mdcodebrief, que varre o projeto e gera um .md com tudo. Resolvia
o problema básico, mas mandava coisa demais. A IA recebia 50k tokens de código e
ficava no maior esforço pra entender o que importava.
Aí evoluí pra ideia do Contexta. A diferença é que ele analisa o projeto antes de
exportar. Ele tenta entender quais arquivos são centrais, quais têm mais
dependentes, o que mudou no git, e só então monta o pack.
A saída inclui coisas como:
- um resumo do projeto com tecnologias e entry points detectados
- uma seção "Read This First" mostrando por onde começar a leitura
- o fluxo principal de execução
- mapa de relacionamentos entre módulos
- os arquivos selecionados com o motivo de cada um ter entrado
Tem alguns packs prontos dependendo do que você quer fazer: onboarding, debug,
PR review, refactor. Também dá pra ajustar modo, compressão e perfil de IA alvo.
É Python puro, sem dependências externas. Roda pelo .exe no Windows ou direto
pelo código em qualquer sistema com Python instalado.
Ainda é cedo e tem bastante coisa pra melhorar, mas já uso no dia a dia e tem
ajudado bastante. Qualquer feedback é bem-vindo.