Índice de agentes

Esta página explica cómo descubrir y citar contenido. El catálogo legible por máquina está disponible en /agent-index.json.

Modelo de navegación

La organización es dominio primero y Diátaxis dentro de cada dominio:

<dominio>/
├── tutorials/    aprender un recorrido completo
├── how-to/       completar una tarea concreta
├── explanations/ entender contexto, diseño y decisiones
└── reference/    consultar contratos e inventarios

La interfaz muestra estos cuatro tipos como Tutoriales, Guías prácticas, Explicaciones y Referencia. Una sección puede estar vacía o marcada como skeleton cuando todavía no existe contenido respaldado por fuentes.

Identificadores estables

Cada página canónica tiene un docId estable. Los identificadores no dependen del título visible y permiten enlazar una página aunque cambie su ubicación de navegación.

docs.use-cases.atc.public.features.cambiar-datos
docs.use-cases.atc.internal.agents.cambio-datos
docs.use-cases.super-app.explanations.dispatcher
docs.account.apps.dashboard-atc
docs.agent-guide.skills.update-account-docs

Usa los identificadores para las referencias entre agentes y las rutas para los enlaces destinados a personas.

Contrato de metadatos

Campo	Significado
`docId`	Identificador estable para máquinas
`domain`	Dominio principal: `atc`, `super-app`, `operations`, `account`, `method`, `agent-guide`, `reference` o `shared`
`diataxis`	Tipo de contenido: `tutorial`, `how-to`, `explanation` o `reference`
`scope`	Área de propiedad histórica y compatibilidad
`useCase`	`atc`, `super-app` u `operations` cuando la página pertenece a un caso de uso
`audience`	Audiencia prevista: `public`, `internal` o `shared`
`kind`	Función de la página: `domain-index`, `section-index`, `feature`, `agent`, `workflow` u otro tipo declarado
`status`	`canonical`, `generated`, `working` o `skeleton`
`keywords`	Términos de búsqueda que un agente puede usar para localizar la página
`reviewedAt`	Fecha de la última comprobación de una página o inventario temporal

La audiencia es un contrato de lectura, no un mecanismo de autorización. La protección del acceso se decide en la capa de publicación y no se deduce de estas etiquetas.

Consulta por tarea

Tarea	Empieza aquí
Elegir un dominio de caso de uso	Casos de uso
Entender ATC	Explicaciones de ATC
Ejecutar una tarea de ATC	Guías prácticas de ATC
Consultar una capacidad de ATC	Capacidades de ATC
Encontrar un módulo de agente	Agentes de ATC
Comprobar Super App	Mapa de Super App
Comprobar Operaciones	Mapa de Operaciones
Entender la cuenta	Explicaciones de cuenta
Mantener la documentación	Guías del método
Trabajar como agente	Guías de agentes
Consultar términos	Glosario
Comprobar procedencia	Procedencia y vigencia

Propiedad de los índices

use-cases/index cataloga los dominios de casos de uso.
Cada dominio de caso de uso tiene su mapa y sus cuatro entradas Diátaxis.
Cuenta, Método y Agentes repiten el mismo patrón a su propio nivel.
reference/agent-index documenta el contrato; agent-index.json es el catálogo legible por máquina.
La procedencia y la vigencia se explican en Procedencia y vigencia.