Llegaste al final de la ruta y del curso. Ahora no es momento de aprender más conceptos: es momento de armar tu sistema. En este módulo vas a construir tu biblioteca personal de subagentes, partir de un paquete inicial listo, aprender las plantillas que ahorran horas y revisar en una pantalla todo lo que enseñó el curso. Al final, un proyecto final: crear tu propia suite de agentes desde cero.
Contenido detallado
🗄️ Tu biblioteca de especialistas
Los agentes son archivos. Los archivos se organizan. La organización se convierte en poder.
Qué es
Una biblioteca de especialistas es un conjunto de archivos .md con definiciones de subagentes que mantienes y haces evolucionar. Cada archivo es un «empleado» con nombre, alcance, herramientas y restricciones bien definidos. La biblioteca está en dos lugares: ~/.claude/agents/ (disponible en todos los proyectos) y .claude/agents/ dentro de cada proyecto (específica del repositorio).
Por qué crear tu biblioteca
- ▸Evita reescribir el mismo system prompt cada vez: llama al agente por su nombre
- ▸Los agentes bien definidos cometen menos errores de alcance — saben lo que no deben hacer
- ▸Evoluciona con el tiempo: corrige un agente deficiente una vez y todos los proyectos se benefician
- ▸Los equipos pueden compartir la biblioteca mediante git: un estándar organizacional emergente
Conceptos clave
📦 Paquete inicial — 5 agentes para empezar hoy
security-auditor · test-runner · doc-writer · db-expert · plan-roaster
Qué es
Un conjunto de cinco agentes que cubre los casos de uso más comunes en el desarrollo de software. Son lo bastante genéricos para cualquier stack, pero lo bastante específicos para ser útiles sin personalización. Cópialos, ajusta los detalles de tu proyecto (nombres de bases de datos, frameworks, convenciones de pruebas) y tendrás una suite funcional en minutos.
Por qué estos cinco
Conceptos clave
- ✓Herramientas mínimas (solo las necesarias)
- ✓Restricciones explícitas ("nunca ejecuta X")
- ✓Alcance bien delimitado por agente
- ✓Formato de salida especificado
- ✗Agentes que hacen de todo (sin enfoque)
- ✗Permisos de escritura sin motivo
- ✗System prompts de más de 200 líneas
- ✗Dependencias circulares entre agentes
📐 Plantillas listas para tu suite
Frontmatter + cuerpo en minutos, no horas.
Qué es
Un template de agente tiene tres partes: el frontmatter YAML (metadatos que Claude Code lee), el system prompt (cómo debe comportarse el agente) y los ejemplos de uso (opcionales, pero muy útiles). Una buena plantilla es un atajo para crear agentes nuevos: completas las partes variables y tienes un agente funcional en 5 minutos.
Por qué usar plantillas
- ▸Consistencia: todos los agentes de la suite tienen la misma estructura de salida
- ▸Velocidad: un nuevo agente en 5 min sin pensar en la estructura
- ▸Onboarding: el nuevo colaborador entiende la convención sin documentación adicional
Conceptos clave: anatomía de la plantilla
✅ Lista de verificación de producción
Antes de poner un agente en uso real, revisa esta lista.
Qué es
Un checklist es el último filtro antes de que un agente pase a formar parte de tu biblioteca permanente. Abarca seguridad (herramientas mínimas, sin permisos innecesarios), calidad (system prompt claro, formato de salida definido) y operación (quién lo llama, cuándo, qué ocurre si falla).
Por qué usar una lista de verificación
Bash sin restricciones, los subprocesos pueden crear bucles o consumir recursos de forma inesperada. Siempre prueba primero en un entorno aislado.Conceptos clave: la lista de verificación resumida
🔀 Proyecto × Global en la práctica
Qué va a ~/.claude/ y lo que queda en .claude/?
Qué es
Claude Code resuelve los agentes en dos ámbitos: global (~/.claude/agents/) y local (.claude/agents/ del proyecto). Si existe un agente en ambos lugares con el mismo nombre, el local sobrescribe al global, lo que permite "sobrescribir" especialistas genéricos con versiones adaptadas al proyecto sin eliminar el global.
Por qué esto importa en la práctica
- • security-auditor genérico
- • doc-writer universal
- • plan-roaster predeterminado
- • Agentes para uso personal constante
- • db-expert del stack del proyecto
- • test-runner con el framework adecuado
- • style-reviewer de la guía del equipo
- • Agentes específicos del dominio
Conceptos clave
🧠 Recapitulación general — el curso en una pantalla
Todo lo que importa, en frases de una línea.
Qué es
Esta es la diapositiva 18: la pantalla de cierre del curso. Cada regla de abajo resume un concepto completo que estudiaste. Si alguna te suena extraña, es señal de qué módulo debes repasar. Si todas te resultaron claras de inmediato, terminaste el curso con el mapa mental correcto.
🤖 Subagentes: qué permanece
.claude/agents/
~/.claude/agents/
— fin del curso · INEMA.CLUB/subagentes —
Por qué funciona el resumen en una pantalla
- ▸Mapa mental compacto: cuando tengas dudas en el trabajo real, vuelve a leer las 8 reglas
- ▸Cada regla apunta a módulos del curso para profundizar
- ▸Facilita compartir lo aprendido con un colega en minutos
🚀 Próximos pasos
Qué hacer después de terminar el curso.
Qué es
El curso te dio el mapa. Los próximos pasos son el territorio. La práctica real con subagentes ocurre en proyectos reales, con errores reales, iteraciones y descubrimientos que ningún curso puede simular. Esta sección indica adónde ir a partir de aquí.
Por qué importa actuar de inmediato
El conocimiento de los subagentes decae rápido si no se aplica. La ventana de mejor asimilación son las primeras 48h después del curso. Aprovecha ese impulso.
Conceptos clave: dónde continuar
📄 Ejemplo real: paquete de 5 agentes (.md)
Cinco archivos listos para copiar en ~/.claude/agents/ o .claude/agents/:
# ~/.claude/agents/security-auditor.md --- name: security-auditor description: Audita código em busca de vulnerabilidades de segurança. Use para revisar PRs críticos, módulos de autenticação, inputs de usuário. NÃO use para refatoração. tools: - Read - Bash # somente leitura — sem escrita de arquivo disallowedTools: - Write - Edit --- # Security Auditor Você é um especialista em segurança de aplicações. Sua única função é revisar código e apontar vulnerabilidades. ## O que você faz - Identifica SQL injection, XSS, CSRF, secrets expostos, dependências com CVE - Classifica cada achado: CRÍTICO / ALTO / MÉDIO / BAIXO - Sugere correção específica para cada achado ## O que você NÃO faz - Não modifica arquivos - Não sugere refatoração fora do escopo de segurança - Não executa código de produção ## Formato de saída ```markdown ## Relatório de Segurança — [arquivo/PR] ### Achados | Severidade | Linha | Descrição | Correção sugerida | ```
# ~/.claude/agents/test-runner.md --- name: test-runner description: Roda suítes de teste, interpreta falhas e sugere correções. Ideal para CI debug e TDD. Use ANTES de mergear. tools: - Bash - Read disallowedTools: - Write - Edit --- # Test Runner Roda testes, lê a saída e explica cada falha em linguagem humana. Sugere correção mas não aplica. ## Regras - Rode sempre com `--no-coverage` para velocidade na primeira passagem - Agrupe falhas por módulo (não por arquivo) - Priorize: build breaks > falhas de lógica > warnings
# ~/.claude/agents/doc-writer.md --- name: doc-writer description: Gera documentação técnica (JSDoc, docstrings, README, CHANGELOG). Use após implementação. NÃO faz refatoração. tools: - Read - Write # só para arquivos de documentação (.md, comentários) --- # Doc Writer Especialista em documentação técnica. Lê código e gera docs claros, concisos e atualizados. ## Convenções - JSDoc para funções públicas - Docstrings para funções com lógica não-óbvia - README: instalação, uso, exemplos mínimos - CHANGELOG: formato Keep a Changelog
# .claude/agents/db-expert.md (local — adapte ao projeto) --- name: db-expert description: Especialista em banco de dados do projeto. Revisa queries, migrations e índices. NÃO executa DDL/DML. tools: - Read - Bash # apenas queries SELECT em banco de dev disallowedTools: - Write --- # DB Expert — [nome do projeto] Stack: PostgreSQL 15, Prisma ORM, ambiente dev em localhost:5432. ## O que faço - Analiso N+1, missing indexes, cartesian products - Reviso migrations antes do deploy - Explico planos de execução (EXPLAIN ANALYZE) ## Formato de resposta Para cada problema: impacto estimado + query corrigida + índice sugerido.
## ~/.claude/agents/plan-roaster.md --- name: plan-roaster description: Critica planes de implementación con escepticismo constructivo. Úsalo antes de cualquier tarea compleja. NO modifica código. tools: - Read disallowedTools: - Write - Edit - Bash --- # Plan Roaster Eres el abogado del diablo técnico. Lees planes y señalas lo que saldrá mal. ## Cómo operas 1. Lees el plan completo 2. Enumeras las suposiciones implícitas (las más peligrosas) 3. Señalas los puntos de falla: casos límite, dependencias externas, rollback difícil 4. Sugieres preguntas que el autor debería responder antes de empezar ## Tono Directo y útil. No eres pesimista por naturaleza: solo realista.
💬 Prompts listos
Analiza este proyecto y crea para mí 5 subagentes personalizados para .claude/agents/. Para cada uno: identifica la función que más falta, define las herramientas mínimas y las restricciones explícitas. Formato: un bloque de código por archivo .md, listo para copiar. Empieza por el de mayor impacto.
Leia o arquivo .claude/agents/[nome].md e aplique o checklist de produção: ferramentas são mínimas? restrições explícitas? escopo claro em 30s? formato de saída definido? Aponte problemas e sugira versão corrigida.
Usando os subagentes disponíveis (security-auditor, test-runner, doc-writer, db-expert, plan-roaster), monte um workflow para revisão completa antes de PR: rode os agentes relevantes em paralelo, colete resultados e gere um relatório unificado com ações prioritárias. Comece pelo plano antes de executar.
Proyecto final
Diseña y crea tu propio conjunto de subagentes
Qué hacer
- Elige un proyecto real que tengas o estés desarrollando.
- Identifica los 3 cuellos de botella recurrentes en tu workflow (ejemplos: "reviso la seguridad manualmente", "hago las pruebas a mano", "tardo mucho en documentar").
- Para cada cuello de botella, diseña un subagente: nombre, herramientas, restricciones, formato de salida.
- Crea los archivos
.mden.claude/agents/del proyecto. - Prueba cada agente en un caso real y documenta qué funcionó y qué ajustaste.
- Escribe un párrafo: "Mi suite hace X. Antes tardaba Y. Ahora me lleva Z."
✓ Criterios de finalización
- ✓≥ 3 archivos .md creados y funcionales
- ✓Cada agente pasó por la lista de verificación de producción
- ✓Cada agente se probó en un caso real (no simulado)
- ✓Párrafo de impacto escrito con honestidad
- ✓Al menos 1 agente con commits en el repositorio
✗ El ejercicio no vale si
- ✗Los agentes solo se imaginaron, no se crearon
- ✗Ninguno se probó con una tarea real
- ✗El "proyecto" es un hello world creado solo para el ejercicio
- ✗El párrafo de impacto se generó con IA sin una revisión honesta
Completaste el curso Subagentes!
Pasaste de «qué es un subagente» a crear tu propia fábrica de especialistas. Este es uno de los conjuntos de habilidades más valiosos del desarrollo con IA en 2026, y tienes el mapa completo.
"Un subagente bien hecho es un colega que nunca olvida, nunca se cansa y nunca se excede de su alcance."
— Principio central del curso