English · Español

Slash commands y subagentes de Claude Code — referencia

Un resumen orientado al usuario de cada slash command en .claude/commands/ y cada subagente en .claude/agents/. Los prompts fuente se mantienen en inglés (son configuración de herramienta consumida por Claude, no prosa del currículo — ver CLAUDE.md §0.6). Esta página documenta qué hacen, para que puedas auditar el flujo sin leer los prompts.

Slash commands

Invoca cualquiera de estos dentro de Claude Code como /<nombre>. La pista de argumento (cuando existe) te dice qué pasarle.

/phase-start <NN>

Abre una fase nueva según LYNX_CORTEX.md §7. Releé la sección del spec para la fase pedida más el addendum, crea el árbol docs/phase-NN-<slug>/ con placeholders vacíos para theory/, lab/, solutions/, notebooks/, diagrams/, siembra el directorio learners/<name>/phase-NN/ del learner activo, y escribe PHASE_NN_PLAN.md en la raíz del repo con siete secciones obligatorias (cobertura, status, archivos a crear, DoD, pasos, preguntas abiertas, riesgos). Luego se para y espera approved / revise / dig-deeper. No instala dependencias, no rellena solutions/, no escribe teoría, no commitea.

/phase-checkpoint

Snapshot de salud a media fase — útil cuando quieres saber dónde estás sin cerrar la fase. Identifica la fase activa desde learners/<name>/progress.md, lista qué está poblado vs. en stub bajo docs/phase-NN-*/ y learners/<name>/phase-NN/, inspecciona los checks de DoD en checkpoint.json, ejecuta just lint y just test (solo lectura — nunca arregla automáticamente), actualiza progress.md, añade una entrada al journal, y responde con un bloque de status ≤200 palabras: fase activa, progreso de DoD, bloqueos, siguiente paso concreto.

/phase-report

Cierra la fase activa según el ritual de §7. Verifica cada check de DoD en checkpoint.json (cualquier false aborta — sin trampas), corre el set completo de gates con tiempos (just setup, just lint, just test, just audit-deps, bandit, más cualquier gate específico de la fase), invoca los cuatro subagentes de abajo donde aplique, y escribe PHASE_NN_REPORT.md con ocho secciones (resumen, objetivos vs. resultados, verificación de DoD, mediciones, derivaciones matemáticas, trampas, reflexión, hilos abiertos). Marca la fase como done en progress.md y se para, esperando proceed para abrir la siguiente fase.

/derive <topic>

Produce una derivación de formato largo del topic pedido en el directorio theory/ de la fase activa. Localiza la fase activa, confirma que el topic está en alcance según la fila del spec (empuja hacia atrás si no), comprueba prerrequisitos y enlaza a derivaciones previas, escoge el siguiente prefijo numérico en theory/, y escribe una derivación con siete secciones (motivación, setup, derivación, ejemplo trabajado, estabilidad numérica, trampas, ejercicios) más un resumen breve en español al final por la política bilingüe. Pasa el trabajo a math-reviewer para una revisión de cordura antes de declarar hecho. Las soluciones van en solutions/ — nunca inline.

/break <concept>

Introduce un único bug instructivo y completamente reversible relacionado con el concepto nombrado, para que el learner lo depure desde logs, gráficas, o tests que fallen. Localiza el código objetivo (aborta si el concepto aún no está implementado), escoge un bug de una taxonomía definida (numérico, indexado, gradiente, memoria, determinismo — nunca compuesto, nunca relevante para seguridad, nunca enmascarando tests), hace el diff más pequeño posible, registra el bug con una cascada de pistas y el diff del arreglo en learners/<name>/phase-NN/notes/breaks.md, y verifica que el fallo es observable vía just test. El arreglo debe ser ≤5 líneas.

/quiz <NN>

Genera un quiz socrático sobre la fase pedida. Lee todos los archivos theory/ más los intentos y reflexiones del learner (para que los topics donde le costó más reciban más presión), genera 8–12 preguntas mixtas — "por qué", "deriva", "predice", "rompe", "transfiere" (nunca opción múltiple, nunca solo definiciones), guarda el quiz y una clave de respuestas secreta bajo learners/<name>/phase-NN/quizzes/, y le dice al learner dónde escribir las respuestas. Cuando el learner responde graded, puntúa cada pregunta (✅/⚠️/❌), propone un follow-up de 1 línea para cada respuesta incorrecta o parcial, y bloquea /phase-report si la puntuación es menor al 70%.

