La suite.

El Protocolo Dojo para Claude Code: diez reglas al iniciar la sesión, una columna scout→contract→build→verify y agentes por rol fijados al modelo correcto.

Componentes

• Hook: hooks/session_start.py (SessionStart) agrega las diez reglas al contexto de la sesión; el ./DOJO.md de un proyecto reemplaza el texto
• Agentes: dojo-protocol:scout (haiku), dojo-protocol:builder (sonnet), dojo-protocol:reviewer (sonnet), dojo-protocol:judge (opus)
• Skills: protocol, scout-first, contract, refute, delegate
• Estilo de salida: status-and-path (primero una línea de estado; los entregables grandes van a un archivo y regresan como una ruta)

Instalar

En Claude Code

/plugin install dojo-protocol@dojo-genesis

Interruptor

DOJO_OFF=1 o DOJO_PROTOCOL_OFF=1. El ./DOJO.md de un proyecto reemplaza el texto.

Guardias deterministas para los errores que te cuestan un día: staging a ciegas, reescribir commits ya publicados, imprimir secretos, lecturas desmedidas, sondeos silenciosos.

Componentes

• Skill: gates (qué hace cada guardia, los ids, cómo anularlas)
• Hooks: las guardias de abajo, cada una con un id

Guardias

• staging rechaza el staging a ciegas (git add con -A, --all o un punto, y git commit -a) y sugiere rutas explícitas
• pushed-rewrite rechaza amend, rebase, hard reset y force-push cuando los commits ya están en un remoto; los permite cuando no
• secret-print rechaza comandos que imprimen variables de entorno con forma de secreto o leen archivos .env
• token-url rechaza cadenas con forma de token dentro de URLs y argumentos de git y curl
• big-read rechaza leer completo un archivo grande y sugiere grep o un offset y un límite
• mac-timeout en macOS, rechaza el comando timeout cuando no está instalado y dice cómo arreglarlo
• masked-exit avisa cuando a una prueba o compilación canalizada a tail, head o grep le sigue un commit o push, porque el pipe oculta el código de salida
• config-first tras un 401, una conexión rechazada o un comando inexistente, agrega una nota para revisar env, ajustes y credenciales antes que la lógica (una vez por sesión por patrón)
• empty-probe tras una búsqueda o sondeo que no imprimió nada, agrega una nota: demuestra que puede ver un positivo conocido antes de confiar en el negativo (una vez por sesión)
• claude-md-reach apagada por defecto (el ajuste claude_md_reach la activa); si se activa, niega una vez la primera edición bajo un directorio cuyo CLAUDE.md más cercano no se cargó en la sesión y nombra el archivo que hay que leer

Instalar

En Claude Code

/plugin install dojo-gates@dojo-genesis

Interruptor

DOJO_OFF=1 o DOJO_GATES_OFF=1. Omite guardias sueltas con DOJO_GATES_SKIP=<id>,<id>.

Ningún subagente hereda en silencio tu modelo más caro. Avisa o bloquea los envíos sin modelo fijado; el mod los enruta por rol.

Componentes

• Hook: hooks/agent_model.py (PreToolUse en Agent y Task) avisa, o bloquea en modo block, cuando un subagente no nombra modelo
• Hook: hooks/workflow_models.py (PreToolUse en Workflow) lista los agentes de un workflow que no nombran modelo
• Mod: hooks/register.ts completa el modelo según el rol y muestra el modelo elegido en la línea de estado
• Skill: router (la tabla de roles, y cómo fijar model en una llamada y en un workflow)
• Ajustes: mode, default_tier, explore_tier, auto_route, opus_cap

Instalar

En Claude Code

/plugin install dojo-router@dojo-genesis

Interruptor

DOJO_OFF=1 o DOJO_ROUTER_OFF=1. El ajuste mode acepta warn, block u off; auto_route apaga el enrutamiento del mod.

acceso anticipado Mod: acceso anticipado. Necesita function hooks (CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1); los hooks clásicos de arriba funcionan sin ellos.

