Communitygithub.com

SamuelChien/mega-skills-collection

Protocolo de comunicación entre agentes para equipos de agentes C-suite. Define sintaxis de invocación, prevención de bucles, reglas de aislamiento y formatos de respuesta. Úsalo cuando los agentes C-suite necesiten consultarse entre sí, coordinar análisis multifuncionales o realizar reuniones de directorio con múltiples roles de agente.

¿Qué es mega-skills-collection?

Este protocolo establece un sistema de comunicación estructurado y seguro para equipos de agentes de IA que simulan roles ejecutivos de alto nivel (C-suite: CEO, CFO, CRO, CTO, etc.). Su propósito principal es permitir que estos agentes colaboren de manera eficiente, evitando caos, bucles infinitos, razonamiento circular y conflictos no resueltos. El protocolo define una sintaxis de invocación clara (`[INVOKE:rol|pregunta]`), un formato de respuesta estandarizado con niveles de confianza y salvedades, y cuatro reglas duras de prevención de bucles (sin auto-invocación, profundidad máxima de 2, sin llamadas circulares y seguimiento de cadena). Incluye reglas de aislamiento para fases específicas de una reunión de directorio, un bucle de calidad interno de cuatro pasos (autoverificación, verificación entre pares, revisión crítica y corrección posterior a la retroalimentación), y un estándar de comunicación hacia el usuario final (el 'fundador') con formato de salida único. El protocolo es útil para cualquier plataforma de agentes (Claude Code, Cursor, Codex, etc.) que requiera coordinar múltiples perspectivas analíticas sin perder el control del proceso.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SamuelChien/mega-skills-collection/tree/HEAD/agent-protocol

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Protocolo entre Agentes

Cómo se comunican los agentes C-suite. Reglas que previenen el caos, los bucles y el razonamiento circular.

Palabras Clave

protocolo de agente, comunicación entre agentes, invocación de agente, orquestación de agentes, multi-agente, coordinación c-suite, cadena de agentes, prevención de bucles, aislamiento de agentes, protocolo de reunión de directorio

Sintaxis de Invocación

Cualquier agente puede consultar a otro usando:

[INVOKE:rol|pregunta]

Ejemplos:

[INVOKE:cfo|¿Cuál es el impacto en la tasa de consumo de contratar 5 ingenieros en el Q3?]
[INVOKE:cto|¿Podemos realmente lanzar esta función para fin de trimestre?]
[INVOKE:chro|¿Cuál es nuestro tiempo típico de contratación para ingenieros senior?]
[INVOKE:cro|¿Cómo se ve nuestro pipeline para los próximos 90 días?]

Roles válidos: ceo, cfo, cro, cmo, cpo, cto, chro, coo, ciso

Formato de Respuesta

Los agentes invocados responden usando esta estructura:

[RESPONSE:rol]
Hallazgo clave: [una línea — la respuesta real]
Datos de respaldo:
  - [dato 1]
  - [dato 2]
  - [dato 3 — opcional]
Confianza: [alta | media | baja]
Salvedad: [una línea — qué podría hacer que esto esté mal]
[/RESPONSE]

Ejemplo:

[RESPONSE:cfo]
Hallazgo clave: Contratar 5 ingenieros en Q3 reduce la pista de aterrizaje de 14 a 9 meses al consumo actual.
Datos de respaldo:
  - Consumo mensual actual: $280K → aumenta a ~$380K (+$100K completamente cargado)
  - ARR necesario para compensar: ~$1.2M adicionales en 12 meses
  - El pipeline actual cubre el 60% de ese objetivo
Confianza: media
Salvedad: Asume un período de adaptación de 3 meses y ningún cambio en la trayectoria de ingresos.
[/RESPONSE]

Prevención de Bucles (Reglas Estrictas)

Estas reglas se aplican incondicionalmente. Sin excepciones.

Regla 1: Sin Auto-Invocación

Un agente no puede invocarse a sí mismo.

❌ CFO → [INVOKE:cfo|...] — BLOQUEADO

Regla 2: Profundidad Máxima = 2

Las cadenas pueden ir A→B→C. El tercer salto está bloqueado.

✅ CRO → CFO → COO (profundidad 2)
❌ CRO → CFO → COO → CHRO (profundidad 3 — BLOQUEADO)

Regla 3: Sin Llamadas Circulares

Si el agente A llamó al agente B, el agente B no puede llamar al agente A en la misma cadena.

✅ CRO → CFO → CMO
❌ CRO → CFO → CRO (circular — BLOQUEADO)

Regla 4: Seguimiento de Cadena

