CLAUDE CODE MASTER CLASS

TL;DR — MCP (Model Context Protocol) es cómo Claude habla con el mundo más allá de tu filesystem. Un .mcp.json declara servidores; cada servidor expone herramientas con nombre mcp__<srv>__<tool>.

▸ Cinco servidores maduros que vale conocer

• playwright — automatización de browser. Click, type, screenshot, evaluate JS. Default para workflow autenticado.
• chrome-devtools — observabilidad de red, performance, runtime. Solo para debug.
• dbhub — SQL multi-DB (Postgres, MySQL, SQLite). Read-only por default.
• nextjs-devtools — build logs, routes, server actions, diagnostics de cache.
• github — issues / PRs / repos / workflows estructurados (más rico que el CLI gh).

▸ Agregando un servidor

// .mcp.json en la raíz del repo
{ "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-playwright"]
    }
} }

▸ Trust gate

Por default Claude pregunta antes de habilitar servidores MCP declarados en un proyecto. Pon enableAllProjectMcpServers: true en settings para saltar el prompt — solo en repos que confías.

▸ Modelo mental

TL;DR — una skill es una carpeta con un SKILL.md adentro. Su cuerpo ES el prompt. La invocas como /<nombre>. Dejas de pegar las mismas instrucciones cada sesión.

▸ Anatomía

▸ El frontmatter que importa

---
description: Pista de descubrimiento en una línea (Claude la lee para saber cuándo sugerirte)
argument-hint: <new <slug> | list>
allowed-tools: [Read, Grep, Bash]
paths: ["docs/specs/**"]   # path-scoped: solo cargable en dirs que matcheen
context: fork               # turn aislado (no contamina la conversación principal)
---
# /nombre — el cuerpo debajo de esta línea es el prompt

▸ Dos features que mueven la aguja

1. $ARGUMENTS — lo que el usuario tipeó después del slash command. Deja que una skill maneje varias formas de llamar.
2. !`shell-cmd` — corre al cargar la skill; stdout se inyecta como contexto. Ideal para estado vivo ("fecha de hoy", "branch actual", "lista de PRs abiertos").

▸ Skills bundled (ya en tu máquina)

/simplify · /batch · /debug · /loop · /claude-api — todas vienen con Claude Code. /help lista las que están en tu instalación.

TL;DR — un agent corre en un contexto aislado y devuelve un único mensaje. Delega cuando (a) el trabajo necesita muchas tool calls, (b) el resultado cabe en un resumen, o (c) quieres mantener ruido fuera de la conversación principal.

▸ Los cinco agents built-in

• general-purpose — research y ejecución multi-step. El default.
• Explore — búsqueda read-only rápida. "¿Dónde está X definido? ¿Qué archivos usan Y?"
• Plan — modo arquitecto. Produce un plan de implementación, no escribe código.
• claude-code-guide — Q&A sobre el propio Claude Code (esta Master Class es un ejemplo real).
• statusline-setup — configura tu status line. Nicho pero viene incluido.

▸ Una buena delegación tiene cinco partes

TASK:        una frase — qué hacer
CONTEXT:     archivos/paths que el agent debe leer primero
CONSTRAINTS: qué NO hacer · budgets · guardrails de estilo
DELIVERABLE: artefacto concreto (path de archivo, PR, forma del resumen)
DONE_WHEN:   condición verificable (tests pasan, archivo existe)

O DELIVERABLE o DONE_WHEN es requerido (o ambos). El agent no hereda contexto del padre — entrégale todo lo que necesita por adelantado.

▸ Dispatch desde un tool call

Agent({
  subagent_type: "Explore",
  prompt: "TASK: localizar todos los callers de getUser() en src/.\n..." ,
  model: "sonnet",          // opcional · sobrescribe el default
  isolation: "worktree",    // opcional · corre en worktree git temporal
})

▸ Model-fit cheatsheet

Implementación mecánica → sonnet. Lookup rápido de schema/protocolo → haiku. Revisión de arquitectura o debug exploratorio → opus. Research comparativa multi-fuente → opus si ≥2 señales, si no sonnet.

TL;DR — los hooks son shell scripts que corren en eventos de ciclo de vida. 29 eventos en total. Cada uno recibe JSON por stdin y decide vía exit code: 0 = permite, 2 en PreToolUse = BLOQUEA (stderr mostrado al agent), cualquier otro = solo log.

▸ Las siete familias de eventos

1. Session lifecycle — SessionStart · SessionEnd · Setup · Stop · StopFailure
2. Prompts & instructions — UserPromptSubmit · UserPromptExpansion · InstructionsLoaded
3. Tool gates — PreToolUse · PostToolUse · PostToolUseFailure · PostToolBatch
4. Permission — PermissionRequest · PermissionDenied
5. Sub-agents & tasks — SubagentStart · SubagentStop · TaskCreated · TaskCompleted
6. Compaction — PreCompact · PostCompact
7. System — Notification · TeammateIdle · ConfigChange · CwdChanged · FileChanged · WorktreeCreate · WorktreeRemove · Elicitation · ElicitationResult

▸ Hook mínimo viable

// .claude/settings.json
{ "hooks": {
    "PreToolUse": [{
      "matcher": "Bash",
      "hooks": [{
        "type": "command",
        "command": "bash .claude/hooks/check-bash.sh"
      }]
    }]
} }

#!/usr/bin/env bash
# .claude/hooks/check-bash.sh — lee JSON de stdin, decide por exit
input=$(cat)
cmd=$(echo "$input" | jq -r '.tool_input.command')
if [[ "$cmd" =~ rm\ -rf ]]; then
  echo "bloqueado: rm -rf está negado en este proyecto" >&2
  exit 2
fi
exit 0

▸ Una trampa que vale señalar

PostToolUse(Bash) dispara solo en éxito. Para capturar fallas, parea con PostToolUseFailure(Bash). El payload de falla usa .error y no tiene tool_response.

▸ Tres tipos de handler

• type: command — shell script. El default.
• type: prompt — single-turn Claude eval sobre $ARGUMENTS.
• type: agent — spawnea un sub-agent con herramientas para verificación profunda.