Claude Code Best Practices · 83 tips de Boris Cherny y Thariq para usar Claude Code a su máximo potencial

Salió hace pocos días y se fue directo al número uno de GitHub Trending. 50,749 estrellas, 5,045 forks, licencia MIT. La descripción del repo lo dice mejor que cualquiera: from vibe coding to agentic engineering — practice makes claude perfect. Es el archivo curado de lo que ya saben los que llevan meses (o años) construyendo con Claude Code, traducido en 83 tips accionables.

Lo importante no es la cantidad. Lo importante es quién los firma. Boris Cherny diseñó Claude Code dentro de Anthropic. Thariq trabaja en el mismo equipo. Cuando la gente que construyó la herramienta se sienta a documentar las trampas, los atajos y los errores típicos que ven todo el día, eso no es un blog post — es una hoja de ruta.

Esta es la versión escaneable. Cada tarjeta es una categoría — número, nombre, conteo de tips cuando el README lo especifica, y una línea que te dice qué cubre. Si tenés 30 segundos, leé las 14 tarjetas. Si tenés 30 minutos, bajá a la sección que te llame y después clonás el repo para leer los tips completos.

1. 01Prompting

   3 tips

   Cómo hablarle a Claude para que haga lo que querés sin tener que repetirle.

2. 02Planning / Specs

   7 tips

   Armar el plan antes que el código — la diferencia entre vibe coding y agentic engineering.

3. 03Context

   5 tips

   Qué meter, qué sacar y cuándo limpiar para que Claude no se atore a la mitad.

4. 04Session

   6 tips

   Cómo manejar sesiones largas sin perder estado ni quemar la cuenta.

5. 05CLAUDE.md + .claude/rules

   8 tips

   El alma de Claude — el archivo que le da memoria persistente al agente.

6. 06Agents

   Agentes para tareas paralelas y para proteger tu ventana de contexto.

7. 07Commands

   Slash commands para automatizar lo que repetís 10 veces al día.

8. 08Skills

   Skills modulares — la pieza que volvió a Claude Code una plataforma.

9. 09Hooks

   Eventos que se disparan antes y después de cada tool — la base de la automatización.

10. 10Workflows + Advanced

    Cómo encadenar todo lo de arriba en un workflow de equipo (o de uno solo).

11. 11Git / PR

    Commits, branches, PRs y reviews con Claude — sin romper la historia del repo.

12. 12Debugging

    Reproducir, aislar, hipotetizar y dejar test de regresión cuando algo se rompe.

13. 13Utilities

    Herramientas, atajos y configuraciones que vale la pena tener instaladas.

14. 14Daily

    Trucos para el uso de todos los días — los que dejan de pensar después de la semana 2.

Las primeras 4 categorías cubren la conversación con la herramienta. Son las que más mueven la aguja en el día 1 — y las que la mayoría se salta porque parecen obvias. Spoiler: no lo son. Cómo redactás el prompt define el output. Cómo armás el plan define si Claude hace lo que querés o lo que entendió. Cómo manejás contexto y sesiones define si tu cuenta dura una semana o un día.

1. 01Prompting

   3 tips

   Cómo hablarle a Claude para que haga lo que querés sin tener que repetirle.

2. 02Planning / Specs

   7 tips

   Armar el plan antes que el código — la diferencia entre vibe coding y agentic engineering.

3. 03Context

   5 tips

   Qué meter, qué sacar y cuándo limpiar para que Claude no se atore a la mitad.

4. 04Session

   6 tips

   Cómo manejar sesiones largas sin perder estado ni quemar la cuenta.

Si solo te llevás una cosa del repo, que sea esta. Es la quinta categoría — 8 tips completos dedicados al archivo que le da memoria persistente a Claude. Sin un buen CLAUDE.md, todas las semanas le explicás lo mismo: cómo se llaman tus componentes, qué comandos corre tu equipo, qué patrones usás, qué evitar. Con uno bien armado, Claude se mueve solo y no necesitás repetir nada.

Acá es donde Claude Code deja de ser un asistente y se convierte en una plataforma. Las 5 categorías de este bloque te dan las piezas para armar un sistema completo: agentes para tareas paralelas que protegen tu contexto principal, comandos slash para automatizar lo que repetís todos los días, skills modulares que activan capacidades on-demand, hooks que se disparan antes y después de cada acción para imponer reglas de tu equipo, y workflows avanzados que orquestan todo lo anterior.

1. 06Agents

   Agentes para tareas paralelas y para proteger tu ventana de contexto.

2. 07Commands

   Slash commands para automatizar lo que repetís 10 veces al día.

3. 08Skills

   Skills modulares — la pieza que volvió a Claude Code una plataforma.

4. 09Hooks

   Eventos que se disparan antes y después de cada tool — la base de la automatización.

5. 10Workflows + Advanced

   Cómo encadenar todo lo de arriba en un workflow de equipo (o de uno solo).

Las últimas 4 categorías cubren todo lo que necesitás para que Claude se mueva contigo en el día a día — no solo en la primera sesión. Cómo hacer commits y PRs sin romper la historia del repo, cómo debuggear bugs reales paso a paso (no “intenta esto a ver si funciona”), qué utilities vale la pena tener instaladas y los trucos de uso diario que dejás de pensar después de la semana 2.