Cada invocación lleva su cadena de llamadas. Formato:

[CHAIN: cro → cfo → coo]

Los agentes verifican esta cadena antes de responder con otra invocación.

Cuando está bloqueado: Devuelve esto en lugar de invocar:

[BLOCKED: no se puede invocar cfo — llamada circular detectada en la cadena cro→cfo]
Suposición de estado utilizada en su lugar: [suposición explícita que el agente está haciendo]

Reglas de Aislamiento

Fase 2 de la Reunión de Directorio (Análisis Independiente)

NO se permiten invocaciones. Cada rol forma puntos de vista independientes antes de la polinización cruzada.

  • Razón: prevenir el anclaje y el pensamiento grupal
  • Duración: todo el período de análisis de la Fase 2
  • Si un agente necesita datos de otro rol: establecer una suposición explícita, marcarla con [ASSUMPTION: ...]

Fase 3 de la Reunión de Directorio (Rol de Crítico)

El Mentor Ejecutivo puede hacer referencia a los resultados de otros roles, pero no puede invocarlos.

  • Razón: la crítica debe ser independiente de las nuevas solicitudes de datos
  • Permitido: "La proyección del CFO asume X, lo que contradice los datos del pipeline del CRO"
  • No permitido: [INVOKE:cfo|...] durante la fase de crítica

Fuera de las Reuniones de Directorio

Las invocaciones están permitidas libremente, sujetas a las reglas de prevención de bucles anteriores.

Cuándo Invocar vs. Cuándo Suponer

Invocar cuando:

  • La pregunta requiere datos específicos del dominio que no tienes
  • Un error aquí cambiaría materialmente la recomendación
  • La pregunta es multifuncional por naturaleza (por ejemplo, impacto de la contratación tanto en el presupuesto como en la capacidad)

Suponer cuando:

  • Los datos son direccionalmente claros y la precisión no es crítica
  • Estás en el aislamiento de la Fase 2 (siempre supón, nunca invoques)
  • La cadena ya está en profundidad 2
  • La pregunta es menor en comparación con tu análisis principal

Al suponer, indícalo siempre:

[ASSUMPTION: pista de aterrizaje ~12 meses basada en el perfil típico de consumo de una Serie A — no verificado con el CFO]

Resolución de Conflictos

Cuando dos agentes invocados dan respuestas contradictorias:

  1. Señala el conflicto explícitamente:
    [CONFLICT: CFO proyecta una pista de aterrizaje de 14 meses; CRO espera que el pipeline cierre un 80% → implica 18+ meses]
    
  2. Indica el enfoque de resolución:
    • Conservador: usa el peor caso
    • Probabilístico: pondera por puntuaciones de confianza
    • Escalar: señalar para decisión humana
  3. Nunca elijas uno en silencio — muestra el conflicto al usuario.

Patrón de Transmisión (Crisis / CEO)

El CEO puede transmitir a todos los roles simultáneamente:

[BROADCAST:all|¿Cuál es el impacto si no logramos la recaudación de fondos?]

Las respuestas llegan de forma independiente (ningún agente ve la respuesta de otro antes de formar la suya propia). Agregar después de que todos respondan.

Referencia Rápida

ReglaComportamiento
Auto-invocación❌ Siempre bloqueado
Profundidad > 2❌ Bloqueado, establecer suposición
Circular❌ Bloqueado, establecer suposición
Aislamiento Fase 2❌ Sin invocaciones
Crítica Fase 3❌ Solo referencia, sin invocación
Conflicto✅ Muéstralo, no lo ocultes
Suposición✅ Siempre explícita con [ASSUMPTION: ...]

Bucle de Calidad Interno (antes de que llegue cualquier cosa al fundador)

Ningún rol se presenta ante el fundador sin pasar por este bucle de verificación. El fundador ve resultados pulidos y verificados, no primeros borradores.

Paso 1: Autoverificación (cada rol, cada vez)

Antes de presentar, cada rol ejecuta esta lista de verificación interna:

LISTA DE VERIFICACIÓN DE AUTO-VERIFICACIÓN:
□ Atribución de la Fuente — ¿De dónde vino cada dato?
  ✅ "El ARR es de $2.1M (del informe de pipeline del CRO, datos reales del Q4)"
  ❌ "El ARR es de alrededor de $2M" (sin fuente, vago)

□ Auditoría de Suposiciones — ¿Qué estoy asumiendo vs. qué verifiqué?
  Etiqueta cada suposición: [VERIFIED: verificado contra datos] o [ASSUMED: no verificado]
  Si >50% de los hallazgos son ASSUMED → indica baja confianza

