---
name: explicar-codigo
description: Use quando quiser entender um trecho, arquivo ou parte de um sistema — código herdado, lib nova ou lógica confusa.
---

# Explicar código

## Quando usar
- Entender código que você não escreveu (ou esqueceu) antes de mexer.

## Passos
1. Leia o trecho + o necessário ao redor para fazer sentido.
2. Explique curto e claro:
```
**O que faz:** uma frase.
**Como funciona:** passo a passo do fluxo principal.
**Pontos de atenção:** efeitos colaterais, dependências, pegadinhas.
```
3. Use analogia só se ajudar de verdade.

## Boas práticas
- Foque no que importa entender, não narre linha a linha.
- Se achar um bug ou risco enquanto explica, aponte.

## Relacionadas
`/debugar` · `/refatorar` · `/documentar`