Subagentes

Estos viven en .claude/agents/ y son invocados por la sesión principal de Claude (o vía Agent desde otro agente). La pista "use proactively" en el frontmatter le dice a Claude cuándo ofrecerlos.

math-reviewer

Lee una derivación en docs/phase-NN-*/theory/ o una función con matemática en src/, y reporta — específicamente — qué está mal, ambiguo, o falta. Comprueba ocho cosas: definiciones antes de uso, convenciones consistentes (fila vs columna, indexado, broadcasting), cada paso justificado (sin "se puede demostrar que"), trampas de estabilidad numérica (log-sum-exp sin desplazamiento por el máximo, softmax sin restar el máximo), casos límite (x = 0, batch 1, entrada vacía), errores de signo y regla de la cadena en el paso backward, composición de dimensiones, y la presencia de un ejemplo trabajado. Salida: una lista con ubicación, severidad (🔴 / 🟡 / 🟢), hallazgo, y arreglo. Veredicto: PASS o REVISE. No reescribe — solo señala.

numerical-stability-checker

Revisa el código en src/ y experiments/ buscando los lugares donde la realidad del punto flotante muerde. Comprueba formas estables (log_sum_exp, softmax con max-shift, expm1, log1p), defensas contra división por cero y logaritmo de cero con ε nombrado, sobres de overflow / underflow (en float32, exp(89) desborda; exp(-104) cae a cero), fontanería de determinismo (seed_everything en cada entrypoint, manifest.json persistido, sin np.random.rand() desnudo, cudnn.deterministic cuando se usa CUDA), consistencia de dtype en fronteras, orden de reducción para sumas largas, aliasing en operaciones in-place, y comprobaciones de gradiente contra referencias por diferencias finitas. Salida: hallazgos con file:line, un snippet de reproducción ≤5 líneas, y un arreglo concreto. Mismo veredicto PASS/REVISE que math-reviewer.

journal-summarizer

Lee todas las entradas learners/<name>/journal/YYYY-MM-DD.md entre la fecha de inicio de la fase y la del report, más el borrador de reflexión del learner y el historial de attempts/, y destila un bloque ceñido y respaldado por evidencias para PHASE_NN_REPORT.md §6. Extrae cinco cosas: lo que hizo clic (con puntero a fecha del journal), lo que no (candidatos a carryover), sorpresas (huecos spec-vs-realidad), fricción del flujo (quejas recurrentes de tooling/estructura — alimenta PROPOSAL_REVIEW.md), y un conteo aproximado de horas de estudio. Salida: un bloque de markdown listo para pegar, bajo 250 palabras. Nunca inventa emociones; solo cita de los archivos.

phase-gatekeeper

El revisor adversarial al cierre de fase. Tanto el learner como la sesión principal tienen incentivos para declarar una fase hecha — el único trabajo del gatekeeper es verificar la Definition of Done de forma independiente. Lee la fila del spec más PHASE_NN_PLAN.md §3, y para cada check en checkpoint.json re-ejecuta la prueba de forma independiente: vuelve a correr just test en vez de confiar en el JSON, comprueba existencia y sustancia de archivos en vez de solo paths, verifica que el learner intentó el lab antes de mirar solutions/. Audita las anti-goals (sin PyTorch antes de la Fase 24, sin expansión del alcance §A13 de gramática verbal sin un proceed explícito), reproducibilidad (semillas, manifests), y seguridad (pip-audit, bandit, sin pesos de modelo committeados). Veredicto: PASS o BLOCK — sin acolchado de cortesía.

Por qué estos se quedan en inglés

Son prompts de infraestructura — leídos por Claude Code, no por el learner. Traducirlos arriesga prompts en idioma partido donde el frontmatter (que el registro de Claude Code indexa) se queda inglés pero el cuerpo pasa a español, lo cual es frágil. La política bilingüe (§A17) excluye explícitamente refs estables como commands, identificadores, y configuración de herramienta. Esta página es la ruta de auditoría del hispanohablante: lee aquí para entender qué hace cada command, lee el fuente bajo .claude/ si quieres ver cómo el prompt lo consigue.