El problema del traspaso
Cuando empiezas una nueva sesión de Claude Code, todo el contexto se pierde. Tienes que volver a explicar en qué estabas trabajando, qué archivos importan y qué queda por hacer.
/note-context resuelve esto creando una nota azul fijada con todo lo que la siguiente sesión necesita.
Secciones de salida
| Sección | Contenido |
|---|---|
| Encabezado | proyecto @ rama | N cambios sin commit |
| Trabajando en | Tarea actual, específica y clara |
| Archivos clave | 3-5 archivos más importantes con anotaciones de 5 palabras |
| Estado | Propósito de la rama, resumen sin commit, progreso del loop |
| Decisiones clave | Decisiones tomadas solo en esta sesión |
| Preguntas abiertas | Elementos sin resolver e incógnitas |
| Continuar con | Instrucciones exactas para la siguiente sesión |
Formato de archivos clave
Cada archivo recibe una anotación corta:
src/auth.ts — Middleware de validación JWT (refactorizando)
src/api/users.ts — Nuevo endpoint, necesita tests
tests/auth.test.ts — 3 tests fallan en refresh
Máximo 5 archivos. Solo los más relevantes.
La sección «Continuar con»
Esta es la sección crítica. Vara de calidad:
Leer SOLO «Continuar con» debe decirle a una sesión nueva exactamente qué hacer a continuación.
Bueno:
Continuar con: Arreglar el flujo de refresh token en src/auth.ts:45.
La función validateToken tiene que comprobar la caducidad del token
y llamar a refreshToken() antes de devolver 401.
Ejecuta los tests con: npm test -- auth
Malo:
Continuar con: Seguir trabajando en auth.
Siempre fijada
La nota de contexto siempre es:
- Color azul
- Fijada sobre todas las ventanas
- Se actualiza si tiene menos de 3 horas; si no, crea una nota nueva
Solo una nota de contexto activa a la vez — siempre el último snapshot.
Modo sin git
Funciona sin repositorio de git. Salta las secciones relacionadas con git (rama, cambios sin commit) y se enfoca en el estado de las notas y el contexto que le pases.
Marca de tiempo
Cada nota de contexto incluye la hora exacta:
Contexto 19 feb 2026 23:15