1. 11Git / PR

   Commits, branches, PRs y reviews con Claude — sin romper la historia del repo.

2. 12Debugging

   Reproducir, aislar, hipotetizar y dejar test de regresión cuando algo se rompe.

3. 13Utilities

   Herramientas, atajos y configuraciones que vale la pena tener instaladas.

4. 14Daily

   Trucos para el uso de todos los días — los que dejan de pensar después de la semana 2.

El error más común con un repo de tips es leerlos en orden y olvidarlos. Lo que funciona es clonarlo, pegarle el README a Claude Code y dejar que sea Claude el que cruce los tips contra tu contexto. Tres pasos, cinco minutos, y salís con los 5 tips de mayor ROI para tu semana.

Acabo de clonar este repo: https://github.com/shanraisshan/claude-code-best-practice

Tiene 83 tips de Boris Cherny (creador de Claude Code) y Thariq (Anthropic), repartidos en 14 categorías (Prompting, Planning, Context, Session, CLAUDE.md, Agents, Commands, Skills, Hooks, Workflows + Advanced, Git/PR, Debugging, Utilities, Daily).

Tu trabajo:

1. Leé el README completo del repo (README.md en el root).
2. Antes de devolverme nada, hacéme estas preguntas en una sola respuesta:
   - ¿Qué stack uso? (lenguaje, framework principal)
   - ¿Cuánto tiempo llevo con Claude Code? (días / semanas / meses)
   - ¿Qué es lo que más me traba hoy? (contexto que se llena, sesiones largas, planning, agentes, etc.)
3. Cuando te conteste, devolveme:
   - Los 5 tips MÁS relevantes para mi nivel y mi stack — uno por línea, con el número del tip y el link a la sección del repo.
   - Por qué cada uno aplica a mi caso específico (una frase).
   - Qué tip leer primero (el de mayor ROI para esta semana).
   - Qué categorías puedo saltarme por ahora (si aplica).

No me devuelvas los 83 tips. No me devuelvas un resumen genérico. Quiero los 5 que mueven la aguja para mí esta semana.

ultrathink — quiero que cruces mi contexto contra los tips antes de elegir, no que me des los más populares.

Quiero generar el CLAUDE.md de mi proyecto usando los 8 tips de la sección "CLAUDE.md + .claude/rules" del repo https://github.com/shanraisshan/claude-code-best-practice.

Pasos:

1. Leé los 8 tips de la sección CLAUDE.md del README. No los resumas: extrae las reglas accionables.
2. Escaneá mi proyecto actual (package.json, tsconfig, estructura de folders, README si tengo, scripts en package.json).
3. Identificá:
   - Qué stack y convenciones uso.
   - Qué comandos corre el equipo (test, lint, build, dev).
   - Qué patrones de código repito.
   - Qué errores típicos quiero que Claude evite.
4. Generá un CLAUDE.md que aplique los 8 tips a MI proyecto — no un template genérico:
   - Comandos del proyecto (con explicación de cuándo usar cada uno).
   - Convenciones del codebase (path aliases, naming, dónde van los componentes).
   - Reglas de qué editar vs crear.
   - Reglas de testing (qué probar antes de marcar algo como hecho).
   - Información que debe estar siempre presente vs lo que va en archivos específicos.
   - Lo que NO debe hacer (anti-patterns que ya viste en mi código o que el repo recomienda evitar).
5. Antes de escribir el archivo, mostrame el outline en chat y pedíme confirmación.

ultrathink — el CLAUDE.md tiene que ser corto, accionable y específico a mi proyecto. Si meto cosas obvias o genéricas, lo voy a borrar y perdimos el ejercicio.

Quiero auditar mi workflow actual con Claude Code contra los 83 tips del repo https://github.com/shanraisshan/claude-code-best-practice.

Mi workflow actual (lo que hago hoy, sin maquillar):
- Cómo arranco una sesión: [DESCRIBÍ]
- Qué meto en CLAUDE.md (si tengo): [PEGÁ O DESCRIBÍ]
- Cómo manejo el contexto cuando se llena: [DESCRIBÍ]
- Qué agentes / skills / hooks tengo configurados: [LISTÁ]
- Qué comandos slash uso seguido: [LISTÁ]
- Cuántos tokens gasto al día (aproximado): [PEGÁ]
- Lo que más me frustra hoy: [DESCRIBÍ]

Tu trabajo:

1. Leé las 14 categorías del README (no necesitás los 83 tips completos, los headers alcanzan).
2. Devolveme una auditoría con esta estructura:
   - ✅ Qué ya estoy haciendo bien (mapealo a tips específicos).
   - ⚠️ Dónde pierdo dinero o tiempo (con el tip del repo que lo arregla).
   - 🚀 Top 3 cambios para esta semana, en orden de prioridad. Para cada uno: qué cambiar, qué tip del repo lo respalda, y cómo medir si funcionó.
   - 🛑 Anti-patterns que estoy haciendo (con el tip del repo que dice por qué evitarlos).
3. Sé brutalmente honesto. No me digas que mi workflow está bien si no lo está.

ultrathink — quiero el diff entre mi workflow y el del repo, no un resumen del repo.