anatomia-cc

Anatomía de Claude Code

El dolor

Abrís Claude Code y hay skills, subagentes, comandos, plugins, servidores MCP, hooks, canales, rutinas y artefactos. Nueve palabras, ninguna explicada, y una decisión que hay que tomar en el minuto uno.

Lo más común es armar un subagente para algo que era un archivo de texto, o un servidor MCP para algo que resolvía un script de veinte líneas.

El costo no se ve el primer día. Se ve al mes, cuando la sesión arranca pesada, el modelo elige mal seguido, y nadie se acuerda de por qué esa carpeta está ahí.

Este archivo no enseña a escribir cada pieza. Enseña a elegir cuál.

Cuándo usar esto

Al empezar cualquier proyecto, antes del primer archivo. Y cada vez que dudás entre dos formas para la misma idea.

También sirve para el caso que casi nadie contempla: que la respuesta correcta sea que no hay que construir nada.

Las tres preguntas que más rinden

Con estas tres alcanza para la mayoría de los casos, sin recorrer el árbol entero.

1. ¿Quién aprieta el botón?
   Vos, escribiendo /algo · el modelo, cuando aparece el tema · un evento de
   Claude Code · el reloj · un sistema de afuera · nadie, es una regla que
   Claude tiene que saber siempre.

2. ¿Toca algo de afuera que pida su propia credencial?
   Una base, una API, la cuenta de un servicio.

3. Cuando termina, ¿qué queda y quién lo mira?
   Texto en tu terminal · una pantalla que alguien abre en el navegador ·
   archivos cambiados en el repo · una respuesta que consume otro programa.

La tercera es la que más se olvida, y es la que decide si esto vive adentro de una sesión o no.

Paso 0 · ¿Hace falta construir algo?

Cuatro preguntas. La primera que da sí termina acá.

0.1 ¿Lo que falta es que Claude se acuerde de una regla tuya?
    «usá pnpm, no npm» · «corré los tests antes de commitear»
    SÍ → No construyas ninguna pieza: es una línea en CLAUDE.md.
         Si la regla aplica solo a ciertos archivos, va en .claude/rules/
         con `paths:`, y entra nada más cuando Claude toca esos archivos.

0.2 ¿Ya lo hizo otro?
    GitHub, Slack, Postgres, Notion y Sentry ya tienen servidor MCP. Y hay
    plugins publicados para buena parte del resto.
    SÍ → No construyas nada. Instalalo.

0.3 ¿Lo que te molesta es CÓMO te contesta, no lo que sabe?
    Querés otro tono, más explicación, que siempre arranque con un diagrama.
    SÍ → No es una skill: es un estilo de salida, en .claude/output-styles/.
         Ojo, se lee una vez al arrancar: aplica después de /clear.

0.4 ¿Lo resuelve un script, sin modelo adentro?
    Si siempre se hace igual y no hay nada que decidir, es un script.
    SÍ → Escribilo. Claude lo corre con Bash cuando haga falta.
    NO → seguí al Paso 1.