🧹 El reinicio en 2 pasos

Al cerrar la conversación, Matt Pocock da un consejo que parece contraintuitivo para quienes están acostumbrados a acumular herramientas: "everyone bloats up their context window with too much stuff." Casi todo el mundo satura el context window con demasiadas cosas: decenas de skills, plugins, Servidores MCP y archivos de instrucciones que nunca abre. El resultado es context bloat: el agente se vuelve más lento, más caro y, paradójicamente, menos inteligente, porque parte de su atención se pierde administrando lo que apilaste.

La razón es directa: cada skill incluye una descripción que ocupa espacio en el contexto, incluso cuando no la usas en esa tarea (viste esto en el módulo 3.2, "Costo de contexto de la skill"). Si sumas decenas de ellas, la IA empieza cada conversación ya cargada de ruido. El reset de 2 pasos resuelve esto desde la raíz: en vez de intentar afinar un desorden que creció sin intención, vuelves a cero y reconstruyes con propósito. El error común aquí es creer que «más skills = mejor agente» — es al revés: una skill que no usas es un peso muerto que ocupa espacio en tu contexto cada vez.

El paso 1 es literal y radical. En palabras de Pocock: "delete everything — every skill, plugin, MCP server, your CLAUDE.md, agents.md — go back to absolute zero." Borra cada skill, todo plugin, todo Tu servidor MCP CLAUDE.md y su AGENTS.md. Vuelve al cero absoluto. No es «deshabilitar» ni «limpiar un poco»: es vaciar. La idea es poder ver después al agente sin ninguna de tus capas encima.

Antes de ejecutar, haz respaldo (el reset solo es reversible si guardaste los archivos). Por eso el copybox de abajo primero move todo a una carpeta de seguridad en vez de borrarlo definitivamente — así vuelves a cero sin perder nada. En Claude Code, las configuraciones viven en ~/.claude/ (skills, plugins, tu CLAUDE.md) y los servidores MCP quedan declarados en un archivo de configuración. Con solo mover esas carpetas, el agente queda en un estado inicial limpio.

# PASSO 1 — Deletar tudo e voltar ao ZERO absoluto.
# (move pra um backup datado em vez de apagar — reversível)
STAMP=$(date +%Y%m%d-%H%M%S)
BACKUP="$HOME/.claude-backup-$STAMP"
mkdir -p "$BACKUP"

# 1) skills, plugins e o seu CLAUDE.md global
mv ~/.claude/skills      "$BACKUP/skills"      2>/dev/null
mv ~/.claude/plugins     "$BACKUP/plugins"     2>/dev/null
mv ~/.claude/CLAUDE.md   "$BACKUP/CLAUDE.md"   2>/dev/null

# 2) CLAUDE.md / AGENTS.md do projeto atual
mv ./CLAUDE.md  "$BACKUP/project-CLAUDE.md"  2>/dev/null
mv ./AGENTS.md  "$BACKUP/project-AGENTS.md"  2>/dev/null

# 3) remover TODOS os MCP servers (lista e apaga um a um)
for s in $(claude mcp list 2>/dev/null | awk '{print $1}'); do
  claude mcp remove "$s" 2>/dev/null
done

echo "Blank slate pronto. Backup em: $BACKUP"
echo "Agora abra o agente e OBSERVE-o no modo puro."

Con el blank slate listo, llega la parte que casi todos se saltan: parar y observar. Pocock es explícito: después de borrar, "observa al agente": mira qué hace el agente en el modo básico. Dale tareas reales de tu día a día y mira cómo se las arregla sin ninguna de tus capas. El objetivo no es juzgar rápido; es descubrir, con honestidad, de qué es capaz por sí solo.

¿Por qué esto importa tanto? Porque los modelos de hoy son mucho más capaces que cuando instalaste la mitad de tus skills. Varias de ellas existen para «arreglar» comportamientos que el modelo actual ya resuelve por sí solo, así que solo están añadiendo ruido. Al observar al agente puro, generas una lista honesta de brechas: «aquí se trabó», «aquí inventó un patrón que no quiero», «aquí estuvo perfecto». Esta lista es lo que guiará el paso 2. El error común es hacer reset y, alarmado, volver a poner todo como estaba durante la primera media hora: nunca llegas a ver al agente por sí solo y pierdes todo el aprendizaje.

