¿Qué son los Agentes de Agencia?

La Agencia es una colección de código abierto de 147 agentes de IA especializados para Claude Code, Cursor, Aider, Windsurf, GitHub Copilot y más. Cada agente tiene una personalidad distintiva, entregables técnicos y métricas de éxito. Esta inmersión técnica profunda cubre la arquitectura de los agentes, la integración de múltiples herramientas, la memoria MCP y los scripts bash que lo hacen funcionar.

Probablemente ya conozcas la rutina: "Actúa como un desarrollador sénior" seguido de consejos genéricos que podrían aplicarse a cualquier tarea de codificación. La Agencia adopta un enfoque diferente. En lugar de un solo prompt que intenta hacerlo todo, ofrece 147 especialistas organizados en 12 divisiones.

Piensa en ello como si estuvieras armando una agencia de servicios completos, excepto que son agentes de IA que nunca duermen, nunca se quejan y siempre cumplen.

¿Qué es La Agencia?

La versión corta: La Agencia reemplaza "Actúa como desarrollador" por "Activar modo de Desarrollador Frontend" — y el agente Desarrollador Frontend realmente conoce React, Vue, Angular, Core Web Vitals y cumplimiento de accesibilidad.

Estructura del Repositorio: 12 Divisiones, 147 Agentes

La Agencia se encuentra en github.com/msitarzewski/agency-agents. Los agentes están organizados en 12 divisiones que reflejan un organigrama de agencia real:

agency-agents/
├── engineering/          # Más de 20 agentes: Frontend, Backend, DevOps, IA, Móvil, Seguridad
├── design/               # 8 agentes: Diseñador de UI, Investigador de UX, Guardián de Marca, Inyector de Caprichos
├── marketing/            # Más de 20 agentes: Growth Hacker, SEO, TikTok, Reddit, LinkedIn
├── sales/                # 8 agentes: Coach de Descubrimiento, Estratega de Negociaciones, Ingeniero de Ventas
├── product/              # 5 agentes: Product Manager, Investigador de Tendencias, Sintetizador de Feedback
├── project-management/   # 6 agentes: Productor de Estudio, Pastor de Proyectos, Rastreador de Experimentos
├── testing/              # 8 agentes: Verificador de Realidad, Recolector de Evidencia, Probador de API
├── support/              # 6 agentes: Responsable de Soporte, Reportero de Analíticas, Cumplimiento Legal
├── spatial-computing/    # 6 agentes: Arquitecto XR, Ingeniero visionOS, Desarrollador Metal
├── specialized/          # Más de 30 agentes: Constructor MCP, Auditor de Blockchain, Auditor de Cumplimiento
├── game-development/     # Más de 20 agentes: Arquitecto Unity, Sistemas Unreal, Scripter Godot, Roblox
└── academic/             # 5 agentes: Antropólogo, Historiador, Psicólogo, Narratólogo

Cada división contiene agentes con profunda experiencia. La división de Ingeniería por sí sola abarca Desarrolladores Frontend, Arquitectos Backend, Automatizadores DevOps, Ingenieros de Seguridad e incluso Ingenieros de Firmware Embebido.

Anatomía del Agente: Dentro de un Especialista de IA de 400 Líneas

Cada agente sigue la misma estructura. Aquí está el desglose usando el agente Arquitecto de Backend como ejemplo:

Frontmatter (YAML)

---
name: Backend Architect
description: Senior backend architect specializing in scalable system design, database architecture, API development, and cloud infrastructure
color: blue
emoji: 🏗️
vibe: Designs the systems that hold everything up — databases, APIs, cloud, scale.
---

Estos metadatos no son decorativos. Herramientas como Cursor y Claude Code utilizan los campos name y description para el descubrimiento de agentes. El emoji proporciona identificación visual en las interfaces de chat.

Identidad y Memoria

## 🧠 Tu Identidad y Memoria
- **Rol**: Especialista en arquitectura de sistemas y desarrollo del lado del servidor
- **Personalidad**: Estratégico, enfocado en la seguridad, mentalidad de escalabilidad, obsesionado con la fiabilidad
- **Memoria**: Recuerdas patrones de arquitectura exitosos, optimizaciones de rendimiento y frameworks de seguridad
- **Experiencia**: Has visto sistemas tener éxito a través de una arquitectura adecuada y fallar por atajos técnicos

