El playbook de Claude Code ahora es una wiki comunitaria: 83 consejos y sumando

Si has usado Claude Code durante más de unas pocas horas, probablemente te has topado con el muro: la degradación del contexto aparece alrededor de los 300.000 tokens, el modelo comienza a responder sus propias preguntas y tu sesión se convierte en una espiral lenta de correcciones cada vez más costosas. Hasta ahora, las soluciones vivían en tuits dispersos y comentarios de YouTube. Un solo repositorio de GitHub está intentando cambiar eso.

El desarrollador Shan Raisshan ha reunido lo que es efectivamente el primer manual de campo comunitario para Claude Code. El repositorio, que cuenta con más de 200 estrellas en GitHub a partir de abril de 2026, documenta 83 consejos en catorce categorías, además de colecciones de agentes y habilidades del ecosistema más amplio. Se basa en ingenieros de Anthropic, el creador de Claude Code Boris Cherny y usuarios avanzados de la comunidad, incluyendo a Matt Pocock y Andrej Karpathy.

Lo que hace notable al recurso no es la cantidad de consejos, sino la forma en que se consolidan en algo parecido a una disciplina profesional. El repositorio enmarca explícitamente su material como un movimiento desde la codificación por vibra, el término de Andrej Karpathy de 2025 para dejar que el modelo conduzca sin mucho entendimiento, hacia la ingeniería de agentes, donde los desarrolladores orquestan subagentes, gestionan presupuestos de contexto y construyen primitivas de flujo de trabajo reutilizables.

La gestión del presupuesto de contexto se convierte en la habilidad central

Lo primero que nota cualquier usuario intensivo de Claude Code es que el modelo se degrada a medida que se llena la ventana de conversación. El repositorio documenta los umbrales con una precisión inusual: la degradación del contexto se vuelve notable alrededor de los 300.000 a 400.000 tokens en el modelo de 1 millón de tokens. Un comentario, atribuido a un ingeniero anónimo de Anthropic que usa el alias Thariq, define una "zona tonta" aproximadamente al 40 por ciento del uso del contexto. Se dice a los recién llegados que se mantengan por debajo del 40 por ciento. Se dice a los usuarios avanzados que no avancen más allá del 30 por ciento, y solo para tareas simples.

La respuesta recomendada es un sistema escalonado de gestión de sesiones. El comando /compact con una pista, /compact focus on the auth refactor, drop the test debugging, supera a dejar que el autocompactado se active, porque el disparador automático del modelo se activa cuando el contexto ya perjudica el rendimiento. El comando /clear más un breve re-prompt le da al desarrollador el control total sobre lo que se transfiere, a costa de escribir un breve resumen. El repositorio marca ambos como esenciales, no opcionales.

Retroceder a un punto de control anterior antes de un intento fallido se considera mejor que intentar corregir al modelo en el lugar. Presionar dos veces Esc o /rewind restablece la conversación a un punto anterior al error, y el desarrollador vuelve a dar el prompt con lo que aprendió. Dejar los intentos fallidos en la conversación desperdicia tokens que el modelo luego tiene que sortear.

Primitivas sobre prompts

La tesis organizadora del repositorio es que los usuarios avanzados de Claude Code no escriben mejores prompts. Construyen mejores abstracciones. Las tres primitivas principales son agentes, comandos y habilidades.

Los agentes son definiciones de subagentes que residen en .claude/agents/ como archivos markdown. Están diseñados para manejar roles específicos: un agente de QA, un especialista en backend, un revisor de PR, y se ejecutan en ventanas de contexto separadas. La sesión principal solo ve la conclusión del subagente, no sus llamadas a herramientas intermedias. Ese aislamiento es el punto central: 20 lecturas de archivos, 12 búsquedas con grep y 3 callejones sin salida permanecen dentro del contexto hijo, y solo el informe final regresa.

Los comandos son flujos de trabajo activados con barra diagonal almacenados en .claude/commands/. El repositorio recomienda construir uno para cada tarea del bucle interno que realices varias veces al día. Un comando /techdebt o /context-dump reemplaza una cadena repetitiva de prompts con una sola pulsación de tecla.

Las habilidades son carpetas con un punto de entrada SKILL.md, más subdirectorios opcionales para scripts y ejemplos. El campo de descripción de la habilidad se trata como un disparador, no como un resumen; el modelo lo usa para decidir cuándo activarse. El repositorio desaconseja instrucciones paso a paso prescriptivas: da objetivos y restricciones, no una receta. Una sección de Gotchas en cada habilidad se destaca como el contenido de mayor señal, recopilando los modos de fallo de Claude a lo largo del tiempo.

Un detalle que destaca: las habilidades pueden incrustar comandos de shell mediante !comando en el SKILL.md. Claude ejecuta el comando al invocarse, y el modelo solo ve el resultado. Eso permite que una habilidad inyecte contexto dinámico (rama actual, lista de archivos modificados, estado de la última ejecución de CI) sin que el desarrollador tenga que redirigir la salida a la conversación.

El patrón de flujo de trabajo que sigue apareciendo

En los diez repositorios de flujos de trabajo destacados en la colección comunitaria, un patrón estructural se repite: Investigar, Planificar, Ejecutar, Revisar, Publicar. El repositorio lo documenta como un bucle con sub-bucles. Las etiquetas amarillas en la tabla de flujos de trabajo, los sub-bucles, son lo que hacen que el patrón funcione para cada caso de uso. Un bucle por tarea dentro de Ejecutar. Un bucle por historia dentro de Planificar. Un bucle de verificación en Revisar que se repite hasta que se cumple la condición.

Los flujos de trabajo entre modelos son una adición más reciente. Existen tres mecanismos distintos: plugins, donde la CLI de otro modelo se ejecuta dentro de Claude Code como un comando de barra diagonal; servidores MCP, donde Claude Code llama a otro modelo como una herramienta; y enrutadores, donde el punto final de la API de Claude Code se cambia a un proveedor diferente. El plugin de OpenAI Codex es el más notable: proporciona comandos /codex:review, /codex:adversarial-review y /codex:rescue dentro de Claude Code, permitiendo efectivamente que un modelo haga QA de la salida del otro.

83 consejos, una señal: la disciplina está madurando

El volumen de consejos es secundario a lo que representan. Hace un año, los consejos para usar asistentes de codificación con IA se limitaban a "sé específico en tus prompts" y "divide tu trabajo en partes pequeñas". El repositorio de Raisshan muestra una comunidad que ha ido mucho más allá. Hay consejos para usar git worktrees para desarrollo paralelo con equipos de agentes. Consejos para usar diagramas ASCII para comunicar la arquitectura al modelo. Consejos para construir habilidades de verificación de productos que cuestan una semana perfeccionar, pero que se amortizan en cada sprint posterior.

El propio repositorio reconoce que las notas son un objetivo en movimiento. La tabla de consejos enumera 83 elementos a partir de abril de 2026, y las instrucciones del repositorio invitan a contribuciones. Una sección titulada "Preguntas sin respuesta" enumera catorce problemas abiertos, incluido el equilibrio entre comandos, agentes y habilidades, y si las especificaciones como archivos markdown sobreviven a la tasa de generación de código. Las preguntas sin respuesta pueden ser la parte más honesta del documento.

El repositorio completo está disponible en GitHub. La sección de consejos de la comunidad vale la visita, especialmente para equipos que todavía tratan a Claude Code como una herramienta de autocompletado en lugar de un recurso de ingeniería gestionado.