El paso 2 es reconstruir — pero con una regla. Pocock especifica: al recuperar cosas, prefiere procedimientos, no abilities. Recuerda la distinción (módulo 3.1): una procedure es algo que invocas a propósito (como un comando /grill-me); mientras que una ability es algo que el modelo decide invocar por su cuenta y, por eso, su descripción siempre carga en el contexto. Procedures son «a demanda»: pesan solo cuando las activas. Es exactamente lo opuesto a la sobrecarga que motivó el reinicio.

Pocock añade un detalle importante: instálalo de manera que puedas personalizar y experimentar. No es solo «reinstalar desde el mismo lugar»: es traer cada pieza sabiendo por qué existe y poder modificarla. El porqué: así mantienes el control del harness (el tema de todo el curso) en vez de depender de un paquete opaco. El error común aquí es, con prisa, instalar un plugin gigante que vuelca 30 abilities: acabas de recrear el bloat que habías eliminado. Capa por capa, procedure por procedure.

Esta es la regla de oro del paso 2: trae de vuelta solo lo que eches de menos. Pocock da un ejemplo concreto: podrías redescubrir que quieres la skill de brainstorming de superpowers, así que instala esta, y solo esa. Nada de «voy a volver a ponerlo todo porque algún día podría ser útil». Si surgió una carencia real mientras observabas al agente sin intervenir (tema 3), merece una pieza nueva; si no surgió, no la merece.

En la práctica, instalas cada skill que te haga falta con el comando del repositorio de skills (el de Matt, por ejemplo). El flujo completo de Pocock conecta con el resto de la Trilha: después de reconstruir un harness compacto, "encuentra problemas → encuentra soluciones → delega la implementación a un agente AFK" — y resume el AFK así: "AFK is just incredible — takes a bit of setup, but then it goes crazy." Es decir: el reset no es un fin en sí mismo; es lo que deja tu harness lo bastante limpio para que puedas operar a alto nivel. Copia el paso 2 de abajo:

# PASSO 2 — Recamadar: trazer de volta SÓ o que você sentiu falta.
# Regra: uma de cada vez, preferindo procedures, instaladas de
# um jeito que você possa CUSTOMIZAR/experimentar.

# Você observou o agente puro e sentiu falta de "brainstorming"?
# Então traga SÓ ela (não o pacote inteiro):
npx skills latest add brainstorming

# Sentiu falta de mais uma? Adicione conforme a lacuna aparecer:
npx skills latest add grill-me
# npx skills latest add <outra-skill-que-fez-falta>

# Confira o que está instalado agora (deve ser uma lista curta):
ls ~/.claude/skills

# DICA: prefira instalar como PROCEDURE (você invoca, ex.: /grill-me)
# em vez de ability (o modelo invoca sozinho e a descrição pesa sempre).
# E NÃO reinstale o backup inteiro — ele continua em ~/.claude-backup-*
# só como rede de segurança.

La última pieza del consejo es la que más gente olvida: instala las skills de una manera personalizable, para poder experimentar. Pocock lo recalca a propósito: una skill externa es una buena comienzo, no la palabra final. Cuando instalas mediante npx skills latest add, el archivo de la skill queda en tu máquina, en ~/.claude/skills/, y puedes abrir y editar: ajustar el tono, quitar lo que no sirve para tu proyecto, adaptarlo a tu flujo. Así el harness se convierte en tu en lugar de una copia genérica. Mantén el ciclo: ¿lo instalaste → lo usaste → no te sirvió? Elimínalo; ¿te sirvió, pero le faltó algo? Edítalo. El error común es tratar una skill instalada como intocable y volver a acumular: el reset solo funciona si sigues podando. Copia el checklist de abajo y pégalo al comienzo de tu próximo reset:

RESET DE 2 PASSOS — checklist (o conselho final do Pocock)

PASSO 1 — DELETAR TUDO (blank slate):
[ ] backup das skills, plugins, MCP, CLAUDE.md e AGENTS.md
[ ] volte ao ZERO absoluto (mova tudo pra fora)
[ ] abra o agente e OBSERVE-o no modo puro com tarefas reais
[ ] anote as LACUNAS de verdade (não as imaginárias)

PASSO 2 — RECAMADAR COM INTENÇÃO:
[ ] traga de volta SÓ o que sentiu falta
[ ] prefira PROCEDURES (você invoca) a abilities (o modelo invoca)
[ ] instale de jeito CUSTOMIZÁVEL: npx skills latest add <skill>
[ ] abra a skill e ADAPTE ao seu projeto/estilo
[ ] uma camada por vez — nunca um plugin gigante

DEPOIS: ache problema -> ache solução -> delegue a um agente AFK.