Mira cuánto cuesta cada turno, agente y modelo, y qué tan grande es tu contexto: un reporte de costo a partir de tus transcripciones y una banda en vivo con el mod.

Componentes

• Comando: /dojo-meter:cost lee tus transcripciones e imprime una tabla por modelo y por hilo principal frente a subagentes. Es una estimación a precios de lista; los modelos desconocidos aparecen como sin precio, nunca como cero
• Mod: hooks/register.ts mantiene una banda en vivo (estimado de la sesión, tamaño del contexto, proporción de lectura de caché) y avisa cerca de un presupuesto o de un contexto grande
• Comando: /dojo-meter:band muestra u oculta la banda
• Ajustes: show_band, budget_usd, context_warn_tokens

Instalar

En Claude Code

/plugin install dojo-meter@dojo-genesis

Interruptor

DOJO_OFF=1 o DOJO_METER_OFF=1. El ajuste show_band oculta la banda.

acceso anticipado Mod: acceso anticipado. Necesita function hooks (CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1); el comando /dojo-meter:cost de arriba funciona sin ellos.

"Hecho" significa que una verificación corrió y pasó en esta sesión. Señala las declaraciones de éxito sin evidencia detrás.

Componentes

• Hook: hooks/stop_evidence.py (Stop) bloquea un mensaje final que declara éxito cuando ninguna verificación ha pasado desde tu última edición, y nunca bloquea dos veces seguidas
• Skill: evidence (un reporte es una afirmación; carga la página real tras un deploy; una salida vacía no es evidencia)
• Mod: hooks/register.ts muestra un estado UNVERIFIED y un conteo de enviados, retornados y fallidos para los agentes
• Ajustes: mode, show_status, toast_unverified

Instalar

En Claude Code

/plugin install dojo-verify@dojo-genesis

Interruptor

DOJO_OFF=1 o DOJO_VERIFY_OFF=1. El ajuste mode acepta block, warn u off; show_status y toast_unverified silencian el mod.

acceso anticipado Mod: acceso anticipado. Necesita function hooks (CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1); los hooks clásicos de arriba funcionan sin ellos.

Construcciones en paralelo que siguen siendo independientes: una puerta de contrato, scouts en modelos pequeños, builders en el medio, jueces en los extremos y un marcador que cuenta los retornos.

Componentes

• Workflow: build corre Contract, Scout, Advise, Build, Integrate y Audit; su fase Contract rechaza pistas que se traslapan
• Workflow: converge corre lentes de auditoría, verificación adversarial de cada hallazgo, correcciones opcionales y una puerta
• Comandos: /dojo-flow:build, /dojo-flow:converge
• Skill: dag-plan (cómo dividir un objetivo en pistas independientes, y reportar retornos en lugar de envíos)
• Script: scripts/dag_ops.py (validate, width, critical path, cone)

Instalar

En Claude Code

/plugin install dojo-flow@dojo-genesis

Interruptor

Sin hooks. Nada corre a menos que lo invoques. Para apagarlo, desactívalo o desinstálalo con /plugin.

Encuentra los hooks y ajustes que fallan o te cuestan en silencio: intérpretes rotos, inyecciones ruidosas, peso de tokens siempre activo, flags apagados.

Componentes

• Comando: /dojo-doctor:check corre scripts/doctor.py, que solo lee. Nunca ejecuta los comandos de tus hooks
• Secciones: intérpretes, fallas de hooks en transcripciones recientes, peso de las inyecciones, peso siempre activo (una estimación), el flag de function hooks, la versión de python3
• Skill: doctor (cuándo correrlo, cómo leerlo)

Instalar

En Claude Code

/plugin install dojo-doctor@dojo-genesis

Interruptor

Sin hooks. Nada corre a menos que lo invoques. Para apagarlo, desactívalo o desinstálalo con /plugin.

Resuelve afirmaciones con evidencia: experimentos preregistrados, líneas base con/sin y puertas de decisión antes de que algo se vuelva un número.

Componentes

