wandres.dev
SENSEI · El Dojo: práctica y maestría

El kata: un recorrido de entrenamiento

Una rutina completa para practicar TODO Neovim sobre un repositorio real, sin escribir software. Un circuito que repites como un kata hasta que fluye solo.

⏱ 18 min

Esto no es un proyecto de programación: es un kata, una rutina de entrenamiento. Coges un repositorio cualquiera y ejecutas una secuencia de ejercicios que tocan todo lo aprendido. El objetivo no es cambiar el código, sino entrenar la herramienta. Repítelo hasta que fluya.

🎯 Al terminar esta lección sabrás
  • Encadenar en una sola sesión todas tus habilidades de Neovim.
  • Practicar navegación, edición, refactor, macros, git y deshacer.
  • Convertir la técnica aislada en un flujo continuo.
ℹ️
Cómo hacer este kata

Clona cualquier repositorio que te interese leer (uno de tus proyectos, o uno famoso de GitHub). No vas a construir nada: vas a practicar Neovim sobre código que ya existe. Al final, deshaces todos los cambios y lo dejas como estaba. Cronométrate. Repítelo otro día e intenta ir más fluido.

El circuito

1
Entra sin tocar el ratón

Desde el terminal: z proyecto (zoxide) para saltar a la carpeta, nvim para arrancar. Todo desde el teclado.

2
Orientarte por búsqueda, no por árbol

Abre 3 archivos con <leader>ff. Busca una función que recuerdes a medias con <leader>fg. Salta a una definición con gd y vuelve con Ctrl-o. Nada de explorar clicando.

3
Leer con folds

En un archivo grande, zM para ver solo el esqueleto (firmas de funciones y clases). Navega con zj/zk, abre lo que te interese con za. Vuelve a expandir con zR.

4
Editar con la gramática

Elige una función y practica objetos de texto: cif para reescribir su cuerpo, daf para borrarla (y u para recuperarla), ci( en sus argumentos, gsaiw" para rodear una palabra. Siente cómo verbo + objeto resuelve cada edición.

5
Refactor con cgn

Elige un identificador y renómbralo con el flujo *cgn → escribe → Esc. en las siguientes. Revisa cada aparición decidiendo con una tecla.

6
Automatiza con una macro

Busca una tarea repetitiva (formatear una lista, añadir un prefijo a varias líneas). Grábala con qa … q y aplícala con 10@a. Si aplica a un patrón, combínala: :g/patrón/normal @a.

7
Edición en masa con quickfix

<leader>fg o :grep para reunir apariciones de un término en la quickfix. :copen para revisarlas. Practica un :cdo s/…/…/g | update (puedes deshacerlo después con u).

8
Mira el estado con Git

Con gitsigns, salta por los cambios que hiciste con ]h y previsualízalos con <leader>hp. Abre lazygit (<leader>gg) y observa el diff — sin commitear nada si el repo no es tuyo.

9
Deja el dojo como lo encontraste

Deshaz todo con u (o :earlier 30m, o descarta con Git). El kata no cambia el código: te cambia a ti. El repo vuelve a su estado original.

Por qué funciona un kata

En artes marciales, un kata es una secuencia que repites miles de veces hasta que el cuerpo la ejecuta sin la mente. Este circuito hace lo mismo con Neovim: al encadenar navegación → lectura → edición → refactor → automatización → git en una sola sesión, dejas de pensar en técnicas sueltas y empiezas a fluir entre ellas. La primera vez tardarás y dudarás. A la quinta, tus manos irán solas. Ahí es donde vive el nivel dios: no en saber los comandos, sino en no tener que pensarlos.

⚔️ Haz el kata tres veces esta semana
  1. Elige un repo y cronometra tu primera pasada por los 9 pasos.
  2. Anota en qué paso dudaste más — esa es tu técnica a reforzar.
  3. Repite el kata dos días después. ¿Menos dudas? ¿Menos tiempo?
  4. Cuando el circuito entero te fluya sin pensar, has llegado.