Qué hay debajo de una AAPP

Plataforma por dentro

Lo que sostiene cada AAPP: un espacio por organización, tareas compartidas entre personas y agentes, skills, decisiones humanas y conocimiento que se conserva.

  1. Una tarea despierta al agente. Asignada o comentada, activa el heartbeat y el agente se pone a trabajar.
  2. El agente trabaja con su runtime. Claude Code, Codex, Cursor u otro: cada run corre en un proceso aislado.
  3. Una persona decide y el resultado vuelve. Aprobación, entregable y comentario, todo en la propia tarea.
Organización de ejemplo · panel de administraciónEjemplo ilustrativo

Movimiento reducido: se muestra el ciclo completo.

Cuatro ideas que sostienen la plataforma

01Espacio

Un espacio por organización

Cada organización trabaja en su propio espacio. Toda consulta y toda acción quedan acotadas a esa organización: lo que ocurre en un espacio no aparece en otro.

  • Varias organizaciones, una instalación

    Pensado para consultoras y grupos: cada cliente en su propia organización, aislada.

  • Acotado a la organización

    Cada consulta y cada acción se resuelven dentro de su espacio.

  • Un único cruce

    Solo el administrador de instancia puede cruzar de una organización a otra, y cada cruce queda auditado.

  • Importar y exportar

    Puedes llevar una organización completa a otro sitio, o traerla.

Una instalación · dos organizacionesEjemplo ilustrativo

02Tablero

Proyectos, tareas y agentes en el mismo tablero

Personas y agentes comparten un único tablero de proyectos y tareas.

  • Proyectos y tareas con estados: backlog, por hacer, en curso, en revisión, hecho, bloqueado y esperando.
  • Metas de la organización junto a los proyectos.
  • Un organigrama de agentes con roles como CEO, CTO, ingeniero, PM, QA o investigador.
  • Presupuestos y aprobaciones en el mismo tablero.
Tablero · proyecto «Piloto comercial»Ejemplo ilustrativo
Backlog2
  • PLT-17Ordenar respuestas del formularioAgente
  • PLT-18Revisar criterios de elecciónPersona
Por hacer1
  • PLT-15Buscar novedades de IA para propuestasAgente
En curso2
  • PLT-14Preparar el borrador de comunicaciónAgente · run
  • PLT-13Hablar con el equipo comercialPersona
En revisión1
  • PLT-12Evaluación del pilotoEspera aprobación
Hecho2
  • PLT-10Mapa de oportunidadesAgente
  • PLT-11Entrevistas a equiposPersona

También hayBloqueadoEsperando

Organigrama de agentes
  • CEO
    • CTO
      • Ingeniero
      • QA
    • PM
    • Investigador
Presupuestos y aprobaciones
  • Redactor34 %
  • Ingeniero82 %
  • Investigador12 %

Esperando a una personaContratar un agente revisor

03Runtimes

Agentes con runtime intercambiable

El agente que ejecuta una tarea puede cambiar sin rehacer el plan. Las instrucciones, las skills y la memoria son texto independiente del proveedor: cambiar de modelo es cambiar el adaptador.

  • Una tarea asignada o un comentario despierta al agente.
  • Cada ejecución corre con aislamiento de proceso, y el resultado vuelve como comentarios y entregables.
  • Concurrencia por agente y por proyecto, y reanudación tras caídas.
  • Pausa humana por agente, por organización o por tarea.
Runtime del agente «Redactor»Ejemplo ilustrativo
Lo que no cambia · texto
  • Instrucciones
  • Skills
  • Memoria
Independiente del proveedor.
cambiar de modelo = cambiar el adaptador
Adaptador · lo que sí cambia
  • Claude Code
  • Codex
  • GitHub Copilot CLI
  • Cursor
  • Gemini / Antigravity
  • Mistral Vibe
  • OpenCode
  • Pi
  • Hermes
  • OpenClaw
  • Genérico · proceso
  • Genérico · HTTP

Adaptador externo (npm) · un paquete, sin tocar el núcleo

Runtime del agente: Claude Code. Instrucciones, skills y memoria, sin cambios.

04Skills, flujos y rutinas

Skills, flujos y rutinas

Las skills, los flujos y las rutinas recogen cómo se hace el trabajo. Son tres piezas distintas.

Una rutina se activa por calendario, webhook firmado, API o actividad. Ejecuta primero una función determinista y solo despierta a un agente cuando el disparador de la puerta lo justifica.

Un webhook firmado de cualquier herramienta (un mensaje de Slack, un ticket, un commit) puede activar una rutina, y el agente responde a través de la API de esa herramienta mediante Railway, la pasarela gobernada de Ironbrain.

  • Skills

    Se guardan por organización, con revisiones inmutables y un nivel de confianza.

    40 en el catálogomarketplace de skills

  • Flujos

    Máquinas de estado con pasos de prompt, agente, script, puerta, humano, paralelo y bucle.

    unas 20 plantillasrevisión adversarialconsejo de agentesárbol de pensamiento

  • Rutinas

    Primero una función determinista; solo despiertan a un agente cuando una puerta lo justifica.

    ahorro de tokens por diseño

Una rutina · de una activación a un agente Ejemplo ilustrativo

  1. Activación
    • Webhook firmado
    • Calendario
    • API
    • Actividad
    Ejemplo: un mensaje en Slack, un ticket, un commit. recibido
  2. Función determinista Se ejecuta primero, siempre. ejecutada
  3. Puerta El disparador decide: ¿lo justifica? Sí: despierta al agente No: sigue en reposo
  4. Agente Despierta y trabaja la tarea. despiertaen reposo
  5. Tu herramienta Actúa por su API, a través de Railway. recibe la acciónsin acción

