Use o /dr:doc:code-summary quando quiser parar de reexplicar o projeto a cada conversa. Você roda o comando na raiz do repositório e recebe um resumo técnico de uma página: a stack, a estrutura, os pontos de entrada, as convenções e onde fica a documentação importante. Esse resumo passa a ser lido automaticamente no início de toda sessão nova do Claude Code no projeto.
Nada. Basta rodar o comando na raiz do projeto. Na primeira vez ele cria o resumo; nas seguintes, atualiza.
O comando lê o que o projeto diz de si mesmo e o que o código mostra. Começa pela documentação que já existe: README, instruções do projeto, manifestos de dependências e arquivos de configuração. Depois vai ao código: encontra os pontos de entrada, mapeia a estrutura de diretórios, identifica os módulos principais pelo que exportam e pelas rotas que definem, e lê uma amostra de arquivos representativos para captar as convenções em uso: estilo de import, nomenclatura, tratamento de erro, gerenciamento de estado, padrão de testes.
Por fim, localiza as documentações técnicas que um desenvolvedor novo precisaria encontrar: esquemas de banco, definições de API, decisões de arquitetura, documentos de deploy e tipos. Tudo é destilado com um critério só: o que alguém que chega hoje precisa saber de imediato, quais são as restrições críticas e onde está o detalhe.
Um documento enxuto, com no máximo 90 linhas e a data da última atualização no cabeçalho, dividido em stack, estrutura do projeto, pontos de entrada e módulos principais, convenções de código, referências de documentação e observações importantes. A partir dele, toda sessão nova já começa sabendo onde está.
Na prática, o “deixa eu te explicar como esse projeto funciona” vira um arquivo que o próprio Claude Code lê antes de você dizer a primeira palavra.
Como utilizar
Rode sem argumentos na raiz do projeto. O comando cria o arquivo na primeira execução e atualiza nas seguintes, preservando o limite de 90 linhas.
Exemplos
/dr:doc:code-summary
Na ambiguidade
Se a sua frase pode ser interpretada de mais de uma forma, o comando pergunta antes de escrever (via AskUserQuestion). Em operação de escrita, o comando nunca chuta — a ambiguidade sempre volta para você.
Notas
Para contexto estrutural mais profundo e fatiado por artefato, o par natural é /dr:codebase-map.
Para quem quer saber o que acontece nos bastidores:
- Saída:
.dr_ai/docs/CODE_SUMMARY.md. O diretório respeita directories.docs de .dr_ai/settings.json (padrão .dr_ai/docs).
- Injeção: o hook de início de sessão lê
.dr_ai/docs/CODE_SUMMARY.md (até 100 linhas) e o injeta como contexto de toda sessão nova. Com outro diretório de saída, o resumo não é injetado.
- Fontes da análise: manifestos (
package.json, pyproject.toml, Cargo.toml, go.mod), configs de build, pontos de entrada (src/index.*, main.*), padrões de export e de rota, e 3 a 5 arquivos de amostra para as convenções.