• Skills: settle, decision-gate, eval-kit
• Script: scripts/prereg.py escribe un archivo de preregistro con un hash de la regla de decisión y lo verifica después
• Plantillas: templates/case.yaml, templates/prereg.md. Son andamios; la evaluación con/sin no se ha corrido

Instalar

En Claude Code

/plugin install dojo-settle@dojo-genesis

Interruptor

Sin hooks. Nada corre a menos que lo invoques. Para apagarlo, desactívalo o desinstálalo con /plugin.

Mira en vivo a cada subagente de un reparto, dirige a uno a mitad de camino y detecta los atascos por lo que escribe, no por lo que dice.

Componentes

• Mod: hooks/register.ts sigue a cada subagente desde su arranque, sus llamadas a herramientas y el fin de cada turno; corre la revisión de atascos y los comandos
• Mod: hooks/views.tsx dibuja el panel Fleet, una banda sobre el prompt con una ficha por agente, y una barra del agente
• Mod: hooks/model.ts guarda las reglas, sin llamadas al motor: motivos de atasco, detección de escritores, filas, fichas y el texto del nudge
• Comandos: /fleet, /fleet list, /fleet engine, /steer <#n or name> <message>; corren al instante, incluso con un turno en curso
• Revisión de atascos: un agente en ejecución se marca cuando lleva stall_minutes sin hacer una llamada a herramienta, cuando una llamada no ha regresado en ese tiempo o, si su brief le pide escribir, cuando no ha escrito nada en ese tiempo. Juzga lo que el agente hace, nunca lo que dice, y no marca a un agente que espera a agentes propios en ejecución
• En espera: un agente que termina un turno pero el motor aún retiene, parado en trabajo propio de fondo, se muestra como en espera, no como terminado
• Nudge: envía al agente un solo aviso; si se vuelve a atascar, el panel dice que lo detengas y construyas esa pista en línea
• Ajustes: stall_minutes (por defecto 10; 0 apaga la revisión de atascos), show_band, stall_toast

Instalar

En Claude Code

/plugin install dojo-fleet@dojo-genesis

Interruptor

DOJO_OFF=1 o DOJO_FLEET_OFF=1. Cualquiera de los dos deja el mod como un paso libre: sin seguimiento, banda, panel ni comandos. El ajuste show_band oculta la banda.

Límites honestos

• La detección de escritores lee el brief: uno que pide editar, escribir, implementar o corregir hace un escritor; uno que dice no escribir nada, no. Un agente que escribe de todos modos pasa a ser escritor desde su primera escritura
• La revisión de atascos corre cada 15 segundos, así que una marca puede llegar hasta ese tiempo después del umbral; las edades del panel son las del último ciclo
• Un agente cuyo arranque el mod nunca vio (uno iniciado antes de que cargara el mod) aparece bajo un id corto hasta que se vuelve a ver
• Los agentes que inicia un script de workflow se siguen, pero el motor no los lista, así que nunca se marcan como terminados por faltar en esa lista
• Stop pasa por la verificación de permisos normal de la herramienta de detención

acceso anticipado Solo mod: acceso anticipado, llega con la versión 2.1.0. Necesita function hooks (CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1) y no tiene hooks clásicos; sin ellos, su comando solo dice que el mod no está corriendo.

Dos agentes que escriben un mismo archivo se pisan: el primer escritor retiene el archivo mientras corre, a un segundo agente en ejecución se le rechaza, y los repartos reciben el contrato compartido.

Componentes

• Mod: hooks/register.ts reclama y libera carriles, rechaza a un segundo escritor, agrega la nota del contrato y responde a /lanes
• Carriles: el primer subagente que escribe un archivo (Edit, Write, NotebookEdit) lo retiene como su carril mientras corre; la escritura de otro subagente en ejecución sobre ese archivo se rechaza, y el rechazo le dice que ponga el cambio en su reporte. El hilo principal nunca es rechazado; una escritura del hilo principal en un carril retenido se registra una vez
• Liberación: un carril se libera cuando su agente termina. Un agente que cierra un turno pero el motor aún retiene conserva sus carriles hasta que el motor diga que terminó
• Nota del contrato: al lanzar un subagente, si existe un archivo de contrato o ya corre otro agente que escribe, se agrega a su brief una nota breve: dónde están las decisiones compartidas, y que los archivos que escriba primero serán su carril. Dos o más agentes que escriben, en curso y sin archivo de contrato, disparan un aviso por oleada (regla 4)
• Comando: /lanes muestra cada agente, su estado y los archivos que retiene, y luego las escrituras en disputa
• Ajustes: mode, attach_contract, contract_paths

