O que indexion-agent-orient faz?
Gere e use um resumo estrutural pré-edição para que agentes de codificação aprendam possíveis proprietários, superfícies consumidoras e locais de edição inseguros antes de implementar.
Visão Geral
Esta skill ajuda agentes de codificação a entenderem melhor o código antes de fazer alterações, reduzindo o risco de introduzir bugs ou quebrar funcionalidades existentes. Ela cria um resumo estruturado que destaca:
- Possíveis proprietários: Módulos ou times responsáveis por partes específicas do código.
- Superfícies consumidoras: Funções, APIs ou componentes que são usados por outros módulos.
- Locais de edição inseguros: Áreas do código onde alterações podem ter consequências imprevistas.
Como usar
Para usar esta skill, o agente deve:
- Analisar a base de código para identificar dependências e padrões de uso.
- Gerar um resumo estruturado contendo as seções acima.
- Usar o resumo como contexto antes de realizar edições.
Exemplo
proprietarios:
- modulo: "src/auth"
time: "Equipe de Autenticação"
- modulo: "src/api"
time: "Equipe de API"
superficies_consumidoras:
- funcao: "login()"
consumida_por: ["src/frontend", "src/mobile"]
- endpoint: "/users"
consumido_por: ["src/api", "src/admin"]
locais_edicao_inseguros:
- arquivo: "src/core/config.js"
razao: "Alterações podem afetar todos os módulos dependentes"
- funcao: "sendEmail()"
razao: "Usada internamente por vários serviços"
Benefícios
- Redução de erros: Agentes têm menos chances de quebrar dependências.
- Eficiência: Menos iterações de tentativa e erro.
- Manutenibilidade: Alterações mais alinhadas com a arquitetura do projeto.
Plataformas Suportadas
- Claude Code
- Cursor
- Codex
- Outros agentes de codificação compatíveis com markdown estruturado.
Notas
- O resumo é gerado dinamicamente com base na análise do código.
- Pode ser integrado no fluxo de planning antes da implementação.
- Ideal para bases de código onde o contexto é crítico.