El protocolo de nivel genio es lo que hace buena a la inferencia económica. Una señal es el momento en que una falla empieza a formarse, y cada regla parte de ahí. Donde una regla puede ser un hook, un agente o un workflow, lo es. Donde no puede, la tabla lo dice.
prosaun párrafo que alguien tiene que recordar
lintuna revisión del plugin mismo, antes del release
hookscorre en cada llamada de herramienta que coincide
workflowsel script es el proceso
más débilmás fuerte
Prosa < lint < hooks < workflows. Intentamos poner cada regla tan arriba en esta escalera como sea posible. Las reglas 2 y 7 siguen siendo solo prosa, y la tabla las marca.
Las reglas
El protocolo, regla por regla.
Cada regla, la señal que la dispara, el plugin que la hace cumplir y qué tan fuerte es ese cumplimiento.
Regla
La señal
Se hace cumplir con
Fuerza
01Modelo correcto, en cada envío.Fija model a propósito: haiku para consultar, sonnet para construir, opus para juzgar. Nada hereda el nivel más alto por accidente.Un modelo omitido hereda el modelo más caro de la sesión, así que fíjalo en cada subagente y en cada agente de workflow.
estás por iniciar un subagente o un paso de workflow.
dojo-router: avisa ante un envío que no nombra modelo, y bloquea en modo block. Su mod completa el modelo según el rol.dojo-protocol: sus cuatro agentes por rol están fijados a haiku, sonnet y opus.
hook + mod
02Explora antes de tocar.Busca y luego lee el fragmento. Un modelo pequeño traza el terreno antes de que uno grande lo cambie.Un orquestador que delega tanto la exploración como la construcción nunca conoce el terreno, así que mira tú primero el código de más riesgo.
una edición a código que no has leído en esta sesión.
dojo-protocol: un agente scout en haiku y la skill scout-first lo enseñan. Ningún hook lo comprueba.
prosa
03Mantén el contexto pequeño.Primero grep y lee fragmentos. Una corrección de menos de diez líneas en un archivo se queda en el hilo principal; no lances un agente para eso.Revisa el tamaño de un archivo antes de leerlo; leer uno grande completo gasta contexto que el trabajo necesitaba.
un archivo grande, un log, un directorio entero.
dojo-gates: big-read rechaza leer completo un archivo grande. Mantener una corrección pequeña en el hilo principal es prosa.
hook + prosa
04Contrato antes de repartir.Escribe primero las decisiones compartidas en un archivo, da a cada agente archivos que nadie más escribe y condiciona cada oleada a una compilación limpia.Las pistas en paralelo se acoplan por decisiones y hechos derivados, no solo por archivos, así que congela las decisiones compartidas en un archivo versionado antes de repartir.
tres o más archivos, o dos o más agentes.
dojo-flow: la fase Contract escribe las decisiones compartidas y rechaza pistas que se traslapan, dentro del workflow.dojo-protocol: la skill contract enseña propiedad disjunta. Nada fuera del workflow la hace cumplir.
workflow + prosa
05Terminado significa verificado.Corre la verificación en esta sesión y muestra su resultado. Un reporte, tuyo o de un agente, es una afirmación hasta que una verificación lo respalde.El reporte final de un agente es una hipótesis; verifica el árbol y corre tú mismo las puertas.
estás por escribir "listo", "arreglado" o "las pruebas pasan".
dojo-verify: su hook Stop bloquea un mensaje final que declara éxito cuando ninguna verificación ha pasado desde tu última edición, y nunca dos veces seguidas. Su mod muestra un estado UNVERIFIED.
hook + mod
06Cuenta retornos, no envíos.Di enviados, retornados y fallidos. Un revisor muerto se ve exactamente igual que uno limpio.Los arneses de reparto fallan abiertos: una lente muerta se lee como una lente limpia.
resumir un reparto de trabajo.
dojo-flow: el marcador reporta enviados, retornados y fallidos.dojo-verify: su mod muestra el mismo conteo mientras ocurre.
workflow + mod
07Depura por refutación.Enuncia la cadena causal y el experimento más pequeño que enciende y apaga el error. Si no puedes, observa; no parches.Si no puedes nombrar el experimento que enciende y apaga el error, observa en lugar de parchar.
estás por parchar.
dojo-protocol: el protocolo y sus skills. Ningún hook lo comprueba.
prosa
08Configuración antes que código.Revisa env, ajustes y credenciales antes de leer la lógica.Las fallas totales, que no dependen de la entrada, apuntan a la conexión; las parciales, que sí dependen, apuntan a la lógica.
falla siempre, en una frontera (401, conexión rechazada, falta al arrancar).
dojo-gates: config-first agrega una nota tras un 401, una conexión rechazada o un comando inexistente.
hook
09El silencio no es un hallazgo.Demuestra que puede ver un positivo conocido antes de confiar en un negativo.Un sondeo que no imprime nada quizá nunca corrió, así que el silencio no es un hallazgo hasta que un control demuestre que el instrumento funciona.
un sondeo no imprimió nada.
dojo-gates: empty-probe agrega una nota una vez por sesión tras un sondeo que no imprimió nada.
hook
10Lo irreversible necesita un sí.Revisa exactamente qué saldrá de la máquina y luego pide el visto bueno de la persona.Un deploy público no se puede revertir, y tu último deploy puede no ser el que está en vivo.
push, deploy, publish, delete, send.
dojo-gates: rechaza el staging a ciegas, la reescritura de commits ya publicados, imprimir secretos y tokens en URLs. Revisar qué sale de la máquina y pedir el visto bueno es prosa.
hook + prosa
Notas
Lo que esta tabla no afirma.
Apagarlo
dojo-protocol agrega las diez reglas al contexto de la sesión al iniciar. El ./DOJO.md de un proyecto reemplaza el texto, y DOJO_PROTOCOL_OFF=1 lo apaga.
Se enseña, no se impone
Las reglas que piden criterio no las puede imponer un hook. La propiedad disjunta de archivos entre agentes, por ejemplo, la enseña una skill y nada la impone fuera del workflow de dojo-flow.