Instalar

En Claude Code

/plugin install dojo-lanes@dojo-genesis

Interruptor

DOJO_OFF=1 o DOJO_LANES_OFF=1. Cualquiera de los dos deja el mod como un paso libre. El ajuste mode acepta lock (rechaza a un segundo escritor), warn (lo deja pasar y registra) u off (solo registra).

Límites honestos

• Las rutas se comparan como están escritas, tras resolver rutas relativas y puntos. No se resuelven mayúsculas ni enlaces simbólicos, así que dos formas de escribir un archivo en un disco que no distingue mayúsculas son dos carriles
• Solo se vigilan las herramientas de archivos. Un comando de shell que escribe un archivo no se ve
• Un carril se retiene por archivo, no por región de un archivo
• Los agentes que inicia un script de workflow retienen carriles como cualquier otro, pero el motor no los lista, así que sus carriles solo los libera el fin de su propio turno
• La guardia falla abierta: si no puede decidir, la escritura pasa

acceso anticipado Solo mod: acceso anticipado, llega con la versión 2.1.0. Necesita function hooks (CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1) y no tiene hooks clásicos; sin ellos, su comando solo dice que el mod no está corriendo.

Cuenta retornos, no envíos: cuando un reparto se asienta, el modelo oye qué volvió (retornados, fallidos, silenciosos, sin verificar), y /tally refute manda un reporte a un juez.

Componentes

• Mod: hooks/register.ts abre las oleadas, clasifica a cada agente, agrega la nota de cierre y responde a /tally y /tally refute
• Oleadas: el primer arranque abre una oleada; todo agente lanzado mientras está abierta se une a ella; se cierra cuando todos sus miembros terminaron. Un agente que cierra un turno pero el motor aún retiene está en espera, no retornado
• Clasificación, gana la primera coincidencia: failed (un error, una negativa, una interrupción, una respuesta vacía o un agente que el motor detuvo); silent (un veredicto limpio de un agente que no miró nada); unchecked (la afirmación de una verificación aprobada de un agente que no corrió ningún comando de shell); returned (todo lo demás)
• Nota de cierre: cuando se cierra una oleada de min_wave agentes o más, un aviso y una nota agregada a la conversación principal para que el modelo la lea: los conteos y cada agente que no simplemente retornó
• Comandos: /tally (la oleada abierta y las últimas cerradas, una fila por agente: resultado, trabajo, cuánto vivió), /tally refute <n> (manda el reporte del agente n al agente juez del protocolo, o a un agente de propósito general si el juez no está instalado; el veredicto se agrega a la conversación)
• Ajustes: min_wave (por defecto 2), settle_note, judge_model

Instalar

En Claude Code

/plugin install dojo-tally@dojo-genesis

Interruptor

DOJO_OFF=1 o DOJO_TALLY_OFF=1. Cualquiera de los dos deja el mod como un paso libre. Poner settle_note en false conserva el aviso y quita la nota.

Límites honestos

• silent y unchecked leen la redacción de la respuesta: un veredicto formulado de un modo que los patrones no conocen cuenta como retornado
• Un comando de shell puede verificar cualquier cosa, así que un agente que corrió uno y afirma que pasó cuenta como retornado aunque el comando haya verificado otra cosa
• Solo se guardan las últimas cinco oleadas; /tally refute nombra a los agentes por su número en la sesión
• El /refute suelto es solo un atajo: cuando otro plugin tiene el nombre (la skill refute de dojo-protocol lo tiene), Claude Code se lo deja; /tally refute <n> siempre funciona
• Los agentes compañeros (los que quedan inactivos entre mensajes) no se cuentan
• La nota de cierre llega unos segundos después de que termina el último agente: el mod primero le pregunta al motor si ese agente ya terminó
• Un juez de /tally refute corre en el modelo que elijas y cuesta lo que cuesta ese modelo

