> **Can't find what you're looking for?** Use `search_docs` on the docs MCP server at `https://naturgy-comer-documentation-p5mde.vercel.app/api/mcp` to find what you need.

# Abrir un caso de uso o una cuenta

Este tutorial describe cómo empezar una documentación respaldada por fuentes.
Se puede aplicar a un caso nuevo dentro de una cuenta existente o a una cuenta
nueva.

## Abrir un caso de uso

### 1. Confirmar que existe algo que documentar

Define el canal o sistema, el resultado que ofrece al cliente y la fuente que
permite comprobarlo. Si todavía es una propuesta, registra la decisión
pendiente en lugar de presentarla como una capacidad entregada.

### 2. Dibujar el mapa del dominio

Crea las cuatro secciones de contenido:

* tutoriales para aprender un recorrido;
* guías prácticas para una tarea conocida;
* explicaciones para contexto, diseño y decisiones;
* referencia para capacidades, agentes, métricas e inventarios.

Una sección puede quedar marcada como `skeleton` cuando no hay material
verificado para ella.

### 3. Escribir en orden

1. contexto y alcance;
2. capacidades y límites;
3. actores, herramientas y salidas;
4. decisiones transversales;
5. pruebas y métricas;
6. referencia de agentes;
7. índice de datos vivos, cuando exista.

Cada hecho debe tener un único propietario. Las páginas relacionadas enlazan con
él en lugar de duplicarlo.

### 4. Comprobar el sistema vivo

Antes de afirmar una versión, herramienta, componente o dato de producción,
compruébalo con la puerta de lectura correspondiente. Guarda el momento y el
alcance de la consulta. No copies cuerpos de instrucciones, credenciales ni
cargas confidenciales.

### 5. Cerrar el primer recorrido

Una persona que no participó en el proyecto debe poder responder qué problema
resuelve el caso, qué resultado obtiene el cliente y qué queda fuera. Si no
puede, vuelve al contexto antes de añadir más referencia técnica.

## Preparar una cuenta nueva

Recoge primero:

* nombre y alcance de la cuenta;
* organización y clúster;
* primer caso de uso;
* puertas de lectura y escritura disponibles;
* responsables de negocio y de la plataforma;
* fuentes autorizadas y su frecuencia de actualización.

Después repite el procedimiento anterior para el primer caso. Mantén las
convenciones reutilizables en el [método](/method) y el contexto específico en
las páginas de la cuenta.

## Criterio de salida

El alta está lista cuando existe un mapa de navegación, una página de contexto,
una primera página canónica respaldada por una fuente y una lista explícita de
preguntas pendientes. La publicación final se valida con [Validar una
publicación](/method/how-to/publish).