Protocolo IA/ external-agents-specs

IA Specifications

Definición semántica para el consumo de información por parte de Large Language Models y agentes autónomos. El estándar "AI-Ready" garantiza una interpretación sin ambigüedades.

Reglas de Oro (Manifesto)

1. Arquitectura Modular:

"Aislamiento estricto de lógica. Todo desarrollo nuevo debe residir en /modules."

2. Multi-tenancy Estricto:

"Seguridad por root path. Prohibido consultas globales sin tenantId."

Esquema Fundamental

/tenants/{tid}/clientsRead/Write

/tenants/{tid}/appointmentsReal-time

/tenants/{tid}/integrationsSecret/Auth

Context Mapping

ai-context.json

{
  "project": "Nexa Software",
  "version": "2.4.0",
  "tech_stack": {
    "engine": "Next.js 15 (Optimized)",
    "database": "Firebase/Firestore Reactive",
    "ai_layer": "OpenAI / Meta Integration"
  },
  "crawling": {
    "entry_point": "/docs",
    "structure": "Hierarchical",
    "meta_tags": "JSON-LD Enabled"
  }
}

Semantic Directives

SEO & Metadata

Inyección dinámica de keywords en SSR para facilitar el indexado de agentes.

Estructura HTML5

Jerarquía clara mediante article y section para un parsing veloz.

Typed Snippets

Bloques de código con identificación de lenguaje para análisis estático.

Path Mapping

Sistema de navegación basado en grafos para evitar bucles de rastreo.