icpg

Visão geral do skill icpg

O que o skill icpg faz

O icpg adiciona uma “camada de POR QUÊ” à compreensão de código. Em vez de apenas mapear a estrutura, ele conecta funções, classes e módulos ao motivo de existirem, a quem pertencem e se ainda correspondem à intenção original. Se você precisa de icpg para Code Review, refatoração ou manutenção autônoma, o principal valor é reduzir o chute antes de alterar o código.

Para quem ele é mais indicado

O icpg funciona bem para engenheiros e agentes que atuam em codebases ativas, onde comportamento, ownership e intenção de design importam mais do que uma leitura rápida de sintaxe. Ele é especialmente útil quando o repositório já acumulou desvio, histórico de tarefas pouco claro ou perguntas recorrentes do tipo “por que isso foi escrito?”.

O que o torna diferente

O skill se apoia em ReasonNodes, contratos formais e detecção de drift em múltiplas dimensões. Isso significa que o icpg não é só um mapa de código; é uma camada de apoio à decisão para análise pré-tarefa. Na prática, isso traz mais segurança nas mudanças, contexto de revisão mais claro e menos edições que violam silenciosamente a intenção original.

Como usar o skill icpg

Instale e localize o arquivo principal

Use o fluxo de instalação de skill do repositório e, em seguida, comece por skills/icpg/SKILL.md. Como este repositório não expõe scripts auxiliares nem pastas de suporte, o próprio arquivo da skill é a principal fonte de verdade. Para uma decisão rápida de instalação, leia o frontmatter e as primeiras seções antes de qualquer outra coisa.

Transforme um objetivo vago em um prompt útil

icpg usage funciona melhor quando você fornece uma tarefa concreta, um caminho de destino e o formato desejado da saída. Bons exemplos de entrada são: “Revise src/payments/charge.ts para detectar drift de intenção antes que eu mude a lógica de retry” ou “Inicialize ReasonNodes para o fluxo de auth e identifique links de ownership ausentes.” Entradas fracas como “analise este repositório” são amplas demais e normalmente deixam de aproveitar os pontos fortes do skill em rastreamento de intenção.

Fluxo sugerido para a primeira utilização

Comece pedindo qual é o propósito pretendido do código-alvo; depois pergunte quais restrições ou contratos o protegem; por fim, pergunte onde o drift é mais provável. Essa sequência acompanha o design da skill e ajuda o agente a sair de estrutura, passar por intenção e chegar ao risco. Em fluxos com icpg guide, mantenha a solicitação centrada em um módulo ou em um conjunto de mudanças, em vez de apontar para o repositório inteiro.

O que ler primeiro no repositório

Comece por SKILL.md, especialmente pela declaração de propósito, pelos exemplos de CLI e pelas seções que cobrem o princípio central, as consultas canônicas de pré-tarefa, ReasonNode e os tipos de aresta. São os trechos com maior impacto sobre a decisão de adoção e sobre a qualidade da saída do icpg em Code Review.

FAQ do skill icpg

O icpg é só para agentes autônomos?

Não. O icpg é útil para humanos e agentes, mas ele é mais convincente quando o sistema precisa de raciocínio pré-tarefa repetível. Se você quer apenas um resumo pontual, um prompt normal pode ser suficiente; se você quer Code Review ou planejamento de mudança com noção de intenção, o icpg é uma opção melhor.

Como o icpg se compara a um prompt genérico de código?

Um prompt genérico pode resumir código, mas o icpg foi pensado para preservar intenção, ownership e contexto de drift entre tarefas. Isso o torna mais útil quando você precisa responder “para que esse código serve?” antes de mudá-lo, e não só “o que esse código faz?”.

O icpg é amigável para iniciantes?

Ele pode ser usado por iniciantes, mas os melhores resultados vêm de quem consegue nomear com precisão um arquivo, uma funcionalidade ou um limite de mudança. Se você é novo no repositório, comece com um único módulo e peça intenção, restrições e riscos de revisão, em vez de uma análise do sistema inteiro.

Quando eu não deveria usar o icpg?

Evite o icpg quando a tarefa for trivial, o código estiver isolado ou você só precisar de uma explicação rápida e superficial. Ele também é uma escolha ruim se você não consegue fornecer uma área-alvo ou qualquer contexto de mudança, porque o valor do skill depende de ligar o código a um motivo específico para existir.

Como melhorar o skill icpg

Dê um contexto de tarefa mais forte

Os melhores resultados com icpg vêm de prompts que incluem o objetivo da mudança, os arquivos afetados e o que não pode quebrar. Por exemplo, “revise src/billing para identificar drift depois da nova regra fiscal” é mais forte do que “verifique o código de billing”. Isso ajuda o skill a destacar os ReasonNodes e as restrições corretas para icpg for Code Review.

Peça intenção antes de implementação

Um modo comum de falha é ir direto para edições sem perguntar o que o código deveria proteger. Melhore a saída pedindo primeiro o propósito original, o contrato atual e o drift suspeito; depois, solicite o plano de mudança. Essa ordem reduz regressões desnecessárias e deixa o resultado da revisão mais confiável.

Use a primeira resposta para refinar a segunda

Se a primeira passada vier ampla demais, estreite o escopo por módulo, etapa do fluxo ou fronteira de ownership. Se a resposta ficar superficial, peça o contrato que está faltando, a dimensão de drift mais provável ou a canonical pre-task query mais adequada à tarefa. Iterar desse jeito costuma aumentar o sinal mais do que pedir uma resposta mais longa.

Mantenha o prompt alinhado ao design do skill

O icpg skill é mais forte quando você pede rastreamento de motivos, detecção de drift e análise pré-tarefa, e não apenas explicação de código. Se quiser melhorar o icpg usage, inclua o que significa “pronto”, que tipo de mudança você está considerando e qual parte da codebase está em escopo.