Engenharia de software
Mapeie o raio de impacto de uma mudança de código
Um mapa de impacto que acompanha um diff proposto por chamadores, dependências, dados, implantações, testes e caminhos do cliente para revelar consequências ocultas antes da implementação.
O processo
Faça nesta ordem.
- Defina a mudança proposta, as revisões base e head, o resultado pretendido, os arquivos no escopo, as premissas e as decisões que o mapa deve informar.
- Inspecione o diff e os dependentes diretos e pesquise chamadores, imports, interfaces, código gerado, configuração e testes usando apenas as ferramentas disponíveis.
- Mapeie estaticamente efeitos em APIs, leituras e gravações de dados, filas, jobs, permissões, feature flags, configurações de implantação e caminhos visíveis ao cliente.
- Mapeie responsáveis, cobertura de testes, observabilidade, dependências e restrições de migração, classificando cada superfície como direta, provável, possível ou desconhecida e mantendo a evidência estática separada das premissas de runtime.
- Identifique lacunas de validação, acessibilidade, compatibilidade, rollback e observabilidade; proponha as menores verificações seguras, mas não execute testes, comandos de pacotes ou caminhos de runtime.
- Resuma o impacto e a reversibilidade, identifique ou avalie o risco de dados sensíveis e código não confiável sem incluir valores secretos ou sensíveis, e solicite aprovação separada para qualquer teste ou comando de pacote necessário.
- Salve o mapa e as evidências brutas não secretas no workspace de destino do Latch, informe limites de cobertura e riscos não resolvidos, e pare sem alterar o repositório ou o estado remoto.
Traga isto
Entradas que o gato vai pedir.
- revisões base e head ou diff
- mudança pretendida e escopo
- contexto de execução e implantação
- tolerância ao risco e responsáveis pela revisão
Roteador + um playbook
Roteie primeiro. Escolha um.
O Cat Paw carrega um playbook por tarefa, sem misturar vários. Comece por este roteador; os outros caminhos são candidatos específicos do workflow.
- Roteador:
code-graph-pack skills/code-graph-pack/code-change-blast-radius-map/SKILL.md
Limites
As fronteiras viajam com o prompt.
- Verifique as ferramentas, contas, permissões e o espaço de trabalho reais antes de começar; nunca afirme que uma ferramenta, conta, fonte ou capacidade indisponível existe.
- Use Latch/target-workspace para código privado, artefatos, sondagens ao vivo ou dados não públicos; se esse acesso estiver indisponível, pare no limite e relate o bloqueio em vez de substituir por uma suposição.
- Pause para aprovação explícita antes de ações externas consequentes; retorne evidências, riscos não resolvidos, premissas e qualquer ação que ainda esteja aguardando aprovação.
Pronto significa
Um fim que dá para checar.
Um mapa estático de evidências acompanha o diff indicado pelo código, dados, dependências, implantação, testes e usuários, com riscos classificados, verificações propostas, limites de cobertura e riscos não resolvidos, sem alterar o repositório ou o estado remoto.
Fontes
De onde veio este processo.
- github.com/Graphify-Labs/graphify/tree/4c735618f3d56fd622c2049771584621c31ba9ff/
- docs.github.com/en/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review
- c4model.com/
As fontes estabelecem o padrão do workflow. Posts de Reddit e da comunidade, quando aparecem, valem como anedota de quem pratica — não como fato universal.