Esta sección establece la persona del agente y los límites de su experiencia. No es solo texto de relleno, sino que prepara al LLM para adoptar una mentalidad específica.

Misión Principal

## 🎯 Tu Misión Principal

### Excelencia en Ingeniería de Datos/Esquemas
- Definir y mantener esquemas de datos y especificaciones de índices
- Diseñar estructuras de datos eficientes para conjuntos de datos a gran escala (más de 100k entidades)
- Implementar pipelines ETL para la transformación y unificación de datos
- Crear capas de persistencia de alto rendimiento con tiempos de consulta inferiores a 20 ms

Cada elemento de la misión incluye objetivos medibles. Nótese "tiempos de consulta inferiores a 20 ms" y "más de 100k entidades"; estos no son objetivos vagos.

Reglas Críticas

## 🚨 Reglas Críticas que Debes Seguir

### Arquitectura Primero la Seguridad
- Implementar estrategias de defensa en profundidad en todas las capas del sistema
- Usar el principio de mínimo privilegio para todos los servicios y acceso a la base de datos
- Cifrar datos en reposo y en tránsito utilizando los estándares de seguridad actuales

Las reglas son restricciones no negociables. Anulan el comportamiento general del LLM.

Entregables Técnicos

Aquí es donde los agentes se diferencian de los prompts genéricos. El Arquitecto de Backend proporciona código completo y ejecutable:

-- Diseño de Esquema de Base de Datos para E-commerce
CREATE TABLE users (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    email VARCHAR(255) UNIQUE NOT NULL,
    password_hash VARCHAR(255) NOT NULL,
    created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
    updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
    deleted_at TIMESTAMP WITH TIME ZONE NULL
);

CREATE INDEX idx_users_email ON users(email) WHERE deleted_at IS NULL;
CREATE INDEX idx_users_created_at ON users(created_at);

// API Express.js con middleware de seguridad
const helmet = require('helmet');
const rateLimit = require('express-rate-limit');

const limiter = rateLimit({
  windowMs: 15 * 60 * 1000,
  max: 100,
  message: 'Demasiadas solicitudes desde esta IP, inténtalo de nuevo más tarde.',
});

Métricas de Éxito

## 🎯 Tus Métricas de Éxito

Tendrás éxito cuando:
- Los tiempos de respuesta de la API se mantengan por debajo de 200ms para el percentil 95
- El tiempo de actividad del sistema supere el 99.9% de disponibilidad
- Las consultas a la base de datos se ejecuten en un promedio de menos de 100ms
- Las auditorías de seguridad no encuentren vulnerabilidades críticas

Cada agente define resultados medibles. Esto no es una afirmación de terapia, es responsabilidad de ingeniería.

Integración Multi-Herramienta: Un Agente, 10 IDEs

La Agencia funciona en más de 10 herramientas de codificación de IA. Así es como funciona la capa de integración:

Herramientas Compatibles

El Script de Conversión (convert.sh)

El script bash scripts/convert.sh maneja la traducción de formatos. Aquí está la arquitectura:

#!/usr/bin/env bash
# convert.sh — Convierte archivos .md de agentes de agencia a formatos específicos de herramienta

set -euo pipefail

AGENT_DIRS=(
  academic design engineering game-development marketing paid-media
  sales product project-management testing support spatial-computing specialized
)

# Extrae campos de frontmatter
get_field() {
  local field="$1" file="$2"
  awk -v f="$field" '
    /^---$/ { fm++; next }
    fm == 1 && $0 ~ "^" f ": " { sub("^" f ": ", ""); print; exit }
  ' "$file"
}

# Elimina el frontmatter, devuelve el cuerpo
get_body() {
  awk 'BEGIN{fm=0} /^---$/{fm++; next} fm>=2{print}' "$1"
}

Para Cursor, el script convierte los archivos .md al formato de reglas .mdc:

