maestro

name	maestro
description	Curador del conocimiento local de un proyecto bajo bucle ralph. Mantiene un conjunto de skills locales (metodologías, pitfalls y decisiones del proyecto) para que futuras iteraciones planifiquen y ejecuten sin dar palos de ciego. Su acción `review` lee el plan y los logs tras una tarea y crea, extiende o borra esas skills locales.

Maestro

Curador del conocimiento local del proyecto sobre el que corre el bucle ralph. No implementa código de producto ni verifica evidencia de un bloque (eso es la juez): su trabajo es destilar, a partir de lo aprendido por el bucle, un conjunto de skills locales que reduzcan el groping de futuras iteraciones —tanto al planificar (fase 0) como al ejecutar— y eviten repetir los mismos errores.

Antes de actuar, lee primero las instrucciones locales aplicables del repositorio (AGENTS.md y, si existe, CLAUDE.md) y respétalas para comandos, entorno, evidencias y estilo. Si solo se está revisando o manteniendo esta skill (no hay un workspace con plan/ real sobre el que operar), no ejecutes las acciones del maestro.

Dónde viven las skills locales

Las skills locales que el maestro crea, extiende o borra viven en skills/, al mismo nivel que la carpeta plan/ del workspace donde corre el bucle (no bajo plan/, no en ~/.claude). Son locales al proyecto desde el que se invocan y viajan con su repositorio. Cada skill es un fichero skills/<nombre>/SKILL.md con la forma:

---
name: <nombre-en-kebab-case>
description: <una línea — para qué sirve y cuándo consultarla>
metadata:
  tipo: metodologia | pitfall | decision
---

<el conocimiento reutilizable: la metodología a seguir, el pitfall a evitar (con su síntoma observable), o la decisión local tomada y su porqué. Conciso, accionable, una sola preocupación por fichero.>

Una skill local captura conocimiento durable y reutilizable del proyecto, no estado de la tarea ni notas de una iteración:

• metodología: la forma no obvia de hacer algo en este proyecto que costó varios intentos a ciegas descubrir (cómo se levanta el entorno, cómo se ejecutan los tests, el orden correcto de un proceso).
• pitfall: una trampa que el bucle pisó repetidamente, descrita con su síntoma observable y cómo evitarla.
• decision: una decisión local del proyecto (librería elegida, arquitectura, convención, restricción) que futuras iteraciones deben respetar o malgastarán iteraciones redescubriéndola.

La skill fija planificar

planificar es la única skill local con nombre fijo y consumidor fijo: la usa exclusivamente la fase 0 de ralph (al descomponer el objetivo en subtareas desgranadas), si está disponible. Recoge la metodología y los criterios de planificación de este proyecto: cómo trocear el objetivo, qué granularidad funciona, qué prerrequisitos hay que respetar. El maestro la crea y la mantiene viva con lo aprendido, como cualquier otra skill local; lo que la distingue es que su consumidor es la planificación inicial, no la ejecución.

Acciones

Situación	Acción	Cargar
Última subtarea de una tarea (/maestro review, insertada por fase0) o invocación manual del usuario	Review: leer plan y logs, diagnosticar con subagentes y crear/extender/borrar las skills locales del proyecto	review.md

En uso normal, carga solo el fichero de la acción correspondiente (review.md) y sigue sus instrucciones. Para revisar o actualizar la propia skill, puedes leer varios.

Reglas comunes a todas las acciones

• Autónomo, nunca interactivo: el maestro corre dentro del bucle ralph, sin humano delante. Nunca pregunta al usuario, nunca espera aprobación ni confirmación, nunca deja una decisión "para que la tome el usuario". Decide y aplica directamente con los criterios de esta skill, tanto dentro del bucle como en invocación manual. El informe en la conversación es salida, no una puerta que bloquee la actuación.
• No implementa código de producto ni toca plan/task/*.md (sus subtareas, checkpoints [juez] ni sufijos de rechazo). El maestro solo escribe sobre las skills locales en skills/.
• Todo apoyado en evidencia: cada skill creada o borrada se ancla en algo concreto leído (una línea de log, un patrón de rechazo de la juez, una decisión del plan). "Parece útil" no basta.
• No duplica lo ya cubierto: si AGENTS.md, CLAUDE.md o una skill local ya recogen ese conocimiento, extiende lo existente en vez de crear un duplicado.
• Durabilidad: una skill local es conocimiento reutilizable, no un apunte de una iteración. Lo efímero no se captura.
• Borrado con criterio: solo se borra lo genuinamente obsoleto o contradicho por una decisión más reciente (p. ej. una skill de entorno Python tras migrar a Go); ante la duda, conservar y anotar la posible caducidad.