IA y agentes02 / 12
Agent Studio
Un estudio de ingeniería sobre Claude Code con enrutado determinista y controles estrictos
- Estado
- Funciona, sin desplegar
- Periodo
- 2026 →
- Rol
- Diseño y desarrollo, de principio a fin
- Para
- Herramienta interna para mis propios proyectos.
Vívelo
Ilustración de herramientas reales: un recorrido guionizado, no la grabación de una sesión en directo.
Una tarea a través del estudio
Paso actual · Paso 1 de 16
Request arrives
A task is typed into the session: add a small feature to an existing project.
Mensaje · You → Main agent
Registro de pasos
- 01 Request arrives[Mensaje]
- 02 SessionStart injects the project briefing[Hook · permitido]
- 03 Main agent plans[Mensaje]
- 04 Delegates a read-only search to Explore[Delegar]
- 05 Explore reports back[Mensaje]
- 06 Delegates the change to implementer[Delegar]
- 07 Implementer tries a shell command[Llamada a herramienta]
- 08 guard_bash asks or denies[Hook · bloqueado]
- 09 Implementer creates a new file[Llamada a herramienta]
- 10 guard_reuse blocks the duplicate[Hook · bloqueado]
- 11 Implementer extends the existing file[Llamada a herramienta]
- 12 Tests run[Llamada a herramienta]
- 13 Stop gate fails[Control · falla]
- 14 Agent fixes the cause[Llamada a herramienta]
- 15 Stop gate passes[Control · pasa]
- 16 Done[Mensaje]
Problema
Trabajar con agentes de IA es poco fiable cuando cada sesión improvisa su modelo, sus reglas y sus comprobaciones. La calidad depende de la suerte y de lo cuidadoso que fuera el último prompt.
Agent Studio es el entorno con el que construyo: tres plugins, trece agentes especialistas y dieciséis skills, unidos por hooks que frenan los cambios malos antes de que lleguen.
Caso de estudio
Cada agente fija su modelo y su nivel de esfuerzo en su definición, de modo que el enrutado es un hecho de la configuración y no una decisión por sesión. Un arquitecto corre en Opus con esfuerzo extra alto, un implementador en Sonnet con esfuerzo medio, un redactor en Haiku con esfuerzo bajo, y hay un nivel de escalado aparte para los casos difíciles.
Los hooks imponen las reglas. Rechazan comandos de shell peligrosos y exigen commits convencionales, mantienen fuera de alcance los secretos y los lockfiles, bloquean archivos y definiciones duplicados al primer intento y ejecutan los controles de lint, validación y tests del propio proyecto antes de dejar terminar un turno.
Arquitectura
Tres plugins (studio, studio-web, studio-ai) contienen los agentes y las skills. Siete registros de hooks sobre cinco eventos implementan los guardianes de bash, archivos y reutilización, y el control de parada, que permite como máximo tres intentos y busca marcadores de relleno.
Decisiones técnicas
- Modelo y esfuerzo fijados por agente, para que coste y calidad sean predecibles.
- Reglas impuestas por hooks que actúan, no por instrucciones que el modelo puede olvidar.
- Un guardián de reutilización que bloquea duplicados al primer intento.
- Quien escribe y quien revisa son siempre contextos distintos.
Retos y compromisos
Hacer los guardianes lo bastante estrictos para que importen sin convertirlos en fricción. Por eso el control de parada limita los reintentos y los hooks tienen sus propios tests.
Resultados verificados
- 3 plugins, 13 agentes especialistas, 16 skills
- 7 registros de hooks sobre 5 eventos, 31 tests de hooks
- Funciona en local; privado
Los estados son factuales: nada se presenta más terminado de lo que está.