Use o /dr:talk:explain quando você precisa entender um pedaço do sistema antes de mexer nele, ou simplesmente quer aprender como ele funciona. Você aponta o alvo, e o comando devolve uma explicação pensada para ensinar, não só para descrever. Nada é modificado: é leitura e conversa.
O que você quer entender: o caminho de um arquivo, o nome de uma função, um algoritmo, um conceito ou uma pergunta direta sobre o comportamento do sistema, como “como funciona o fluxo de pagamento?”. Se quiser, indique o nível de profundidade: básico, intermediário ou avançado.
O comando analisa o alvo a fundo, identifica as peças envolvidas e como elas se relacionam, e monta a explicação sempre na mesma receita. Começa com uma analogia do cotidiano, para você ter uma imagem antes dos detalhes. Desenha um diagrama do fluxo ou da estrutura. Percorre o código passo a passo, contando o que acontece em cada etapa. E fecha destacando uma armadilha: o erro ou o mal-entendido mais comum naquele trecho.
O tom é de conversa. Para conceitos mais difíceis, ele usa mais de uma analogia, e o nível que você escolheu define o quanto de profundidade entra em cada passo.
Uma explicação que responde ao “como” e ao “por quê”, não só ao “o quê”, no nível que você pediu. Depois dela, você entra no código sabendo o que esperar e onde costuma dar errado.
Na prática, a meia hora de leitura às cegas antes de tocar num módulo desconhecido vira uma explicação guiada, com o ponto de atenção já marcado.
Exemplos
/dr:talk:explain src/auth/jwt.ts
/dr:talk:explain "como funciona o fluxo de pagamento?"
/dr:talk:explain src/hooks/useCart.ts --level advanced
Argumentos
| Argumento | Obrigatório? | Descrição |
|---|
target | Sim | Code file, function, concept, algorithm, or system to explain |
--level | Não | Explanation complexity (basic, intermediate, advanced) |
Notas
Comando somente leitura: analisa e explica, sem modificar nada. Para perguntas sobre estrutura e organização do projeto (sem análise profunda de código), o irmão /dr:talk:ask é mais direto.
Para quem quer saber o que acontece nos bastidores:
- Análise: leitura do código, busca de padrões e, quando faz sentido, execução para observar o comportamento em tempo real. As ferramentas são só de leitura e consulta.
- Diagrama: desenhado em ASCII, direto na resposta.
- Nível:
--level basic|intermediate|advanced ajusta a profundidade de cada etapa da receita.
