Mapa de código existente con Claude Code: leer, cambiar y verificar en 45 minutos

Por qué importa este flujo

Claude Code suele dar más valor en una base de código existente que en un proyecto vacío, pero la primera sesión también es más riesgosa. Si pides una reescritura amplia, obtendrás un diff difícil de revisar. El primer paso debe ser un mapa: entradas principales, zonas seguras, zonas peligrosas y el cambio pequeño que se puede verificar hoy.

Para más contexto, combínalo con la guía inicial de Claude Code, harness engineering, la guía de permisos.

El flujo práctico

Usa un ciclo de 45 minutos: estado, mapa de archivos, un cambio acotado, un comando de prueba y una nota de handoff. En un sitio de contenido, el mapa también debe incluir PDF gratis, producto Gumroad y CTA de consultoría.

Kit mínimo para copiar y pegar

git status --short
rg --files | Select-Object -First 80
rg "TODO|FIXME|console\.log|throw new Error" -n site src scripts
cd site
npm.cmd run build

# CLAUDE.md

## Existing-codebase map
- entry points: site/src/pages, site/src/layouts, site/src/lib
- safe first task: update one CTA or one article
- risky areas: auth, billing, deploy scripts, secrets

## Definition of done
- small diff
- one proof command
- public URL or local preview checked
- next step written down

Read this repository as an existing codebase.
Return:
1. the three most important entry points
2. the safest first patch under 45 minutes
3. files that should not be touched today
4. the proof command
5. the handoff note format

Tres casos reales de uso

• Mejorar solo el CTA final de un artículo y confirmar que el PDF gratis sigue funcionando.
• Añadir comandos seguros, zonas prohibidas y definición de terminado en CLAUDE.md.
• Agregar un enlace interno desde un artículo popular hacia productos y verificar h1 más CTA en la URL pública.

Fallos comunes y cómo evitarlos

El fallo común es empezar con ‘refactoriza todo el proyecto’. Claude Code puede generar cambios plausibles, pero el parche se vuelve demasiado grande para confiar. Empieza con un archivo, una ruta y un comando de prueba.

Ruta hacia PDF gratis, Gumroad y consultoría

Usa el cheatsheet gratuito mientras el flujo sea nuevo. Pasa a la Setup Guide cuando necesites CLAUDE.md, hooks, permisos y reglas repetibles. Reserva consultoría cuando la adopción o la ruta de ingresos requiera decisión humana.

• Cheatsheet gratuito de Claude Code
• Plantillas de prompts para Claude Code
• Guía de configuración de Claude Code
• Productos
• Consultoría

Empieza con el cheatsheet gratuito, compra la guía de Gumroad cuando el flujo se repita y reserva consultoría cuando el despliegue o la ruta de ingresos sea costosa de improvisar.

Qué verifiqué para este artículo

Separé comandos PowerShell, un fragmento reusable de CLAUDE.md y una checklist de CTA para que el flujo pueda copiarse en un repositorio real.