DESTAQUE
Contexto que viaja com você_
O indexador do Cursor é excelente dentro do Cursor. O Maguyva é o mapa MCP hospedado que o mesmo agente pode consultar a partir de outros editores, CLIs e CI.
[Ecosystem]
[MCP]
[Portability]
> ls /var/log/decisions/*.md
Notas técnicas do desenvolvimento do Maguyva
Decisões de arquitetura, notas de implementação do MCP e o ocasional desabafo sobre coisas que não deveriam ser tão difíceis.
Último comunicado
Nota de build mais recente
Comece por aqui se você quiser a atualização técnica mais recente antes de mergulhar no arquivo.
Arquivo
Notas técnicas por tópico
Arquitetura, observabilidade, design da interface MCP e os padrões que sobreviveram ao contato com a produção.
Primeiro o mapa, depois a revisão_
Ancore o agente de código em um mapa do repo antes de ele escrever. Deixe o Greptile revisar o pull request depois. Uma dupla complementar, não uma troca.
[Ecosystem]
[Workflow]
[Code Review]
Dar a um agente de IA o contexto de um repositório grande sem indexador local_
Como dar a um agente de código um mapa consultável de um repositório grande a partir da nuvem, sem rodar um indexador local no seu notebook.
[AI Agents]
[MCP]
[Indexing]
[Monorepos]
Por que seu agente de código com IA alucina caminhos de arquivo_
Agentes de código com IA inventam caminhos de arquivo quando não têm um mapa real do repo. Aqui está o porquê, e como a fundamentação leva a menos edições alucinadas.
[AI Agents]
[Hallucination]
[Retrieval]
[MCP]
Por Que Atualizamos a Busca de Código para o voyage-4-large_
Migramos nossos embeddings de código para o voyage-4-large — atualmente no topo do ranking público RTEB de retrieval de código. A versão honesta: o trade-off que fazemos, o que realmente indexamos, e por que pagamos por embeddings premium.
[Embeddings]
[Busca]
[Arquitetura]
Autoaperfeiçoamento Recursivo do Suporte a Linguagens: Aprimorando a Inteligência de Código em ~280 Linguagens_
Damos suporte à inteligência de código para ~280 linguagens. Nenhum humano consegue auditar isso manualmente. Por isso construímos um loop de autoaperfeiçoamento recursivo do suporte a linguagens — verificação pontual, LLM como juiz, corrigir uma coisa, revalidar — e o rodamos com uma frota de agentes isolados até que a extração esteja realmente correta, não apenas verde.
[Arquitetura]
[Linguagens]
[Agentes]
Busca com Fusão Multimodal: Escolhendo o Retriever Certo Para Cada Consulta_
Uma consulta como 'onde parseConfig é definido' quer um tipo de busca diferente de 'como funciona a autenticação'. O Maguyva classifica a intenção, pondera quatro modalidades de retrieval de acordo, e funde os resultados com Reciprocal Rank Fusion ponderada.
[Busca]
[Arquitetura]
Observabilidade de Agentes: Hooks, Alloy e Grafana_
Conectamos o Claude Code e o Codex a uma única stack do Grafana com OpenTelemetry e Alloy, e depois usamos traces e logs para encontrar e corrigir problemas de comportamento dos agentes na origem.
[Observabilidade]
[Grafana]
[OpenTelemetry]
[Arquitetura]
Minerando o Loop: Como Mudanças Se Tornam Memória Institucional_
Commits do Git se tornam entradas estruturadas de changelog e registros de decisões arquiteturais, que depois realimentam agentes de IA como memória institucional consultável.
[Arquitetura]
[Workflows]
Mineração de Skills: De 3.500 Candidatas a 466 Capacidades_
Avaliamos 3.500 skills candidatas e adotamos 466. Um loop sistemático de mineração e ingestão para construir uma biblioteca coerente de skills para agentes de IA em escala.
[Arquitetura]
[Skills]
Divulgação Progressiva: Janelas de CLI para Sistemas de Agentes_
Sistemas de agentes são opacos por padrão. A divulgação progressiva dá aos operadores visões em camadas via CLI, de verificações rápidas de status até os detalhes internos completos dos agentes e o rastreamento de decisões.
[Arquitetura]
[CLI]
[Ferramentas]
Ground Truths: Ancorando Agentes de IA à Realidade_
Agentes de IA alucinam com confiança. Ground truths são fatos versionados e delimitados por escopo que ancoram o comportamento dos agentes à realidade. Veja como nós os construímos e os aplicamos.
[Arquitetura]
[Embasamento]
Orkestra: Orquestrando Agentes de IA em Escala_
Um orquestrador roteia trabalho para agentes de IA especialistas, cada um com skills e memória distintas. Como o Orkestra coordena 46 agentes e 466 skills em produção.
[Arquitetura]
[Open Source]
Fique por dentro
Esse é o arquivo completo_
Todo comunicado cai aqui primeiro. Os novos vão direto para o changelog, ou assine via RSS para ser avisado assim que um for publicado.
[Changelog] [RSS]