3 archivos de rol para ayudantes de IA: investigador, redactor y revisor

Aquí tienes los tres archivos de rol que pediste. Cada uno es un archivo de texto corto con una sola tarea. En Claude Code, guárdalos en .claude/agents/. En otras herramientas, pega el rol al inicio de un chat nuevo o en un asistente personalizado.

researcher.md

---
name: researcher
description: Investiga una pregunta en la web y devuelve un resumen corto con fuentes. Lanza varios en paralelo para comparar opciones.
---
Investigas una sola pregunta. Lee CLAUDE.md primero.
- Prefiere páginas oficiales y fuentes primarias. Da la URL de cada dato.
- Marca como "sin verificar" lo que no pudiste comprobar. Nunca inventes cifras.
- No inicies sesión en ningún sitio, no llenes formularios, no descargues archivos.
Devuelve: máximo 150 palabras: la respuesta, los 3 datos más importantes con fuente y lo que aún no se sabe.

writer.md

---
name: writer
description: Escribe un primer borrador (correo, publicación, página) con mi voz a partir de una instrucción corta.
---
Escribes primeros borradores. Lee CLAUDE.md y memory/INDEX.md primero; sigue mis notas de tono.
- No hagas preguntas; si a la instrucción le falta algo, escribe [corchetes] donde va.
- Hazlo más corto de lo que crees. Empieza por lo importante.
- Nada de afirmaciones ni cifras que no estén en la instrucción.
Devuelve: el borrador y, después, una línea con todo lo que dejaste entre [corchetes].

checker.md

---
name: checker
description: Revisa un borrador según mis reglas antes de enviarlo. Úsalo para correos, publicaciones y documentos.
---
Revisas borradores. Lee CLAUDE.md primero.
Para cada borrador:
1. ¿Sigue "Cómo responder" y "Nunca"?
2. ¿Todas las cifras y nombres tienen una fuente en el borrador?
3. ¿Hay algo que suene a promesa que no podemos cumplir?
Responde con: OK, o una lista de correcciones (una línea cada una). No reescribas el borrador.

Qué es un ayudante y cuándo vale la pena

Un ayudante es un asistente aparte con una sola tarea, que te devuelve un resultado corto. Un solo asistente que hace todo en un chat larguísimo se vuelve lento y confuso. Dividir el trabajo lo arregla en tres situaciones:

• Investigación en paralelo. Tres ayudantes miran una opción cada uno; recibes tres resúmenes cortos en vez de un hilo enredado.
• Escribir y luego revisar. El revisor no vio el razonamiento del redactor, así que detecta errores que el redactor se justificó a sí mismo.
• Trabajo repetitivo. La misma tarea para diez elementos, cada uno resuelto por separado y bien.

Si es una consulta rápida, no te compliques. Pregúntale al asistente principal.

Dale instrucciones a un ayudante como a un colega nuevo

Un ayudante solo sabe lo que tú le cuentas. Usa esta plantilla:

Objetivo: [una frase]
Ya sabido / descartado: [para que no repita lo que ya hiciste]
Dónde buscar: [archivos, sitios]
Devuelve: [qué y cuánto, por ejemplo "un resumen de 150 palabras"]

Ejemplo:

Objetivo: Encontrar tres herramientas de gestión de proyectos de menos de 20 dólares por usuario al mes.
Ya sabido / descartado: Ya probé Trello y no me gusta.
Dónde buscar: la página oficial de precios de cada herramienta.
Devuelve: una comparación de 150 palabras con el enlace a la página de precios de cada una.

El error más común es una instrucción de una sola línea como "investiga herramientas de proyectos". El ayudante adivina y te llega la respuesta a una pregunta que no hiciste.

Gasta menos

Los ayudantes gastan tus créditos o tu límite de uso rápido, porque cada uno abre su propia conversación. Tres reglas:

1. Usa ayudantes solo para trabajo paralelo o independiente. No para algo que resuelves con un mensaje.
2. Elige un modelo más pequeño y barato para investigar y revisar. Deja el modelo más potente para decidir y para la redacción final.
3. Pon un tope. Agrega esta línea a tu archivo de reglas: "Máximo 3 ayudantes a la vez; avísame antes de usar más."

Errores comunes

• Contarle toda tu vida a un ayudante. Un archivo de rol debe tener diez líneas, no un perfil. Remítelo a CLAUDE.md para el resto.
• Dejar que el revisor reescriba. Debe listar correcciones, no producir un segundo borrador. Si no, no ves qué cambió.
• Confiar en una investigación sin fuentes. El archivo del investigador exige una URL por cada dato. Abre una o dos antes de apoyarte en ellas.
• Darles permiso para enviar o comprar. Los ayudantes devuelven resultados. Tú decides qué pasa después.

Pruébalo

Toma un correo que normalmente enviarías. Pídele al redactor un borrador con una instrucción de tres líneas y luego pásale el borrador al revisor. Si el revisor no encuentra nada, prueba con un borrador que tenga una cifra inventada y confirma que la marque.

Los ayudantes son una de las cinco partes del sistema. El archivo de reglas, las notas de memoria, las carpetas de proyecto y el resumen matutino están en la guía completa, con todas las plantillas listas para copiar.

← Todos los artículos