acceso anticipado Solo mod: acceso anticipado, llega con la versión 2.1.0. Necesita function hooks (CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1) y no tiene hooks clásicos; sin ellos, su comando solo dice que el mod no está corriendo.

Revisa cada brief de subagente al enviarlo contra la skill delegate: detalle, archivos propios, verificación de hecho, forma del retorno. Un aviso, o una sola devolución.

Componentes

• Mod: hooks/register.ts revisa cada llamada a Agent al enviarla y responde a /dojo-brief
• Revisiones, en cada llamada a Agent: detalle (al menos min_chars caracteres); archivos propios (nombra un archivo o un directorio, o dice qué archivos puede escribir el agente); verificación de hecho (dice qué es hecho y cómo comprobarlo; no se pide a los tipos de agente de solo lectura); forma del retorno (dice qué devolver). Un fork hereda toda la conversación, así que nunca se revisa. La elección de modelo queda para dojo-router
• Modos: a un brief al que le falta un campo lo trata mode: notice (el envío sigue y una línea tenue nombra lo que falta), sendback (el primer envío se rechaza una vez, con la lista; un segundo envío con la misma descripción pasa), off (nada)
• Comandos: /dojo-brief pone la plantilla de brief en el prompt; /dojo-brief stats muestra cuántos briefs se revisaron en la sesión y qué les faltó. No es /brief: Claude Code tiene el suyo
• Ajustes: lint_briefs, mode, min_chars (por defecto 200)

Instalar

En Claude Code

/plugin install dojo-brief@dojo-genesis

Interruptor

DOJO_OFF=1 o DOJO_BRIEF_OFF=1. Cualquiera de los dos deja el mod como un paso libre. Poner lint_briefs en false apaga la revisión y conserva el comando.

Límites honestos

• Las revisiones leen la redacción, a propósito de forma laxa: un brief que menciona una prueba pasa la verificación de hecho aunque no diga cuál. Detectan el campo ausente, no el débil
• Una ruta sin extensión y sin comillas invertidas puede no reconocerse como archivo
• El objetivo, los hechos y las reglas que se traspasan son prosa; la revisión no los juzga
• La devolución se recuerda por descripción durante la sesión

acceso anticipado Solo mod: acceso anticipado, llega con la versión 2.1.0. Necesita function hooks (CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1) y no tiene hooks clásicos; sin ellos, su comando solo dice que el mod no está corriendo.

Mira un reparto como una línea de tiempo: un carril por agente, una marca por llamada a herramienta, los rechazos en rojo, en vivo en un panel.

Componentes

• Mod: hooks/register.tsx registra el arranque, las llamadas a herramientas y el fin de cada subagente; dibuja el panel; responde al comando
• Mod: hooks/model.ts guarda las reglas, sin llamadas al motor: oleadas, intervalos, marcas y las tiras de texto
• Mod: types/index.d.ts describe el estado que leen los dibujos
• Comandos: /swimlanes abre el panel Swimlanes y responde una línea, por ejemplo 3 agents in view; /swimlanes text responde en forma de texto en lugar de abrir un panel; /swimlanes all alterna entre la última oleada y todos los agentes guardados
• Oleada: el conjunto de agentes lanzados desde el último momento en que no corría ningún agente
• Escritorio, VS Code y móvil: un gráfico con una columna de etiquetas (número, etiqueta, modelo), una banda de carril desde el arranque hasta el fin, una marca por llamada a herramienta coloreada por tipo (read, write, bash, agent, other) y tan ancha como duró la llamada, una cruz roja para una llamada rechazada o fallida, una cola ámbar discontinua mientras un agente espera, un glifo de fin, una línea de «ahora» mientras hay agentes en vivo, un eje de tiempo y una leyenda. Pasa el cursor sobre una marca para ver su herramienta, su objetivo, su duración y el texto del rechazo
• Terminal: una fila por agente con una tira de intervalos de tiempo: un bloque donde corrió una llamada, una cruz para una llamada rechazada o fallida, un punto para inactivo, un glifo discontinuo para en espera
• Ajustes: enabled (por defecto activado)

