El marco de especificación del que nacen TMDL y TDL. Declarativo, explícito y transparente: lo que escribes es lo que recibe el modelo. The specification framework from which TMDL and TDL grow. Declarative, explicit and transparent: what you write is what the model receives.
ADL (Assistant Description Language) es un marco de especificación para sistemas basados en LLM desarrollado en la Universidad de Alicante. Describe qué es un asistente —identidad, rol, conocimiento, herramientas, límites— en lugar de cómo implementarlo. ADL (Assistant Description Language) is a specification framework for LLM-based systems developed at the University of Alicante. It describes what an assistant is — identity, role, knowledge, tools, boundaries — rather than how to implement it.
Punto clave: no es un lenguaje de programación y no tiene runtime. El propio texto YAML es el material que moldea el comportamiento del modelo. No hay capa intermedia que reescriba o seleccione fragmentos de forma opaca: la especificación es el programa y el LLM es el intérprete. Key point: it is not a programming language and has no runtime. The YAML text itself is the material that shapes the model's behavior. There is no intermediate layer rewriting or opaquely selecting fragments: the specification is the program and the LLM is the interpreter.
ADL 2.0 define una taxonomía de tres categorías según la complejidad del sistema. Todas comparten la misma superficie de catálogo (manifest + metadata): un único repositorio puede indexar asistentes, compañeros de equipo y cursos de forma uniforme.
ADL 2.0 defines a three-category taxonomy by system complexity. All share the same catalog surface (manifest + metadata): a single repository can index assistants, teammates and courses uniformly.
AssistantSpec
Una sola entidad asistente en un archivo. Responde: ¿qué es este asistente? El runtime solo inyecta el contexto.A single assistant entity in one file. It answers: what is this assistant? The runtime only injects context.
KnowledgeSpec
Un compañero virtual cuyo conocimiento evoluciona, se versiona y se comparte. El runtime debe gestionarlo de forma independiente.A virtual teammate whose knowledge evolves, is versioned and shared. The runtime must manage it independently.
FlowSpec
Un sistema multicomponente con capas funcionales distintas que el runtime interpreta por separado.A multi-component system with distinct functional layers the runtime interprets separately.
Lo que separa los niveles no es la cantidad de conocimiento sino su ciclo de vida. Cuando el runtime debe gestionar el conocimiento de forma independiente a la especificación —porque evoluciona, se comparte entre varios o se genera durante la operación— se ha cruzado de AssistantSpec a KnowledgeSpec. Y cuando hay componentes con roles funcionales distintos —motor, pedagogía, evaluación— que se interpretan por separado, estamos en FlowSpec. What separates the levels is not the amount of knowledge but its lifecycle. When the runtime must manage knowledge independently of the spec — because it evolves, is shared, or is generated during operation — we have crossed from AssistantSpec into KnowledgeSpec. And when there are components with distinct functional roles — engine, pedagogy, assessment — interpreted separately, we are in FlowSpec.
TMDL (TeamMate Description Language) describe entidades basadas en LLM que colaboran con equipos humanos en proyectos intensivos en conocimiento. No define solo qué es el compañero (identidad, rol, límites), sino cómo participa: su estilo de contribución, sus protocolos de interacción y cómo gestiona un conocimiento que cambia. TMDL (TeamMate Description Language) describes LLM-based entities that collaborate with human teams on knowledge-intensive projects. It defines not only what the teammate is (identity, role, boundaries) but how it participates: its contribution style, interaction protocols, and how it manages evolving knowledge.
Su aportación distintiva es el modelo de ciclo de vida del conocimiento con tres dimensiones ortogonales: Its distinctive contribution is the knowledge lifecycle model with three orthogonal dimensions:
¿De dónde viene? pre-existing · in-progress · generated.Where it comes from: pre-existing · in-progress · generated.
¿Qué puede hacer con él? read · read-write · create.What can it do with it? read · read-write · create.
¿Quién lo ve? private · shared.Who can see it? private · shared.
Estas tres dimensiones se componen (3 × 3 × 2 = 18 combinaciones) en lugar de enumerar una taxonomía plana. Un manifiesto de conocimiento separado (team_knowledge_manifest.yaml) declara el entorno compartido del equipo, independiente de cualquier compañero concreto.
These three dimensions compose (3 × 3 × 2 = 18 combinations) rather than enumerating a flat taxonomy. A separate knowledge manifest (team_knowledge_manifest.yaml) declares the team's shared environment, independent of any single teammate.
TMDL ocupa deliberadamente un espacio entre dos paradigmas. En el conversacional (actual), el YAML se ensambla en un prompt: los límites son sugerencias de comportamiento y los campos de ciclo de vida son anotaciones informativas. En el agéntico (emergente), el mismo YAML define una entidad con estado: los límites se vuelven restricciones aplicadas, los controles de acceso se vuelven permisos reales y el manifiesto se vuelve una capa de coordinación activa. El YAML no cambia; cambia el modelo de aplicación. TMDL deliberately occupies a space between two paradigms. In the conversational (current) one, the YAML is assembled into a prompt: boundaries are behavioral suggestions and lifecycle fields are informational annotations. In the agentic (emerging) one, the same YAML defines a stateful entity: boundaries become enforced constraints, access controls become real permissions, and the manifest becomes an active coordination layer. The YAML does not change; the enforcement model does.
En TDL (nivel 3) y en el TMDL en evolución (nivel 2) emerge una estructura tipo manifiesto. No es casualidad: el manifest es el primitivo que hace posible la transición al paradigma agéntico sin ruptura arquitectónica. Hoy es declarativo y pasivo —dice qué cargar y en qué orden—. Mañana se convierte en una especificación de orquestación: qué agentes existen, qué autoridad tiene cada uno, qué puede hacer de forma autónoma y qué requiere coordinación. In TDL (level 3) and the evolving TMDL (level 2), a manifest-like structure emerges. This is not coincidental: the manifest is the primitive that makes the transition to the agentic paradigm possible without architectural rupture. Today it is declarative and passive — it says what to load and in what order. Tomorrow it becomes an orchestration specification: what agents exist, what authority each has, what each can do autonomously, and what requires coordination.
De forma paralela, los límites deben distinguir lo normativo de lo ejecutado: should_not (guía de comportamiento inyectada en el prompt) frente a cannot (restricción dura aplicada por la infraestructura, imposible de violar). Es la capa de seguridad que debe resolverse antes de operar con seguridad en un contexto genuinamente agéntico.
In parallel, boundaries must distinguish normative from executed: should_not (a behavioral guide injected into the prompt) versus cannot (a hard constraint enforced by infrastructure, impossible to violate). This is the safety layer that must be resolved before operating safely in a genuinely agentic context.