🤝 CABECERA DE AUDIENCIA: MIXTO (IA + Humano)
Esta regla técnica la leen tanto los diseñadores/agentes de IA (para aplicar la cabecera al programar y auditar) como el personal humano (para saber cómo marcar sus documentos). Es, en sí misma, un ejemplo de documento mixto.
Esta regla técnica la leen tanto los diseñadores/agentes de IA (para aplicar la cabecera al programar y auditar) como el personal humano (para saber cómo marcar sus documentos). Es, en sí misma, un ejemplo de documento mixto.
Regla Técnica · Módulo de Gestión de Calidad · Cat. 14
RT-34 · Cabecera de Audiencia Documental
Todo artículo o elemento de producción debe declarar, en una cabecera al inicio, para quién está escrito: IA, humano o ambos.
RT-34 Rev. 2 · Julio 2026 Transversal · aplica a todo el ecosistema
Para qué existe. Un mismo repositorio (Producción / KBX) alimenta a dos lectores muy distintos: los agentes de IA y desarrolladores que construyen el ERP a partir de la documentación, y las personas que la consultan como guía. Lo que ayuda a uno puede estorbar al otro: el adorno visual que hace amena una guía humana es ruido para un modelo que lee para programar. Esta regla obliga a que cada documento declare su audiencia, para que se escriba y se consuma de la forma correcta.
1. Los tres tipos de audiencia
Todo artículo declara uno de estos tres tipos en una cabecera al inicio:
| Tipo | Para quién | Cómo se escribe |
|---|---|---|
| 🤖 Directriz de IA / Arquitectura | Desarrolladores y agentes de IA que construyen o auditan el ERP. No es manual para el usuario final. | Limpio y semántico: encabezados claros, listas y tablas simples, prosa directa, cero adorno superfluo. El contenido debe ser fácil de procesar por una máquina. |
| 👤 Guía Humana / Operativa | Usuario final, cliente o personal operativo que consulta el documento como guía. | Puede llevar presentación rica: hero, callouts de color, iconos, ejemplos visuales. La prioridad es la claridad y el atractivo para una persona. |
| 🤝 Mixto (Ambos) | Sirve a los dos lectores a la vez. | Equilibrio: presentación cuidada pero sin sacrificar la limpieza semántica. Adorno moderado, prosa directa, estructura impecable. |
2. La cabecera
La cabecera se coloca al inicio del artículo, antes del hero o del título. Es un bloque breve que indica el tipo y, en una frase, a quién sirve y a quién no. Modelo:
🤖 CABECERA DE AUDIENCIA: DIRECTRIZ DE IA
Documento de arquitectura para desarrolladores y agentes de IA. Instruye cómo programar/estructurar. No es un manual operativo para el usuario final.
Documento de arquitectura para desarrolladores y agentes de IA. Instruye cómo programar/estructurar. No es un manual operativo para el usuario final.
Los tres modelos de cabecera (🤖 / 👤 / 🤝) usan el mismo formato, cambiando el icono, el título y la frase descriptiva.
3. Obligatoriedad
- La cabecera es obligatoria en todo artículo o elemento de producción, según los Requerimientos Mínimos del Código de Estructura Estándar (sección de requisitos mínimos).
- Un artículo sin cabecera de audiencia se considera incompleto y no debe estar en estado «Publicado».
- El Protocolo de Auto-Auditoría verifica su presencia como parte del barrido.
4. Alcance (qué NO cubre esta regla)
Esta RT gobierna únicamente el eje de audiencia (para qué lector se escribe). No se mezcla con otros ejes de clasificación:
- Estado del documento (vivo/editable en la Base del Conocimiento vs. archivado/fijo en PDF en Archivología) — es un eje independiente.
- Nivel de acceso (N1–N6, quién tiene permiso de verlo) — lo define «Niveles de Instructivos — Acceso por Perfil de Usuario».
Un documento puede combinar valores de los tres ejes: por ejemplo, «🤖 Directriz de IA · vivo · N6».
5. Información relacionada
- 🔍 Protocolo de Auto-Auditoría de Consistencia y Enlaces — verifica en cada barrido que este artículo (y todos) declaren su audiencia. Referencia cruzada bidireccional.
- RT-35 · Procedimiento para Crear y Actualizar Procedimientos — norma hermana de redacción; la cabecera de audiencia es uno de los requisitos que exige.
- RT-32 · Producción como Fuente de Verdad del ERP — norma hermana; su cabecera es el ejemplo vivo de una Directriz de IA (🤖).
- ⭐ Código de Estructura Estándar de Manuales y Módulos — donde la cabecera figura como requisito mínimo de todo artículo.
- Niveles de Instructivos — Acceso por Perfil de Usuario — el eje independiente de acceso (N1-N6).