TL;DR Cuando un cambio es demasiado grande, nuevo o ajeno para entenderlo de un vistazo, no lo leo en silencio. Arranco el dictado y se lo leo en voz alta a Claude, archivo por archivo, marcando lo que no entiendo. Luego itero en círculos concéntricos: cada pasada reduce el área a la mitad, hasta que el modelo y yo entendemos lo mismo.
Con los modelos frontera tocando un montón de archivos a la vez, el cuello de botella se ha movido. Ya no es escribir el código, es entender el que ya está escrito. Y leer en silencio no funciona: ojeas, saltas, pierdes el hilo. Leer en voz alta te obliga a mirar de verdad. Y si dictas esa lectura dentro de Claude Code, el modelo aprende exactamente dónde te has perdido.
No es una feature. Es un método. La herramienta es el dictado: yo uso VoiceInk, pero Claude Code trae uno nativo (/voice, mantén Space) si no quieres nada externo.
Resultado (las pasadas de una revisión real):
Pasada 1 · todo el cambio (12 archivos)
> [voz] "auth.ts, veo el guard... Claude, ¿por qué validas el
token en el middleware y otra vez en el handler?"
Pasada 2 · solo lo que no cerró (5 archivos)
> [voz] "el refresh flow. Esto no lo pillo, ¿de dónde sale el TTL?"
Pasada 3 · el núcleo (1 archivo)
> entendimiento ✓ → siguiente acción
El método
1. Capa exterior: narra la lectura
Arranca el dictado y ve archivo por archivo diciendo lo que ves. No lo resumas en tu cabeza: dilo en alto. La mayoría, o los más importantes, o la parte esencial. El acto de verbalizar ya te hace mirar donde antes ojeabas.
2. Marca lo que no entiendes e interpela al modelo
Señala en voz alta cada duda: "Claude, esta parte no la entiendo", o "ok, entiendo por qué has hecho esto, pero esto, ¿por qué?". Al terminar la pasada, el modelo ya sabe tus puntos ciegos y lo que crees que hay que ajustar o refactorizar.
3. Cierra el círculo: reduce y repite
De todo lo anterior pasas a un subcontexto menor. El área de exploración baja alrededor de un 50%. Vuelves a leer, vuelves a pedir, el modelo valida. Otra capa. Y otra. Aquí ayuda dejar los puntos ciegos en una lista de tareas para no perder ninguno entre pasadas.
4. El centro
Sigues hasta el núcleo: el entendimiento compartido entre humano y modelo, o la siguiente acción clara. Empiezas por fuera, hay capas que atravesar y validar; el objetivo es el centro.
Referencia
| Capa | Qué haces | Qué obtienes |
|---|---|---|
| Exterior | Narras todos (o los esenciales) los archivos en voz alta | El modelo conoce tus dudas y tus sospechas |
| Intermedia | Reduces el área ~50% y relees solo lo que no cerró | Se descartan las partes ya entendidas |
| Centro | Iteras hasta el entendimiento o la siguiente acción | Humano y modelo alineados sobre el mismo código |
El humano, ¿en el loop o por encima?
Aunque intento cambios lo más atómicos posibles, con los frontera como Fable es inevitable acabar con un montón de archivos que validar. Combina esto con plan mode para que el cambio nazca ya troceado. Y queda una pregunta que dejo para otro tip: ¿debe el humano estar en este punto del loop, revisando archivo a archivo, o un nivel por encima? Por ahora, cuando no entiendo algo, bajo al loop. Y bajo hablando.
Documentación oficial: Voice dictation