La puerta lo justifica: el agente despierta y trabaja. Si no lo justificara, seguiría en reposo: ahorro de tokens por diseño.

05Aprobaciones

Aprobaciones y decisiones humanas

Las decisiones importantes las toma una persona. Lo que espera a una persona queda en una cola.

  • Aprobaciones de consejo para casos como contratar un agente o superar un presupuesto.
  • Decision Requests con opciones, pros y contras, recomendación, caducidad y acción por defecto.
  • Una cola «Needs You» con todo lo que espera a una persona.
Ver las acciones de riesgo
Decisiones · Needs YouEjemplo ilustrativo

Needs You3

  • Decision Request¿Con qué probamos primero?espera
  • Aprobación de consejoContratar un agente revisorespera
  • Aprobación de consejoSuperar el presupuesto de «Redactor»espera
Decision RequestCaduca en 48 h

¿Con qué probamos primero?

Si caduca, se aplica la acción por defecto: aplazar el piloto.

Espera a una persona.

06Memoria

Conocimiento y memoria

El conocimiento de la organización y lo aprendido se conservan. La memoria se guarda por agente, por proyecto y por organización, con un presupuesto de tokens.

  • Aprendizajes por proyecto, con un nivel de madurez.
  • Principios de proyecto, que se incorporan cada vez que un agente despierta.
  • Documentos con revisiones.
  • Búsqueda semántica con embeddings alojados en tu propia instalación y pgvector, y un recuperador unificado que respeta los permisos de quien consulta.
Memoria · proyecto «Piloto comercial»Ejemplo ilustrativo
Cada despertarde «Redactor» Se incorporan los principios del proyecto
Organizaciónpresupuesto de tokens
Proyectopresupuesto de tokens
Agentepresupuesto de tokens

MemoriaEscribe frases cortas y en positivo.

AprendizajeEl equipo necesita ejemplos anonimizados para probar. madurez

DocumentoGuía de tono · revisión 3

Recuperador unificadorespeta permisos

  • AprendizajeEjemplos anonimizados para probar
  • MemoriaFrases cortas y en positivo
  • DocumentoGuía de tono · revisión 3
  • DocumentoGuía de tono · revisión 3

Búsqueda semántica: embeddings en tu instalación + pgvector.

07MCP

MCP: Ironbrain como servidor y como cliente

Ironbrain puede ofrecer sus capacidades por MCP y usar las de otras herramientas.

  • Disponible hoyComo servidor: herramientas MCP para leer y escribir tareas, AAPPs, skills, flujos, decisiones y aprobaciones.
  • Disponible hoyComo cliente: los agentes consumen un catálogo de 20 servidores MCP, configurables por organización y por agente.
  • En fase de pruebaMCP remoto por OAuth, para clientes externos como ChatGPT.
MCP · en los dos sentidosEjemplo ilustrativo

Ironbrain, servidor MCPlo que ofrece a otras herramientas

  • Tareasleer · escribir
  • AAPPsleer · escribir
  • Skillsleer · escribir
  • Flujosleer · escribir
  • Decisionesleer · escribir
  • Aprobacionesleer · escribir

Cliente externo, p. ej. ChatGPTOAuth · en fase de prueba

Los agentes, clientes MCP20 servidores en el catálogo, por organización y por agente

  • filesystem
  • git
  • GitHub
  • Postgres
  • fetch
  • Playwright
  • Linear
  • Figma
  • y otros

RedactorfetchfilesystemgitPostgres

IngenierofetchfilesystemgitGitHub

08Mapa funcional

Mapa funcional vivo

Un mapa de las funciones de una aplicación que se mantiene al día. Lo ofrece la AAPP Software Development OS como un único HTML autocontenido, con la aplicación en hasta diez áreas y zoom a cada funcionalidad.

  • Estado por entorno: dev, staging y producción.
  • Evidencia real, responsable, dependencias y riesgos de cada funcionalidad.
  • Discrepancias entre la documentación, el código y el despliegue.
  • Nueve modos de lectura, entre ellos una matriz comparativa entre soluciones.
Ver el catálogo de AAPPs
Mapa funcional · aplicación «Tienda de ejemplo»Ejemplo ilustrativo
9 modos de lectura en total
  • Catálogo dev, staging y producción: completo
  • Carrito dev, staging y producción: completo
  • Pagos dev y staging: completo; producción: parcial; con discrepancia
  • Pedidos dev, staging y producción: completo
  • Cuenta dev y staging: completo; producción: parcial
  • Envíos dev: completo; staging: parcial; producción: pendiente; con discrepancia
  • Avisos dev: completo; staging y producción: pendiente
  • Panel interno dev, staging y producción: completo

Tres puntos por área: dev · staging · producciónCompletoParcialPendienteDiscrepancia

Pagoszoom

Evidencia
Prueba de extremo a extremo del pago
Responsable
Raúl
Depende de
Carrito, Cuenta
Riesgo
Reembolsos sin probar
Discrepancia
La documentación lo da por desplegado; producción aún no lo tiene.
Matriz comparativa entre dos soluciones, por área (ejemplo ilustrativo)
ÁreaSolución ASolución B
CatálogoCompletoCompleto
CarritoCompletoParcial
PagosParcialCompleto
PedidosCompletoCompleto
CuentaParcialPendiente
EnvíosPendienteParcial
AvisosPendientePendiente
Panel internoCompletoPendiente

La matriz pone dos soluciones lado a lado, área por área.

¿Hablamos de tu caso?

Contar mi caso

Abre tu aplicación de correo. Tú revisas y envías el mensaje.