Voltar ao índice
Ferramentas e automação Fonte oficial

Mapa de contexto do código antes da implementação

Mapeie arquivos, dependências, testes, padrões semelhantes e riscos relevantes antes de alterar o código de uma tarefa.

Ver código no GitHub Instala diretamente do repositório-fonte.

O que esta skill faz

Esta skill cria uma visão estruturada do impacto provável de uma mudança antes da implementação. O mapa separa arquivos a modificar, dependências, testes relacionados, referências internas e riscos que precisam ser avaliados.

Quando usar

  • Delimitar o alcance de uma correção
  • Localizar dependências diretas de um módulo
  • Encontrar testes afetados por uma alteração
  • Identificar padrões semelhantes já usados no projeto
  • Antecipar mudanças de API, banco ou configuração

Como usar

  1. Descreva claramente a tarefa que será analisada
  2. Revise o repositório e pesquise arquivos relacionados
  3. Rastreie imports, exports, testes e implementações semelhantes
  4. Registre arquivos, relações e riscos no mapa de contexto
  5. Submeta o mapa à revisão antes de implementar

O que revisar antes de instalar

  • A skill não deve avançar para a implementação antes da revisão do mapa
  • Dependências dinâmicas podem não aparecer em buscas estáticas
  • O mapa representa o conhecimento encontrado no repositório, não uma garantia de impacto completo

SKILL.md

---
name: context-map
description: 'Generate a map of all files relevant to a task before making changes'
---

# Context Map

Before implementing any changes, analyze the codebase and create a context map.

## Task

{{task_description}}

## Instructions

1. Search the codebase for files related to this task
2. Identify direct dependencies (imports/exports)
3. Find related tests
4. Look for similar patterns in existing code

## Output Format

```markdown
## Context Map

### Files to Modify
| File | Purpose | Changes Needed |
|------|---------|----------------|
| path/to/file | description | what changes |

### Dependencies (may need updates)
| File | Relationship |
|------|--------------|
| path/to/dep | imports X from modified file |

### Test Files
| Test | Coverage |
|------|----------|
| path/to/test | tests affected functionality |

### Reference Patterns
| File | Pattern |
|------|---------|
| path/to/similar | example to follow |

### Risk Assessment
- [ ] Breaking changes to public API
- [ ] Database migrations needed
- [ ] Configuration changes required
```

Do not proceed with implementation until this map is reviewed.