convert_cursor() {
  local agent_file="$1"
  local slug=$(to_kebab "$(get_field 'name' "$agent_file")")
  local output_file="$OUT_DIR/cursor/.cursor/rules/agency-${slug}.mdc"

  cat > "$output_file" << EOF
---
description: Agente de la agencia: $(get_field 'description' "$agent_file")
---
$(get_body "$agent_file")
EOF
}

Para Aider y Windsurf, todos los agentes se compilan en un único archivo:

convert_aider() {
  local output="$OUT_DIR/aider/CONVENTIONS.md"
  echo "# Agentes de la Agencia para Aider" > "$output"
  echo "" >> "$output"

  for dir in "${AGENT_DIRS[@]}"; do
    for file in "$REPO_ROOT/$dir"/*.md; do
      echo "---" >> "$output"
      cat "$file" >> "$output"
    done
  done
}

El Script de Instalación (install.sh)

Después de la conversión, install.sh copia los archivos a directorios específicos de la herramienta:

#!/usr/bin/env bash
# install.sh — Instala los agentes de La Agencia en tu(s) herramienta(s) agentiva(s) local(es)

install_claude_code() {
  local src="$REPO_ROOT"
  local dest="$HOME/.claude/agents"
  mkdir -p "$dest"
  cp -r "$src"/{engineering,design,marketing,sales,specialized}/*.md "$dest/"
  ok "Claude Code: $(find "$dest" -name '*.md' | wc -l) agentes instalados"
}

install_cursor() {
  local src="$OUT_DIR/cursor/.cursor/rules"
  local dest="./.cursor/rules"
  mkdir -p "$dest"
  cp "$src"/*.mdc "$dest/"
  ok "Cursor: $(find "$dest" -name '*.mdc' | wc -l) reglas instaladas"
}

El script admite la selección interactiva:

  +------------------------------------------------+
  |   La Agencia — Instalador de Herramientas      |
  +------------------------------------------------+

  Escaneo del sistema: [*] = detectado en esta máquina

  [x]  1)  [*]  Claude Code     (claude.ai/code)
  [x]  2)  [*]  Copilot         (~/.github + ~/.copilot)
  [x]  3)  [*]  Antigravity     (~/.gemini/antigravity)
  [ ]  4)  [ ]  Gemini CLI      (extensión gemini)
  [x]  7)  [*]  Cursor          (.cursor/rules)

  [1-10] alternar   [a] todos   [n] ninguno   [d] detectados
  [Enter] instalar   [q] salir

La ejecución paralela acelera las instalaciones multi-herramienta:

./scripts/install.sh --parallel --jobs 8

Memoria MCP: Contexto Persistente entre Sesiones

Por defecto, los agentes de IA inician cada sesión desde cero. La integración de la Memoria MCP cambia eso.

¿Qué es MCP?

MCP (Model Context Protocol) es un protocolo para que los agentes de IA accedan a herramientas externas y almacenamiento persistente. La Agencia utiliza MCP para habilitar:

• Memoria entre sesiones: Los agentes recuerdan decisiones de sesiones anteriores
• Traspaso de agentes: Un agente puede dejar contexto para otro
• Reversión en caso de fallo: Restaurar a estados conocidos y buenos cuando la QA falla

El Patrón de Memoria

Agrega esta sección a cualquier agente para habilitar la memoria MCP:

## Integración de Memoria

Cuando inicies una sesión:
- Recuerda el contexto relevante de sesiones anteriores usando tu rol y proyecto como términos de búsqueda
- Revisa cualquier memoria etiquetada con el nombre de tu agente

Cuando tomes decisiones clave o completes entregables:
- Recuerda la decisión con etiquetas descriptivas (nombre del agente, proyecto, tema)
- Incluye suficiente contexto para que una sesión futura pueda entender lo que se hizo y por qué

Cuando traspases a otro agente:
- Recuerda tus entregables etiquetados para el agente receptor
- Incluye: lo que completaste, lo que está pendiente, lo que el siguiente agente necesita saber

Herramientas MCP

Cualquier servidor MCP que exponga estas herramientas funciona:

Ejemplo: Flujo de Trabajo Impulsado por la Memoria

Sin memoria MCP:

Usuario: "Construye la API"
Agente: [Construye la API, termina la sesión]

[Siguiente sesión]
Usuario: "Continúa desde ayer"
Agente: "No tengo contexto de sesiones anteriores. ¿Puedes pegar lo que hicimos?"

Con memoria MCP:

Usuario: "Construye la API"
Agente: [Construye la API, recuerda: "Arquitecto Backend - API de E-commerce - Tabla de usuarios, autenticación JWT, limitación de tasa"]

[Siguiente sesión]
Usuario: "Continúa desde ayer"
Agente: [Recuerda: "Ayer diseñé la tabla de usuarios con claves primarias UUID, implementé autenticación JWT con hashing bcrypt y agregué limitación de tasa de 100 solicitudes cada 15 minutos. Siguiente paso: esquema del Servicio de Pedidos."]

Consulta integrations/mcp-memory/backend-architect-with-memory.md para un ejemplo completo.

Agentes Destacados: Tres Inmersiones Profundas

1. Verificador de Realidad (División de Pruebas)

El Verificador de Realidad detiene las aprobaciones de fantasía. Postura por defecto: "NECESITA TRABAJO" hasta que se demuestre lo contrario.

## 🚨 Tu Proceso Obligatorio

### PASO 1: Comandos de Verificación de Realidad (NUNCA OMITIR)
```bash
# Verifica lo que realmente se construyó
ls -la resources/views/ || ls -la *.html

# Comprueba las características reclamadas
grep -r "luxury\|premium\|glass\|morphism" . --include="*.html" --include="*.css" || echo "NO SE ENCONTRARON CARACTERÍSTICAS PREMIUM"

# Ejecuta la captura de pantalla profesional de Playwright
./qa-playwright-capture.sh http://localhost:8000 public/qa-screenshots

PASO 2: Validación Cruzada de QA

• Revisa los hallazgos del agente de QA de las pruebas de Chrome sin interfaz gráfica
• Compara las capturas de pantalla automatizadas con la evaluación de QA
• Confirma o desafía la evaluación de QA con evidencia adicional

PASO 3: Validación de Extremo a Extremo

• Analiza responsive-desktop.png, responsive-tablet.png, responsive-mobile.png
• Comprueba los flujos de interacción: secuencias nav--click.png, form-.png
• Revisa los datos de rendimiento reales (tiempos de carga, errores, métricas)

Este agente requiere **prueba visual** antes de aprobar cualquier cosa. Se acabó el "¡Se ve genial!" sin evidencia.

---

### 2. Inyector de Caprichos (División de Diseño)

El Inyector de Caprichos añade personalidad sin sacrificar la usabilidad.

```css
/* Interacciones de Botones Encantadoras */
.btn-whimsy {
  position: relative;
  overflow: hidden;
  transition: all 0.3s cubic-bezier(0.23, 1, 0.32, 1);

  &::before {
    content: '';
    position: absolute;
    top: 0;
    left: -100%;
    width: 100%;
    height: 100%;
    background: linear-gradient(90deg, transparent, rgba(255, 255, 255, 0.2), transparent);
    transition: left 0.5s;
  }

  &:hover {
    transform: translateY(-2px) scale(1.02);
    box-shadow: 0 8px 25px rgba(0, 0, 0, 0.15);
  }
}

// Sistema de Logros con Capricho
class WhimsyAchievements {
  unlock(achievementId) {
    const achievement = this.achievements[achievementId];
    this.showCelebration(achievement);
    this.saveProgress(achievementId);
  }

  showCelebration(achievement) {
    const celebration = document.createElement('div');
    celebration.className = `achievement-celebration ${achievement.celebration}`;
    celebration.innerHTML = `
      <div class="achievement-card">
        <div class="achievement-icon">${achievement.icon}</div>
        <h3>${achievement.title}</h3>
        <p>${achievement.description}</p>
      </div>
    `;
    document.body.appendChild(celebration);
    setTimeout(() => celebration.remove(), 3000);
  }
}

Cada elemento juguetón debe servir a un propósito funcional o emocional. El agente incluye una biblioteca completa de micro-textos:

## Mensajes de Error
**Página 404**: "¡Oops! Esta página se fue de vacaciones sin avisarnos."
**Validación de Formulario**: "Tu correo electrónico parece un poco tímido, ¿te importa añadir el símbolo @?"
**Error de Red**: "Parece que internet tuvo un hipo. ¿Lo intentamos de nuevo?"

3. Constructor MCP (División Especializada)

El Constructor MCP crea herramientas personalizadas que extienden las capacidades de los agentes de IA.

// Esqueleto de servidor MCP en TypeScript
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

const server = new McpServer({ name: "my-server", version: "1.0.0" });

server.tool("search_items", { query: z.string(), limit: z.number().optional() },
  async ({ query, limit = 10 }) => {
    const results = await searchDatabase(query, limit);
    return { content: [{ type: "text", text: JSON.stringify(results, null, 2) }] };
  }
);

const transport = new StdioServerTransport();
await server.connect(transport);

Reglas críticas:

• Nombres de herramientas descriptivos: search_users, no query1 — los agentes seleccionan herramientas por nombre
• Parámetros tipados con Zod: Cada entrada validada, los parámetros opcionales tienen valores predeterminados
• Salida estructurada: Devuelve JSON para datos, markdown para contenido legible por humanos
• Manejo de errores con elegancia: Devuelve mensajes de error, nunca bloquees el servidor

Comunidad y Traducciones

La Agencia comenzó a partir de un hilo de Reddit. Ahora tiene:

• 147 agentes en 12 divisiones
• Más de 10,000 líneas de personalidad, proceso y ejemplos de código
• Traducciones de la comunidad: Chino simplificado (dos forks independientes), con más en progreso
• Soporte multi-herramienta: Más de 10 integraciones mantenidas a través de scripts de conversión

Forks notables:

• agency-agents-zh por @jnMetaCode: 100 agentes traducidos + 9 originales para el mercado chino
• agent-teams por @dsclca12: Traducción independiente con localización para Bilibili, WeChat, Xiaohongshu

Instalación: Inicio Rápido

Opción 1: Claude Code (Recomendado)

# Copia los agentes a tu directorio de Claude Code
cp -r agency-agents/* ~/.claude/agents/

# Actívalo en cualquier sesión:
"Hey Claude, activa el modo Desarrollador Frontend y ayúdame a construir un componente React"

Opción 2: Instalación Multi-Herramienta

# Paso 1: Genera los archivos de integración
./scripts/convert.sh

# Paso 2: Instala interactivamente (detecta herramientas automáticamente)
./scripts/install.sh

# O instala una herramienta específica directamente
./scripts/install.sh --tool cursor
./scripts/install.sh --tool aider

Opción 3: Usar como Referencia

Navega por los agentes en github.com/msitarzewski/agency-agents y adapta los que necesites. Cada archivo contiene identidad, flujos de trabajo, entregables y ejemplos de código.

¿Qué lo Hace Diferente?

vs. Prompts Genéricos de IA

vs. Bibliotecas de Prompts

vs. Herramientas de IA

Conclusiones Técnicas

1. La especialización supera la generalización: 147 especialistas superan a un prompt "hazlo todo"
2. La estructura impulsa la producción: Frontmatter + Identidad + Misión + Reglas + Entregables + Métricas
3. La integración es importante: Los scripts Bash convierten agentes a más de 10 formatos automáticamente
4. La memoria permite la continuidad: El protocolo MCP resuelve el problema de "no recuerdo lo de ayer"
5. La comunidad escala: Hilo de Reddit → 147 agentes → traducciones → soporte multi-herramienta

Próximos Pasos

¿Quieres probar La Agencia?

1. Explora la lista completa de agentes
2. Instala para tu herramienta preferida (Claude Code, Cursor, Aider, etc.)
3. Activa especialistas por nombre: "Usa el Verificador de Realidad para verificar que esto esté listo para producción"
4. Contribuye: Agrega nuevos agentes, mejora los existentes, comparte historias de éxito

¿Estás construyendo agentes de IA tú mismo? Estudia la anatomía del agente: frontmatter para el descubrimiento, identidad para la personalidad, misión para el alcance, reglas para las restricciones, entregables para la salida, métricas para la rendición de cuentas.

La Agencia demuestra que la especialización no es solo para humanos. A veces, el mejor equipo de IA no es un solo modelo que intenta hacerlo todo, sino 147 especialistas que saben exactamente lo que se supone que deben hacer.