Nível 2 — Ferramenta de trabalho · Módulo 2.8 — Faixas por perfil (eletivas)

2.8.T1 · Lendo código legado que ninguém documentou

5 min de vídeo TEC

Objetivo: ao final, o consultor usa o Claude Code para mapear um programa Z de milhares de linhas sem documentação, produzindo um mapa de dependências e efeitos colaterais registrado no repositório.

O que você precisa levar desta aula

Peça um mapa estruturado (pontos de entrada, leitura/gravação, efeitos colaterais externos) — não um resumo solto do programa.
Peça a explicação duas vezes, para dois públicos: técnico (para quem vai mexer) e funcional (para quem confirma o comportamento de negócio).
Salve o mapa como documentação no repositório, ao lado do fonte — não deixe presa apenas na conversa.

Estratégia de leitura por camadas

Camada	O que pedir
1. Pontos de entrada	Onde o programa começa a executar (forms, exits, transação que dispara)
2. Dados	Quais tabelas são lidas e quais são gravadas
3. Efeitos colaterais	Chamadas a BAPI, RFC ou atualização de tabela fora do escopo aparente do programa — é aqui que mora o risco

Duas explicações, dois públicos

Público	O que importa
Desenvolvedor ABAP	Nomes de tabela, estrutura de dados, tratamento de exceção
Funcional	O efeito no processo de negócio, sem jargão técnico — serve para confirmar se o comportamento mapeado é o esperado pelo cliente

Por que registrar no repositório

Um mapa que fica só na conversa desaparece com a sessão. Salvo como arquivo Markdown junto ao fonte, ele vira parte do projeto — a próxima pessoa (ou você mesmo, seis meses depois) não recomeça do zero.

📖 Contexto é o recurso escasso — módulo 2.2

Quiz — 3 questões

1.Você aponta o Claude Code para um programa Z de 4.000 linhas sem documentação. Qual é o primeiro pedido mais eficaz?

a)"Explique este programa"
Gera um resumo solto, sem a estrutura que ajuda a navegar o código depois.
b)"Reescreva este programa de forma mais limpa"
Pular direto para reescrita sem entender o comportamento atual é o erro que a aula 2.8.T2 trata como risco.
c)Pedir um mapa estruturado: pontos de entrada, tabelas lidas/gravadas e efeitos colaterais externos
Correto.

Ver resposta e por quê

❌a) Gera um resumo solto, sem a estrutura que ajuda a navegar o código depois.

❌b) Pular direto para reescrita sem entender o comportamento atual é o erro que a aula 2.8.T2 trata como risco.

✅c) Correto.

2.Por que pedir a explicação do mapa duas vezes, para públicos diferentes?

a)Porque a versão técnica serve para quem vai mexer no código, e a versão de negócio serve para o funcional confirmar o comportamento esperado
Correto.
b)Porque o Claude erra a explicação técnica se não pedir a funcional primeiro
Não há essa dependência; as duas são pedidos independentes.
c)Porque é exigência de auditoria ter duas versões de qualquer documentação
Não é uma exigência formal; é uma prática que rende mais valor.

Ver resposta e por quê

✅a) Correto.

❌b) Não há essa dependência; as duas são pedidos independentes.

❌c) Não é uma exigência formal; é uma prática que rende mais valor.

3.Depois de gerado, o mapa de dependências deveria: ---

a)Ficar registrado só na conversa, para consulta rápida quando precisar
Desaparece com a sessão; não fica disponível para outra pessoa ou para você mais tarde.
b)Ser enviado por e-mail para o time, sem salvar no repositório
Não fica versionado nem ao lado do código que documenta.
c)Ser salvo como arquivo de documentação no repositório, ao lado do fonte
Correto.

Ver resposta e por quê

❌a) Desaparece com a sessão; não fica disponível para outra pessoa ou para você mais tarde.

❌b) Não fica versionado nem ao lado do código que documenta.

✅c) Correto.