Instalar

En Claude Code

/plugin install dojo-swimlanes@dojo-genesis

Interruptor

DOJO_OFF=1 o DOJO_SWIMLANES_OFF=1. Cualquiera de los dos deja el mod como un paso libre. El ajuste enabled, apagado en los ajustes del plugin, apaga el mod en todas las sesiones.

Límites honestos

• Mientras los agentes corren, el gráfico de escritorio es una imagen plana (un marco interactivo recargado cada segundo parpadeaba), así que los avisos al pasar el cursor aparecen cuando la oleada se asienta
• La terminal dibuja tiras de texto, no un gráfico
• Guarda los últimos 16 agentes y 200 llamadas de cada uno
• Una ✗ marca una llamada rechazada o fallida; el gráfico no distingue una de otra salvo por el texto al pasar el cursor

acceso anticipado Solo mod: acceso anticipado, llega con la versión 2.2.0. Necesita function hooks (CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1) fuera de la app de escritorio de Claude y no tiene hooks clásicos; sin ellos, su comando solo dice cómo activar el mod.

Una llamada a herramienta que rechaza una guardia de Dojo se dibuja como una tarjeta: quién la bloqueó, por qué, y la corrección como código que puedes copiar.

Componentes

• Mod: hooks/register.tsx lee el rechazo de una guardia y dibuja la tarjeta; responde al comando
• Mod: hooks/model.ts guarda las reglas, sin llamadas al motor: la lectura del texto de rechazo de una guardia
• Mod: types/index.d.ts describe el estado que leen los dibujos
• Tarjetas: cuando una guardia de Dojo (dojo-gates, dojo-lanes o una guardia agregada después) rechaza una llamada a herramienta, la transcripción muestra un error simple; el mod dibuja en su lugar una tarjeta, con la guardia que la bloqueó, el motivo y la corrección como código que puedes copiar. Toda otra fila queda para el motor
• La tarjeta: un cuadro con borde con texto y código, igual en todas las superficies. Para un rechazo de dojo-lanes nombra el archivo y quién lo retiene, en lugar de una corrección
• Comandos: /fixcards o /fixcards status dice si está activado o apagado y cuántas tarjetas se dibujaron en la sesión; /fixcards off apaga las tarjetas en esta sesión; /fixcards on las vuelve a activar
• Ajustes: enabled (por defecto activado)

Instalar

En Claude Code

/plugin install dojo-fixcards@dojo-genesis

Interruptor

DOJO_OFF=1 o DOJO_FIXCARDS_OFF=1. Cualquiera de los dos deja el mod como un paso libre. El ajuste enabled, apagado en los ajustes del plugin, apaga el mod en todas las sesiones.

Límites honestos

• En la app de escritorio, las llamadas a herramientas están dentro de una fila de paso contraída y la tarjeta se dibuja con ellas, así que solo puede verse cuando esa fila se expande. La tarjeta se ha visto en la terminal; en el escritorio todavía no está confirmada
• En la terminal, un grupo de herramientas plegado que contiene un rechazo se despliega, y el texto de rechazo sin procesar sigue apareciendo sobre la tarjeta (el motor ignoró una reescritura de ese texto)
• El rechazo de un subagente se dibuja en la transcripción propia de ese agente
• Lee el texto de rechazo de dojo-gates y dojo-lanes; una guardia desconocida igual recibe una tarjeta con su motivo

acceso anticipado Solo mod: acceso anticipado, llega con la versión 2.2.0. Necesita function hooks (CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1) fuera de la app de escritorio de Claude y no tiene hooks clásicos; sin ellos, su comando solo dice cómo activar el mod.