AgentTeam

AgentTeam es un equipo de desarrollo de software de IA reutilizable construido sobre el Protocolo de Contexto de Modelos (MCP). Trece agentes especializados — Gestor de Producto, Gestor de Proyectos, Investigador de UX, Diseñador UX/UI, Frontend, Backend, Full-Stack, Móvil, DevOps, QA, Seguridad, Ingeniero de Datos y Científico de Datos — colaboran en proyectos de software a través de una base de datos SQLite compartida, cada uno limitado estrictamente a su rol.

El Gestor de Proyectos orquesta: crea el proyecto, recluta a los especialistas que necesita, divide el trabajo en tareas y devuelve un manifiesto de despacho — un array JSON que la sesión que realiza la llamada utiliza para generar cada especialista como un agente paralelo independiente. Los especialistas leen el resumen del proyecto al unirse, registran su trabajo y decisiones a medida que avanzan, y comparten artefactos de investigación estructurados para que ningún agente vuelva a investigar lo que otro ya ha encontrado.

Todo el estado del proyecto se persiste en SQLite (44 herramientas MCP en 12 dominios: proyectos, resúmenes, miembros del equipo, tareas, entradas de trabajo, comentarios de tareas, discusiones, decisiones, artefactos y un diario de usuario). Los proyectos tienen un ámbito UUID y una gestión del ciclo de vida (activo → pausado → archivado → cerrado), por lo que los equipos pueden pausar y reanudar el trabajo entre sesiones sin perder el contexto.

Diseñado para ser llamado desde cualquier proyecto de Claude Code a través de MCP — apunta tu claude_desktop_config.json al servidor y cualquier proyecto podrá poner en marcha un equipo completo.

Diario de usuario

A medida que el equipo trabaja, el Gestor de Proyectos captura tus decisiones, preferencias y razonamientos de la conversación en un diario de usuario persistente — cosas como dispositivos considerados y rechazados, restricciones de costes, preferencias de formato e intenciones de próximos pasos. Estos se almacenan como entradas estructuradas vinculadas al proyecto (o globalmente, para preferencias entre proyectos) y se revisan al finalizar para que no se pierda nada importante entre sesiones. El diario se puede consultar a través de list_journal_entries para que los futuros agentes puedan leer lo que establecieron las conversaciones pasadas antes de comenzar un nuevo trabajo.

Estructura del proyecto

AgentTeam/
├── agents/               # Agent prompt files — one per role
│   ├── _base-protocol.md # Shared team protocol, constraints, efficiency rules
│   ├── project-manager.md
│   ├── product-manager.md
│   ├── backend-developer.md
│   └── ...
├── mcp-server/           # TypeScript MCP server
│   └── src/
│       ├── index.ts      # Server entry — all 44 tools registered
│       ├── db/
│       │   ├── schema.ts # Table definitions and migrations
│       │   └── connection.ts
│       └── tools/        # One file per domain
└── docs/                 # Design specs and reference guides

Related MCP server: Sprintra

Dominios de herramientas MCP

Primeros pasos

1. Instalar el servidor MCP

Un comando (recomendado):

claude mcp add agent-team -- npx agent-team-mcp

Eso es todo. Claude Code iniciará el servidor automáticamente y la habilidad /team se instalará globalmente en la primera ejecución.

O edita manualmente tu configuración MCP (~/.claude/settings.json o el .claude/settings.json del proyecto):

{
  "mcpServers": {
    "agent-team": {
      "command": "npx",
      "args": ["agent-team-mcp"]
    }
  }
}

O desde un clon local:

git clone https://github.com/RichardLemmon/AgentTeam.git
cd AgentTeam/mcp-server
npm install
npm run build
claude mcp add agent-team -- node /path/to/AgentTeam/mcp-server/dist/index.js

Arquitectura eficiente en tokens

Los archivos de instrucciones de los agentes contienen solo la sección de Identidad específica del rol (~100 palabras cada uno). El protocolo compartido del equipo, las restricciones y las reglas de eficiencia residen en un único archivo agents/_base-protocol.md, servido bajo demanda a través de la herramienta MCP get_team_protocol. Este enfoque de carga diferida ahorra ~6,000 palabras de contexto al generar un equipo completo en comparación con duplicar el protocolo en cada archivo de agente. El esquema JSON de los artefactos está incrustado en la descripción de la herramienta share_artifact para que los agentes lo descubran desde la propia herramienta.

2. Úsalo

La habilidad /team se instala automáticamente en ~/.claude/skills/agent-team/ al iniciar el servidor por primera vez. Solo escribe:

/team build me a REST API for task management

O usa /team sin argumentos para ver tus proyectos existentes y elegir uno en el que trabajar.

Inicio rápido

Con la habilidad /team (Claude Code):

/team build me a REST API for task management

Sin la habilidad:

"Pon en marcha al Gestor de Proyectos y pídele que investigue [tema]"

Gestionar proyectos:

/team --projects              # list all projects
/team --projects active       # filter by status
/team --projects delete <name> # delete a project

Cómo funciona

1. El PM configura el proyecto — crea el registro del proyecto, recluta a los especialistas que necesita, crea tareas, escribe el resumen del proyecto y devuelve un manifiesto de despacho.

2. La sesión de llamada genera especialistas — cada especialista en el manifiesto se lanza como un agente independiente con su project_id y member_id.

3. Los especialistas trabajan en paralelo — cada uno lee el resumen del proyecto, registra entradas de trabajo, comparte artefactos y se comunica a través de comentarios de tareas y discusiones.

4. El estado persiste entre sesiones — cualquier agente puede volver a unirse a un proyecto leyendo el resumen actual y retomando donde el equipo lo dejó.

5. El PM cierra el proyecto — al finalizar, el PM escribe un resumen de cierre y registra las decisiones y preferencias clave del usuario en el diario para futuras referencias.