Katas Builtin Tool Selection

Qué es

Claude Code expone un conjunto de built-in tools, cada una con un uso primario y un failure mode. El núcleo de manipulación de código:

• Grep: busca contenido por regex sobre el cuerpo de los archivos.
• Glob: busca paths por patrón de nombre (no mira contenido).
• Read: carga un archivo concreto en contexto (también imágenes, PDFs y notebooks).
• Edit: modificación dirigida sobre un anchor de texto único; con replace_all: true sustituye todas las ocurrencias.
• Write: sobrescribe un archivo completo.
• Bash: ejecuta comandos de shell.

La superficie built-in es más amplia que ese núcleo — el inventario vigente incluye además Agent (subagentes), Skill (invocar skills), TodoWrite/TaskCreate (tracking), WebFetch y WebSearch (red), NotebookEdit (celdas de notebook), SlashCommand, y BashOutput/KillShell (procesos en background). Elegir dentro del núcleo no exime de conocer el resto: delegar una búsqueda amplia a Agent o invocar una Skill existente suele ganar a orquestarlo a mano [coverage_gap: el set exacto varía por versión — verificar contra la sesión instalada].

La estrategia incremental canónica es Grep → Read → Edit: buscar primero los entry points por contenido, leer selectivamente siguiendo imports, y aplicar una modificación puntual.

Por qué importa (falla que evita)

Hacer Read sobre todo el repositorio carga miles de tokens innecesarios y quema el presupuesto de contexto. Un Edit con un anchor que no es único (matchea varias líneas) o que no existe simplemente falla. Saber qué tool aplica en cada momento es mecánica básica del examen y separa a los agentes eficientes de los que desperdician contexto en cada turno.

Modelo mental

• Grep = buscar contenido. Glob = buscar paths. Read = cargar archivo. Edit = mod puntual. Write = reescribir. Bash = shell.
• Estrategia: Grep primero (encontrar entry points) → Read selectivo (seguir imports) → Edit/Write puntual.
• Failure mode de Edit: anchor no único o inexistente → falla. Remedio documentado para el anchor repetido: replace_all: true (si TODAS las ocurrencias deben cambiar) o ampliar el anchor con más contexto para hacerlo único. Fallback de último recurso: Read entero + Write completo.
• Nunca "leer todo el repo upfront": eso es el anti-patrón que destruye el presupuesto de tokens.

Patrón correcto

matches = grep(pattern="processRefund\\(", glob="**/*.py")
content = read(matches[0].path)
edit(
    path=matches[0].path,
    old_text="if amount > 1000:",
    new_text="if amount > MAX_REFUND:",
)

Anti-patrón

all_files = glob("**/*")
for f in all_files:
    read(f)  # 200k tokens cargados sin necesidad

edit(old_text="if amount", ...)  # múltiples líneas matchean → falla

Argumento de certificación

• Escoger el tool correcto en una decisión rápida según uso primario.
• Describir el failure mode de Edit (anchor no único/inexistente) y sus remedios en orden: replace_all, anchor ampliado, y solo al final Read + Write.
• Defender la estrategia Grep → Read → Edit.
• Rechazar el Read masivo upfront sobre el repositorio.

Cuándo activar

• Cuando el agente debe explorar o modificar un codebase y necesita elegir entre Grep, Glob, Read, Edit, Write o Bash.
• Cuando un Edit falla por un anchor ambiguo y hay que decidir el fallback.
• Cuando un plan de exploración propone cargar el repositorio entero y hay que corregirlo.

Skills relacionadas

• katas-plan-mode-exploration
• katas-custom-commands-skills
• katas-hierarchical-claude-memory

Packet

Capas del packet, cargables bajo demanda (disciplina ICM: una capa por vez, nunca todas juntas): knowledge/ cuerpo de conocimiento · prompts/ prompts listos · examples/ salida de ejemplo · agents/ subagentes del packet · templates/ plantilla de output.