□ Puntuación de Confianza — ¿Qué tan seguro estoy de cada hallazgo?
  🟢 Alta: datos verificados, patrón establecido, múltiples fuentes
  🟡 Media: una sola fuente, inferencia razonable, algo de incertidumbre
  🔴 Baja: basado en suposiciones, datos limitados, primer análisis

□ Verificación de Contradicciones — ¿Esto entra en conflicto con el contexto conocido?
  Verificar contra company-context.md y decisiones recientes en decision-log
  Si contradice una decisión pasada → señalarlo explícitamente

□ Prueba "¿Y qué?" — ¿Cada hallazgo tiene una consecuencia comercial?
  Si no puedes responder "¿y qué?" en una oración → elimínalo

Paso 2: Verificación entre Pares (validación multifuncional)

Cuando una recomendación afecta el dominio de otro rol, ese rol valida ANTES de presentar.

Si tu recomendación involucra...Valida con...Ellos verifican...
Números financieros o presupuestoCFOMatemáticas, impacto en la pista de aterrizaje, realidad presupuestaria
Proyecciones de ingresosCRORespaldo del pipeline, precisión histórica
Contratación o dotación de personalCHRORealidad del mercado, viabilidad de compensación, cronograma
Viabilidad técnica o cronogramaCTOCapacidad de ingeniería, carga de deuda técnica
Cambios en procesos operativosCOOCapacidad, dependencias, impacto de escalado
Cambios orientados al clienteCRO + CPORiesgo de abandono, conflicto con la hoja de ruta del producto
Afirmaciones de seguridad o cumplimientoCISOPostura real, requisitos regulatorios
Afirmaciones de mercado o posicionamientoCMORespaldo de datos, realidad competitiva

Formato de validación entre pares:

[PEER-VERIFY:cfo]
Validado: ✅ Cálculo de tasa de consumo correcto
Ajustado: ⚠️ El cronograma de contratación debería ser Q3, no Q2 (restricción presupuestaria)
Señalado: 🔴 Falta el costo de capital en la proyección de compensación total
[/PEER-VERIFY]

Omitir la verificación entre pares cuando:

  • Pregunta de un solo dominio sin impacto multifuncional
  • Alerta proactiva urgente (enviar alerta, verificar después)
  • El fundador solicitó explícitamente una opinión rápida

Paso 3: Revisión Previa del Crítico (solo decisiones de alto riesgo)

Para decisiones que son irreversibles, de alto costo o que apuestan la empresa, el Mentor Ejecutivo realiza una revisión previa antes de que el fundador lo vea.

Desencadenantes de la revisión previa:

  • Implica gastar > 20% de la pista de aterrizaje restante
  • Afecta a > 30% del equipo (despidos, reorganización)
  • Cambia la estrategia o dirección de la empresa
  • Implica compromisos externos (términos de recaudación de fondos, asociaciones, fusiones y adquisiciones)
  • Cualquier recomendación en la que todos los roles estén de acuerdo (consenso sospechoso)

Resultado de la revisión previa:

[CRITIC-SCREEN]
Punto más débil: [La mayor vulnerabilidad en esta recomendación]
Perspectiva faltante: [Lo que nadie consideró]
Si está mal, el costo es: [Desventaja cuantificada]
Proceder: ✅ Con riesgos señalados | ⚠️ Después de abordar [brecha específica] | 🔴 Repensar
[/CRITIC-SCREEN]

Paso 4: Corrección de Rumbo (después de la retroalimentación del fundador)

El bucle no termina con la entrega. Después de que el fundador responda:

BUCLE DE RETROALIMENTACIÓN DEL FUNDADOR:
1. Fundador aprueba → registrar decisión (Capa 2), asignar acciones
2. Fundador modifica → actualizar análisis con correcciones, re-verificar partes cambiadas
3. Fundador rechaza → registrar rechazo con DO_NOT_RESURFACE, entender POR QUÉ
4. Fundador hace seguimiento → profundizar análisis en punto específico, re-verificar

REVISIÓN POST-DECISIÓN (30/60/90 días):
- ¿Fue correcta la recomendación?
- ¿Qué pasamos por alto?
- Actualizar company-context.md con lo aprendido
- Si fue incorrecta → documentar la lección, ajustar análisis futuros

Nivel de Verificación por Riesgo

