Arquitectura de Agentes

Cómo está construido, por dentro, el sistema que usa ZENDAY.

El organigrama muestra los roles. Esta página muestra cómo esos roles existen realmente: como agentes configurados dentro de un proyecto de Claude Code, cada uno con sus propias herramientas y permisos.

6 de 6 agentes cargados
Basado en AG-001 a AG-006 · EST-002
Corre sobre Claude Code

Antes de los tecnicismos

¿Qué es "un agente", en criollo?

Idea simple

Un asistente con un solo trabajo

Un agente es una configuración de IA a la que le asignamos una función específica — por ejemplo, "solo diseñás arquitectura técnica" — y un conjunto de herramientas para hacer ese trabajo, nada más.

Por qué no usar "una sola IA"

Separar responsabilidades

Así como en una empresa nadie espera que la misma persona venda, diseñe, programe y controle calidad, dividimos el trabajo en agentes especializados para que cada tarea reciba atención enfocada.

Dónde "viven"

Archivos dentro del proyecto

Cada agente es, técnicamente, un archivo de configuración guardado en la carpeta .claude/agents/ del proyecto zenday-studio. Se activan automáticamente al trabajar dentro de esa carpeta con Claude Code.

Mapa completo

SYS-ZOS-001 → Directora IA → 6 agentes operativos

Cada tarjeta incluye qué modelo de IA usa el agente, qué tan autónomo es, y qué herramientas tiene habilitadas.

AG-001

Directora IA

Autoridad estratégica — aprueba, prioriza y coordina a los 5 agentes operativos. Modelo: Opus · Autonomía: Autónomo · Herramientas: Read Write Grep Glob

AG-002
Arquitecto IA
SIZ
Diseña la arquitectura técnica de cada proyecto a partir del brief comercial.
HaceElige tecnologías · define componentes e integraciones · produce especificación técnica
ReadWriteGrepGlob
Modelo: Sonnet · Autonomía: Supervisado
AG-003
Esp. Comercial IA
SCS
Levanta requerimientos y arma el brief comercial de una oportunidad.
HaceCalifica oportunidades · estructura briefs · distingue hechos de hipótesis
ReadWriteGrepGlob
Modelo: Sonnet · Autonomía: Supervisado
AG-004
Esp. Implementación IA
SIZ
Construye la solución real a partir de la arquitectura ya aprobada.
HaceEscribe código · integra servicios externos · prepara la entrega para QA
ReadWriteEditBash
Modelo: Sonnet · Autonomía: Supervisado
AG-005
Esp. Documentación IA
SKS
Único agente autorizado a tocar el Índice Maestro y los documentos del framework.
HaceRedacta y versiona documentos · registra en el índice · evita duplicidad
ReadWriteEdit
Modelo: Sonnet · Autonomía: Supervisado
AG-006
Esp. QA IA
SCS
Valida que lo implementado cumpla el brief y la arquitectura antes de dar por cerrado.
HaceCompara contra el brief · corre pruebas · emite informe con recomendación
ReadBashGrepGlob
Modelo: Sonnet · Autonomía: Supervisado
AG-007 / AG-008
Growth & Finanzas IA
Roadmap
Próximas incorporaciones planeadas: crecimiento/adquisición y control financiero de proyectos.
HaríaPor definir — sin herramientas ni modelo asignado todavía
◌ Planeado

Flujo

Cómo se pasan la posta entre sí

El mismo recorrido del organigrama, visto como flujo técnico de un proyecto real.

01
Descubrimiento
AG-003
02
Aprobación
AG-001
03
Arquitectura
AG-002
04
Implementación
AG-004
05
Control de calidad
AG-006
06
Documentación final
AG-005
Glosario

Términos usados en esta página, sin vueltas

Modelo (Opus / Sonnet)

Es "qué tan potente y qué tan caro" es el cerebro de IA que usa cada agente. La Directora usa el más avanzado porque toma decisiones de mayor impacto; los agentes operativos usan uno más ágil para tareas del día a día.

Autonomía (Autónomo / Supervisado)

Define si el agente puede actuar solo hasta el final ("Autónomo") o si su trabajo necesita revisión humana antes de darse por cerrado ("Supervisado").

Herramientas (Read, Write, Edit, Bash, Grep, Glob)

Son las "acciones" que cada agente puede ejecutar: leer archivos, escribirlos, editarlos, correr comandos, o buscar contenido/archivos. Un agente solo tiene las herramientas que necesita para su función — nada más.

.claude/agents/

La carpeta del proyecto donde vive la configuración de cada agente. Es el "archivo de personal" del sistema: ahí se define cada rol antes de que pueda trabajar.

Volver al mapa general

¿Preferís la vista de roles?

El organigrama presenta lo mismo sin el detalle técnico de herramientas y modelos.

Ver organigrama