## Asset Header - **Asset ID:** BCV-AgenticIntelligencePlaybook-v02 - **Version:** v02 - **Status:** Draft - **Owner:** Victor Heredia - **IntellBank:** IB-EL-EmpowerLabs - **Tipo:** BCV — (tipo pendiente) - **Propósito:** BCV — The Agentic Intelligence Playbook - **Última actualización:** 2026-04-11 --- asset_id: BCV-AgenticIntelligencePlaybook-v02 nombre: The Agentic Intelligence Playbook — Brain Code de Video tipo: BCV (Brain Code de Video) fuente: The Agentic Intelligence Playbook v1.0 (documento fuente) status: Operativo version: v02 fecha: 2026-04-06 owner: Victor Heredia / EmpowerLabs capa_V: No aplicada (fuente no es un experto individual identificado) nota_v01: v01 no seguía estructura de capas BCV. Reorganizado en v02. --- # BCV — The Agentic Intelligence Playbook ## Cognitive Stack destilado del documento fuente "The Agentic Intelligence Playbook v1.0" --- ## LAYER 0 — RAW SNAP (Secuencia literal del contenido fuente) Los conceptos aparecen en este orden en el documento original: 1. **The Agentic Loop (Gather → Act → Verify)** — el agente como solucionador iterativo, no como chatbot de respuesta única 2. **Context as Fragile Working Memory** — el contexto como recurso escaso y costoso (Quadratic Tax) 3. **Intent vs. Execution (The Airgap)** — el agente declara intenciones, un runtime separado las ejecuta 4. **Rule 1: Simplicity is the Ultimate Control Flow** — un solo while loop, sin frameworks complejos 5. **Rule 2: Engineer Context, Don't Just Engineer Prompts** — gestión del entorno, no solo de la pregunta 6. **Rule 3: Enforce Structured Contracts for Tools** — herramientas restringidas con estados de fallo definidos 7. **Rule 4: Isolate Verbosity via Delegation (Subagents)** — subagentes para trabajo ruidoso; el agente principal recibe solo el resumen 8. **Mid-Flight Steering** — corregir al agente mientras trabaja sin reiniciar el contexto 9. **Deterministic Guardrails (Hooks)** — reglas no negociables que bloquean físicamente acciones incorrectas 10. **Leverage MCP (USB-C of AI)** — un servidor MCP da acceso a cualquier herramienta compatible 11. **Manage the Quadratic Tax** — `/clear` o `/compact` entre tareas para preservar contexto y reducir costo --- ## LAYER 1 — COGNITIVE STACK (Cómo piensa este framework) ### Lentes cognitivos (los filtros que aplica) **Lens 1 — El agente como arquitectura, no como herramienta** No es una caja de respuestas. Es un sistema que observa, planea, actúa y verifica. El operador diseña el sistema; el agente lo ejecuta. La pregunta correcta no es "¿qué le pregunto?" sino "¿qué ambiente le construyo para que funcione bien?" **Lens 2 — El contexto es el activo más frágil** El contexto no es gratis. Tiene una "Quadratic Tax" — cada turno adicional cuesta exponencialmente más y degrada la calidad. El operador inteligente gestiona el contexto como gestiona el dinero: con disciplina, no por inercia. **Lens 3 — La seguridad vive en el runtime, no en el prompt** No confiar en que el agente "entienda" qué no debe hacer. Las reglas no negociables se implementan como ganchos deterministas (hooks) que devuelven `Exit 2` antes de que el agente pueda actuar. El airgap entre intención y ejecución es el control más poderoso. ### Principios invariantes - **Simplicity over sophistication:** Un while loop simple + modelo potente es mejor que un framework complejo + modelo mediocre. Cada mejora del modelo base mejora automáticamente todo el sistema. - **Structured contracts for tools:** Ninguna herramienta sin restricciones. Bad: "edita este archivo." Good: "dame el path exacto, el string exacto a reemplazar, el string exacto de reemplazo. Si el string aparece más de una vez, falla inmediatamente." - **Delegate noise, keep signal:** Lo que genera miles de líneas de output va a un subagente. El agente principal recibe solo lo que necesita para decidir. - **No-signal, no-proceed:** Si el contexto está contaminado con runs anteriores, limpiar antes de continuar. La confusión del agente con sus propios errores previos es uno de los errores más costosos. --- ## LAYER 2 — OPERATING SYSTEM (El Playbook de Operación) ### Protocolo de inicio de sesión con agente ``` PROTOCOLO AGENTIC SESSION ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ PASO 1 — CONTEXTO LIMPIO → /clear o /compact si la sesión anterior dejó ruido → No llevar errores de un run anterior al siguiente PASO 2 — AMBIENTE ANTES QUE PREGUNTA → Inyectar: reglas de proyecto (CLAUDE.md equivalente) → Inyectar: contexto mínimo necesario para la tarea → No: dumps de información por si acaso PASO 3 — HERRAMIENTAS CON CONTRATOS → Definir: qué herramientas puede usar el agente → Definir: qué campos son obligatorios para cada herramienta → Definir: qué condiciones causan fallo inmediato PASO 4 — DELEGACIÓN ANTES DE PROCESAR → ¿Esta tarea genera output ruidoso? → Subagente → ¿Esta tarea requiere razonamiento central? → Agente principal PASO 5 — MID-FLIGHT, NO POST-MORTEM → No esperar al final para corregir → Inyectar correcciones mientras el agente trabaja → No reiniciar si el agente va mal → redirigir PASO 6 — VERIFICAR, NO ASUMIR → El agente no verifica por defecto → Pedir verificación explícita: tests, logs, output comparison ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ``` ### Táctica de control de contexto (Quadratic Tax management) | Cuando | Acción | Por qué | | --------------------------------------- | ----------------------------------------- | ------------------------------------------------ | | Subtarea completada | `/clear` | Eliminar ruido del run anterior | | Contexto >50% de tokens | `/compact` | Comprimir preservando lo crítico | | El agente comete el mismo error 2 veces | Actualizar reglas de proyecto (CLAUDE.md) | Aprendizaje permanente, no corrección puntual | | Tarea larga con output ruidoso | Subagente con memoria vacía | El agente principal no se contamina con los logs | ### Arquitectura de guardrails ``` Nivel 1 — Prompt constraints (más débil) "No hagas X" — el agente puede ignorarlo si está confundido Nivel 2 — Structured contracts (más fuerte) "Si el campo Y no está presente, falla inmediatamente" — el fallo está codificado en la estructura, no en la instrucción Nivel 3 — Hooks deterministas (más fuerte de todos) Hook pre-tool → verifica condición → si viola regla → Exit 2 → El agente físicamente no puede proceder — No depende de que el agente "entienda" la regla ``` ### Integración MCP (el multiplicador) | Sin MCP | Con MCP | | -------------------------------------------- | ------------------------------------------------------------- | | Conector custom por cada herramienta interna | 1 servidor MCP → cualquier herramienta compatible al instante | | Costo de mantenimiento por cada integración | Costo único + escalabilidad infinita | | Herramientas en silos | Herramientas accesibles desde cualquier agente MCP-compatible | --- ## LAYER M — MODELO MENTAL DOMINANTE **El agente es un sistema de manufactura, no un oráculo.** Un oráculo responde preguntas. Una línea de manufactura tiene: materias primas (inputs), máquinas (tools), operarios (el agente), control de calidad (verificación), y management que diseña el proceso (el operador humano). La diferencia entre un CEO que "usa IA" y un CEO con una HiOrg es exactamente esta: uno le hace preguntas a un oráculo. El otro diseña sistemas de manufactura que producen outputs con calidad controlada y escalable. **Aplicación directa al ecosistema EmpowerLabs:** - Los Factory OS son los "diseños de proceso" del sistema de manufactura - Los Transfer Packs son el "control de contexto" entre turnos de producción - AniX, VicX, etc. son los agentes especializados de su línea de producción - El Control Plane es el tablero de gestión del sistema --- ## NOTAS DE USO PARA ESTE BCV **Cuándo activar este cognitive stack:** - Al diseñar un nuevo pipeline con agentes (Factory OS, SherpaX) - Al diagnosticar por qué un agente produce resultados inconsistentes - Al configurar herramientas para un nuevo Room o proceso - Al entrenar a un nuevo operador en cómo pensar sobre el trabajo con IA **Lo que este BCV NO reemplaza:** - El VVP (voz) — este BCV es sobre arquitectura, no sobre producción de contenido - El BCV-BorisCherny-ClaudeCode-v02 — son complementarios (Boris es el "cómo codear", este BCV es el "cómo pensar sobre sistemas de agentes") --- ## DELTA v01 → v02 | Elemento | v01 | v02 | | ------------------------------------- | -------------------------------------------- | ----------------------------------------- | | Header BMF | Ausente | ✅ Completo (asset_id, tipo, status, etc.) | | Estructura | Phase 1/2/3 (formato genérico) | ✅ Layer 0/1/2/M (formato BCV estándar) | | Layer 0 Raw Snap | Ausente | ✅ Secuencia literal del contenido fuente | | Cognitive Stack (lentes + principios) | Mezclado con tácticas | ✅ Separado y estructurado en Layer 1 | | Operating System / Playbook | Solo tabla | ✅ Protocolo completo + guardrails + MCP | | Modelo Mental Dominante (Layer M) | Ausente | ✅ Presente — conexión con ecosistema EL | | Emoji en título | 🧠 presente | ✅ Eliminado | | Meta-pregunta al final | Presente | ✅ Eliminada | | Naming convention | BCV-The Agentic Intelligence Playbook (v1.0) | ✅ BCV-AgenticIntelligencePlaybook-v02 | --- *BCV v02 generado por VicX · 2026-04-06* *Fuente: The Agentic Intelligence Playbook v1.0* *Formato: Estándar BCV (Layer 0 → 1 → 2 → M) validado contra BCV-BorisCherny-ClaudeCode-v02*