RiesgosAutoverificarVerificar entre ParesRevisión Previa del Crítico
Bajo (informativo)✅ Requerido❌ Omitir❌ Omitir
Medio (operativo)✅ Requerido✅ Requerido❌ Omitir
Alto (estratégico)✅ Requerido✅ Requerido✅ Requerido
Crítico (irreversible)✅ Requerido✅ Requerido✅ Requerido + reunión de directorio

Qué Cambia en el Formato de Salida

La salida verificada agrega información de confianza y fuente:

RESUMEN
[Respuesta] — Confianza: 🟢 Alta

QUÉ
• [Hallazgo 1] [VERIFIED: datos reales del Q4] 🟢
• [Hallazgo 2] [VERIFIED: datos del pipeline del CRO] 🟢  
• [Hallazgo 3] [ASSUMED: basado en puntos de referencia de la industria] 🟡

VERIFICADO POR: CFO (matemáticas ✅), CTO (cronograma ⚠️ ajustado a Q3)

Estándar de Comunicación con el Usuario

Toda la producción del C-suite al fundador sigue UN SOLO formato. Sin excepciones. El fundador es quien toma las decisiones — dales resultados, no proceso.

Salida Estándar (respuesta de un solo rol)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📊 [ROL] — [Tema]

RESUMEN
[Una oración. La respuesta. Sin preámbulos.]

QUÉ
• [Hallazgo 1 — el más crítico]
• [Hallazgo 2]
• [Hallazgo 3]
(Máximo 5 viñetas. Si se necesitan más → documento de referencia.)

POR QUÉ ES IMPORTANTE
[1-2 oraciones. Impacto comercial. No teoría — consecuencia.]

CÓMO ACTUAR
1. [Acción] → [Responsable] → [Fecha límite]
2. [Acción] → [Responsable] → [Fecha límite]
3. [Acción] → [Responsable] → [Fecha límite]

⚠️ RIESGOS (si los hay)
• [Riesgo + qué lo desencadena]

🔑 TU DECISIÓN (si es necesaria)
Opción A: [Descripción] — [Compensación]
Opción B: [Descripción] — [Compensación]
Recomendación: [Cuál y por qué, en una línea]

📎 DETALLE: [documento de referencia o salida de script para profundizar]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Alerta Proactiva (no solicitada — desencadenada por contexto)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🚩 [ROL] — Alerta Proactiva

QUÉ NOTÉ
[Qué desencadenó esto — específico, no vago]

POR QUÉ ES IMPORTANTE
[Consecuencia comercial si se ignora — en dólares, tiempo o riesgo]

ACCIÓN RECOMENDADA
[Exactamente qué hacer, quién lo hace, para cuándo]

URGENCIA: 🔴 Actuar hoy | 🟡 Esta semana | ⚪ Próxima revisión

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Salida de Reunión de Directorio (síntesis de múltiples roles)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 REUNIÓN DE DIRECTORIO — [Fecha] — [Tema de la Agenda]

DECISIÓN REQUERIDA
[Enmarcar la decisión en una oración]

PERSPECTIVAS
  CEO: [posición en una línea]
  CFO: [posición en una línea]
  CRO: [posición en una línea]
  [... solo roles que contribuyeron]

DÓNDE COINCIDEN
• [Punto de consenso 1]
• [Punto de consenso 2]

DÓNDE DISCREPAN
• [Conflicto] — CEO dice X, CFO dice Y
• [Conflicto] — CRO dice X, CPO dice Y

OPINIÓN DEL CRÍTICO (Mentor Ejecutivo)
[La verdad incómoda que nadie más dijo]

DECISIÓN RECOMENDADA
[Recomendación clara con fundamento]

PUNTOS DE ACCIÓN
1. [Acción] → [Responsable] → [Fecha límite]
2. [Acción] → [Responsable] → [Fecha límite]
3. [Acción] → [Responsable] → [Fecha límite]

🔑 TU LLAMADA
[Opciones si no estás de acuerdo con la recomendación]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Reglas de Comunicación (no negociables)

  1. Resumen primero. Siempre. El tiempo del fundador es el recurso más escaso.
  2. Solo resultados y decisiones. Sin narración del proceso ("Primero analicé..."). Sin pensar en voz alta.
  3. Qué + Por qué + Cómo. Cada hallazgo explica QUÉ es, POR QUÉ es importante (impacto comercial) y CÓMO actuar sobre él.
  4. Máximo 5 viñetas por sección. Más largo = documento de referencia.
  5. Las acciones tienen responsables y fechas límite. "Deberíamos considerar" está prohibido. Quién hace qué y para cuándo.
  6. Decisiones enmarcadas como opciones. No "¿qué opinas?" — "Opción A o B, aquí está la compensación, aquí está mi recomendación."
  7. El fundador decide. Los roles recomiendan. El fundador aprueba, modifica o rechaza. Cada salida respeta esta jerarquía.
  8. Los riesgos son concretos. No "podría haber riesgos" — "si pasa X, Y se rompe, costando $Z."
  9. Sin jerga sin explicación. Si usas un término, explícalo en el primer uso.
  10. El silencio es una opción. Si no hay nada que informar, no fabriques actualizaciones.

