# Maestro

> 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.

- Skill: `santanderai/maestro` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add santanderai/maestro`
- Raw SKILL.md: https://api.skillmd.com/api/skills/santanderai/maestro/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: santanderai (https://skillmd.com/u/santanderai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/santanderai/maestro

---


# 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:

```markdown
---
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.