Para quién es: para Edu, para leerla a menudo. Es el mapa de todo lo que rodea a Claude Code en el equipo, contado por lo que hace cada pieza y cuándo usarla, sin entrar en cómo está construida. El detalle técnico de cada cosa vive en las páginas enlazadas al final. Escrita el 09-09-2026 (sesión 316) al cerrar el grill del “escalón grande”; se revisa cuando el harness cambie de forma.
Qué es “el harness” en una frase
Es la maquinaria que rodea a Claude para que arranque sabiendo dónde iba, consulte antes de tocar, no pueda romper nada sin querer, y cierre dejando el terreno listo para la siguiente sesión. No es una herramienta: es un conjunto de piezas pequeñas, cada una con un trabajo, repartidas en dos mitades.
Las dos mitades
1. La mitad transversal viaja sola a cualquier proyecto en el que abras Claude Code. No hay que instalar nada por proyecto:
| Pieza | Qué hace por ti |
|---|---|
Las reglas globales (siete ficheros en ~/.claude/rules/) | El criterio de la casa: pensar antes de escribir código, verificar el efecto y no la señal, escribir para un compañero, diseñar con escala y tokens, reparar el mapa cuando una búsqueda falla, saludar a las otras sesiones, consultar la documentación viva de las librerías. |
El estilo de escritura companero | Que las respuestas empiecen por el resultado, sin jerga, y que lo cojo se diga al principio. |
El plugin method | Las herramientas para pensar y para hacer (sección de abajo). |
El plugin method-hooks | Cuatro candados genéricos que funcionan en cualquier repo con git: vigilante del CI en la barra de estado, guard del merge, aviso de módulo demasiado largo, tapado de secretos. |
La plantilla de encargo a subagentes (AGENT_BRIEF.md) | Once campos para que un agente delegado sepa exactamente qué hacer, qué verificar y qué no tocar. |
La memoria por proyecto (MEMORY.md + fichas) | Lo que Claude recuerda de una sesión a otra: quién eres, qué prefieres, dónde mordió cada trampa. |
2. El escalón grande cuesta infraestructura por proyecto y solo se aplica con criterio explícito, por piezas:
| Pieza | Qué hace por ti | La tienen hoy |
|---|---|---|
La Biblioteca (grafo del código + búsqueda + bib_ask) | Claude pregunta al mapa del proyecto en vez de adivinar; el código ya no hace falta leerlo entero. | CreaRack-Pro, el workspace, Play.Moode |
El estado vivo (STATE.md, NEXT.md, LOG.md) | La sesión de mañana sabe dónde se quedó la de hoy. | Los tres anteriores y FableCities |
| Los candados de Biblioteca (Regla 0 y gate de commit) | No se edita sin consultar; no se commitea sin reportar el cambio. Evitan que dos manos se pisen. | CreaRack-Pro, workspace, Play.Moode |
El plugin de equipo crearack + crearack-hooks | Lo que solo tiene sentido en CreaRack: la parte de equipo del doctor del método (identidad, rollup de los tres perfiles), la secretaria del plan, el correo, las rondas, los agentes de commit, y los avisos de estáticos y de Biblioteca en cada petición. | Los tres perfiles del equipo |
¿Merece un proyecto el escalón grande? (las pautas, 09-09-2026)
Cuatro señales, en orden de peso: (1) alguien más lo toca, hoy o en tres meses · (2) hay producción y un error cuesta · (3) ya no cabe en la cabeza (más de unos 300 ficheros de código o 500 commits) · (4) va a vivir más de 5 sesiones.
- Con 1 ó 2 señales se abre la conversación (un grill corto) y se decide qué piezas, o se descarta con motivo.
- Con 3 o más, el escalón entero con
/method:iniciar-proyecto. - Solo la 4: estado vivo y nada más, cero infraestructura.
Cada señal pide una pieza: personas → candados (que arrastran una Biblioteca en modo eco, sin crons, a coste cero) · producción → CI y guard del merge · tamaño → Biblioteca · duración → estado vivo.
Quién te hace la pregunta: el iniciador, siempre, antes de crear nada; y el arranque de sesión, una sola vez por repo, con una línea [escalon] cuando un repo sin Biblioteca cruza el umbral. No bloquea: decides tú. Tabla completa en claude-method/guides/SCALING.md.
Qué pasa cada vez que arrancas una sesión
En orden, y sin que hagas nada: el repo se pone al día · se imprime la hora local · la Biblioteca refresca su caché · el método se sincroniza con tu perfil · el doctor comprueba que el perfil está al 100 % · aparece el pulso de NEXT.md (qué toca hoy) · si el repo merece el escalón grande, el aviso [escalon]. Después Claude lee STATE.md y NEXT.md completos (Regla 19), saluda a las otras sesiones vivas, y consulta la Biblioteca antes de tocar nada (Regla 0).
Los candados: de qué te protege cada uno
Un candado que solo “está” no sirve; lo que importa es que bloquea. Por eso se prueban.
| Candado | Qué evita | Cómo se prueba |
|---|---|---|
| Regla 0 (consultar antes de tocar) | Editar, entrar por SSH o desplegar sin haber preguntado a la Biblioteca | Doctor (capa H) y /method:simulacro paso 6 |
| Gate de commit (reportar el cambio) | Commitear un fichero sin avisar a la Biblioteca de que cambió | Doctor (capa H) |
| Guarda del modelo de subagentes | Lanzar un agente delegado sin modelo o con el modelo caro | Doctor (capa H) |
| Rechazo del here-string en PowerShell | Mensajes de commit rotos | Doctor (capa H) |
| Guard del merge | Mergear un PR con comprobaciones pendientes, rojas o ausentes | Simulacro paso 3 |
| Vigilante del CI | Perder de vista si el último push está verde | Solo con un push real (se ve en la barra) |
| Módulo largo | Un fichero de lógica que pasa de 500 líneas sin que nadie lo diga | Simulacro paso 5 |
| Tapado de secretos | Que una clave aparezca en pantalla o en el registro | Simulacro paso 4 |
| Pre-commit gemelo del CI | Descubrir en el CI lo que el formateador podía decir en local | Se dispara solo en cada commit |
| Pre-push con los tests del área | Empujar código que rompe lo que toca | Se dispara solo en cada push |
Rutina: /method:doctor al arrancar (lo hace solo; desde el 09-09-2026 el doctor vale ya en cualquier proyecto, y en CreaRack carga solo la parte de equipo) y /method:simulacro tras cada versión nueva de los plugins de ganchos o de Claude Code. Si un candado no bloquea, lo primero es sospechar de BIB_GATE_SKIP=1 en el entorno.
Las herramientas para pensar (la antesala)
Ante una decisión gorda, primero se elige cómo decidir:
| Cuando… | Usa | Te devuelve |
|---|---|---|
| Aún no hay opción elegida y quieres abrir el abanico | /method:divergir | Varios enfoques aislados y un crítico |
| El plan ya está elegido y falta afinarlo contigo | /method:grill | Preguntas de una en una, con recomendación, guardadas a fichero |
| Tienes una idea formulada y quieres el veredicto | /method:roast | GO / RESHAPE / KILL con el test más barato |
| Necesitas investigar un tema con fuentes | /method:storm | Informe con cinco miradas expertas |
| El plan técnico está escrito y quieres buscarle agujeros | /method:plan-review | Objeciones numeradas de revisores fríos |
Toda decisión de nivel se cierra con una apuesta en WAGERS.md: qué esperamos, contra qué, cuándo se mira, y con qué muestra mínima. Al vencer, se evalúa contra el dato real.
Las herramientas para hacer
| Quieres… | Usa |
|---|---|
| Depurar un bug difícil con disciplina | /method:diagnose |
| Que una tarea con capas se haga despacio y bien | /method:fable-mode |
| Saber si tu perfil corre el método al 100 %, en cualquier proyecto | /method:doctor (los tres perfiles a la vez: /crearack:method-status) |
| Probar que los candados bloquean | /method:simulacro |
| Auditar si lo que dicen las reglas e índices sigue siendo verdad | /method:os-audit |
| Que el harness aprenda de las correcciones repetidas | /crearack:self-harness |
| Revisar un dominio de la app viva sin tocar nada | /crearack:ronda |
| Repasar el buzón sin enviar ni borrar | /crearack:correo |
| Ver tus tareas del plan de producto | /crearack:secre |
| Arrancar un proyecto con el escalón grande | /method:iniciar-proyecto |
| Que te lo expliquen más fácil, o en N puntos | /method:llano · /method:quick N |
| Buscar qué pediste en sesiones pasadas | python claude-method/harness/history.py buscar "<palabra>" |
Los ayudantes (agentes delegados)
- Vigía (
crearack:vigia) mira el CI de un push y diagnostica si algo falla. Solo lee. - Estibador (
crearack:estibador) lleva una rama ya commiteada de punta a punta: push blindado, CI, merge. Solo escribe en git. - Todo agente delegado va con modelo explícito y por debajo del que conduce (Regla 10) y con la plantilla de encargo. Delegas la ejecución, nunca la verificación.
La memoria y el estado
- Fichas de memoria: quién eres, qué prefieres, qué proyectos hay y dónde están las trampas (
footguns_*). Desde el 09-09 solo las trampas se empujan solas en las sesiones; el resto se consulta desde el índice. - Estado vivo:
STATE.md(foto de la última sesión),NEXT.md(qué toca),LOG.md(bitácora),WORKLOG.md(resumen para el equipo). - Wiki en dos voces: técnica (para el que construye) y coloquial (para el que usa); la ayuda de usuario se actualiza en el mismo ciclo que el cambio.
- Copia de seguridad de las memorias al cierre.
El cierre: “apaga”
Decir apaga dispara el ritual completo: actualizar STATE.md, escribir la entrada del LOG.md, mantener NEXT.md, podar lo cerrado hace más de dos sesiones, WORKLOG.md si la sesión fue significativa, y la copia de seguridad. Se ejecuta, no se pregunta.
Cuando algo falla
- El doctor dice qué pieza está desalineada y el arreglo exacto.
- El simulacro dice qué candado ha dejado de bloquear.
- El runbook de cambios del harness manda: cada cambio lleva etiqueta de marcha atrás (
pre-<cambio>-<fecha>enclaude-method) y se verifica desde otra sesión por el efecto, no por el aviso. - Backtrack: si Claude no encontró algo que existía, no se disculpa: repara el índice, la ruta o el alias para que la próxima búsqueda acierte a la primera.
Dónde vive cada cosa
| Qué | Dónde |
|---|---|
| El método entero | repo claude-method (C:/dev/claude-method en el PC de Edu) |
| Reglas globales | ~/.claude/rules/ (fuente: claude-method/global-rules/) |
| Plugins | claude-method/plugins/ → method, method-hooks, crearack, crearack-hooks |
| Guías | claude-method/guides/ → SCALING.md (escalón grande), PROJECT_INITIALIZER.md, AGENT_BRIEF.md, METHOD_DOCTOR.md, CREARACKSL_HARNESS_GUIDE.md |
| Scripts del arranque y del cierre | claude-method/harness/ |
| Reglas del proyecto CreaRack | CreaRack-Pro/CLAUDE.md y .claude/rules/ (antesala, traspaso de Fable, diseño, modelos) |
| Estado vivo del equipo | CreaRackSL-workspace/public/supercontext/ |
| Apuestas | CreaRackSL-workspace/public/supercontext/WAGERS.md |
Idea aparcada
Edu quiere valorar más adelante un repositorio propio en su perfil de GitHub Esquembri, al estilo de claude-method pero personal (un “Claude-Edu-method”), con la mitad transversal como base. Decisión pendiente: qué entra, cómo se sincroniza con claude-method, y con qué licencia.
Véase también
- [[ia-tech—metodo—claude-method-guide]]
- [[ia-tech—metodo—scaling]]
- [[ia-tech—metodo—iniciador-de-proyectos]]
- [[ia-tech—metodo—particion-function-hooks-2026-09]]
- [[ia-tech—metodo—agent-brief-2026-09]]
- [[ia-tech—metodo—antesala-y-voz]]
- [[ia-tech—metodo—runbook-cambios-harness]]
- [[ia-tech—metodo—os-audit-y-backtrack]]
- [[ia-tech—metodo—fable-handover]]