Referencia

  • references/invocation-patterns.md — patrones multifuncionales comunes con ejemplos

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

SamuelChien/mega-skills-collection

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

SamuelChien/mega-skills-collection

Arquitecto de Soluciones Principal y Consultor Tecnológico de Andru.ia. Diagnostica y traza la hoja de ruta óptima para proyectos de IA en español.

SamuelChien/mega-skills-collection

Ingeniero de Sistemas de Andru.ia. Diseña, redacta y despliega nuevas habilidades (skills) dentro del repositorio siguiendo el Estándar de Diamante.

SamuelChien/mega-skills-collection

Estratega de Inteligencia de Dominio de Andru.ia. Analiza el nicho específico de un proyecto para inyectar conocimientos, regulaciones y estándares únicos del sector. Actívalo tras definir el nicho.

SamuelChien/mega-skills-collection

2D game development principles. Sprites, tilemaps, physics, camera.

SamuelChien/mega-skills-collection

3D game development principles. Rendering, shaders, physics, cameras.

SamuelChien/mega-skills-collection

Expert in building 3D experiences for the web - Three.js, React Three Fiber, Spline, WebGL, and interactive 3D scenes. Covers product configurators, 3D portfolios, immersive websites, and bringing depth to web experiences.

SamuelChien/mega-skills-collection

Accessibility audit skill for scanning, fixing, and verifying WCAG 2.2 Level A and AA compliance across React, Next.js, Vue, Angular, Svelte, and plain HTML codebases. Use when auditing accessibility, fixing a11y violations, checking color contrast, generating compliance reports, or integrating accessibility checks into CI/CD pipelines.

SamuelChien/mega-skills-collection

Ab Test Analyzer - Auto-activating skill for Data Analytics. Triggers on: ab test analyzer, ab test analyzer Part of the Data Analytics skill category.

SamuelChien/mega-skills-collection

A B Test Config Creator - Auto-activating skill for ML Deployment. Triggers on: a b test config creator, a b test config creator Part of the ML Deployment skill category.

SamuelChien/mega-skills-collection

When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "conversion experiment," "statistical significance," or "test this." For tracking implementation, see analytics-tracking.

SamuelChien/mega-skills-collection

Acceptance Criteria Creator - Auto-activating skill for Enterprise Workflows. Triggers on: acceptance criteria creator, acceptance criteria creator Part of the Enterprise Workflows skill category.

SamuelChien/mega-skills-collection

Use when a coding task should be driven end-to-end from issue intake through implementation, review, deployment, and acceptance verification with minimal human re-intervention.

SamuelChien/mega-skills-collection

Accessibility Audit Runner - Auto-activating skill for Frontend Development. Triggers on: accessibility audit runner, accessibility audit runner Part of the Frontend Development skill category.

SamuelChien/mega-skills-collection

You are an accessibility expert specializing in WCAG compliance, inclusive design, and assistive technology compatibility. Conduct audits, identify barriers, and provide remediation guidance.

SamuelChien/mega-skills-collection

Web accessibility patterns for WCAG 2.2 compliance including ARIA, keyboard navigation, screen readers, and testing

SamuelChien/mega-skills-collection

Manage Discord channel access — approve pairings, edit allowlists, set DM/group policy. Use when the user asks to pair, approve someone, check who's allowed, or change policy for the Discord channel.

SamuelChien/mega-skills-collection

Create unified specification packages across Business, Development, and Design teams. Staged elaboration (L0 Vision → L1 Requirements → L2 Team Detail → L3 Acceptance Criteria) to build shared understanding. Does not write code.

SamuelChien/mega-skills-collection

Research a company or person and get actionable sales intel. Works standalone with web search, supercharged when you connect enrichment tools or your CRM. Trigger with "research [company]", "look up [person]", "intel on [prospect]", "who is [name] at [company]", or "tell me about [company]".

SamuelChien/mega-skills-collection

Validate messaging consistency across website, GitHub repos, and local documentation generating read-only discrepancy reports. Use when checking content alignment or finding mixed messaging. Trigger with phrases like "check consistency", "validate documentation", or "audit messaging".

Skills relacionados