Saltar a contenido

Sub-agentes

El orquestador (Claude Opus) jamás genera contenido. Delega a sub-agentes especializados que leen su prompt en .agent/prompts/, buscan contexto en Engram y devuelven resultados vía el bus Engram.

El protocolo del bus (5 pasos)

Cada sub-agente sigue obligatoriamente este protocolo:

PASO 1 (orquestador): mem_save("task: {agent} — {qué hacer}")
PASO 2 (orquestador): Agent(prompt corto < 30 líneas)
PASO 3 (sub-agente):  mem_search("task: {agent}") + lee archivos + trabaja
PASO 4 (sub-agente):  mem_save("result: {agent} — {resumen < 500 chars}")
PASO 5 (orquestador): mem_search("result: {agent}")

Anti-patrón prohibido

El orquestador NUNCA copia el contenido de un archivo en el prompt del sub-agente. El sub-agente lee sus propios archivos. Esto mantiene el contexto del orquestador limpio (10-15%).

El catálogo de sub-agentes

Pipeline de escritura (T1)

Agente Activa cuando
Verifier Cambio en modelos físicos, resultado numérico destinado al draft
Physical Critic Nueva carga / condición de borde / geometría modificada
Bibliography Agent Preparar refs, cambio de dominio
Figure Agent Generar figuras (IMPLEMENT B2 / FINALIZE)
Reviewer Simulator Draft pasa a review, pre-submission (Gates 0-2)
Defense Simulator Pre-submission, preparación de defensa oral
Ideation Dialogue Usuario sin tema claro, exploración socrática

Deep research + scaffolding (T1)

Agente Activa cuando
Citation LLM Verifier VERITAS pre-verification, sospecha de hallucination
Data Config Agent COMPUTE C1 con params del dominio en TODO
Domain Scaffolder Dominio nuevo detectado → auto-genera config + backend + skill
Patent Agent EXPLORE con PDFs de referencia, gap analysis

Comerciales (T2 — NEW FASE C)

Agente Rol
quotation_generator Cotizaciones para clientes
venue_router Ruteo de venue objetivo (Haiku, cost-optimized)
submission_tracker Tracking de submission (NO LLM, state machine)
client_feedback_coordinator Coordinación de feedback del cliente

El contrato de resultado (envelope)

Cada sub-agente devuelve un envelope con campos estándar: status, executive_summary, artifacts, next_recommended, risks. Si el envelope está incompleto, el orquestador re-invoca al sub-agente pidiendo los campos faltantes.

Por qué Tiers

  • T1 son los sub-agentes core del pipeline de papers (siempre disponibles).
  • T2 son comerciales (cotizaciones, ruteo, tracking) — activados cuando hay un cliente.
  • T3 son especializados (translation, research_compliance) — bajo demanda.

La clasificación por tier permite escalar el costo: agentes metadata-heavy o aggregators usan Haiku (~39% de ahorro) sin perder calidad. Ver Case studies → FASE C.

Cómo se garantiza la independencia

El devils_advocate y los reviewers operan con independence enforcement: no comparten contexto con el agente que auditan, para que la crítica sea genuina y no auto-complaciente.

Ver también

Fuente canónica

Deriva de docs/shared/SUB_AGENTS.md.