Convenciones de Nombrado — ZeroQ Knowledge Base

Reglas Generales de Archivos

Reglas de Carpetas

• Las carpetas usan PascalCase o kebab-case con guiones.
• Los prefijos numéricos (00-, 01-, etc.) definen el orden de lectura.
• Subcarpetas de clientes usan el nombre formal del cliente: 05-Clients/ClienteABC/.

Reglas de Tags en Frontmatter

• type: siempre en minúsculas, singular.
• status: solo valores permitidos → draft, approved, deprecated.
• criticality: solo valores permitidos → low, medium, high, mission-critical.
• environment: solo valores permitidos → prod, staging, shared, dedicated.
• related_services: lista de [[wikilinks]] a otros servicios.
• depends_on: lista de [[wikilinks]] a dependencias técnicas.

Reglas de Contenido

• Un servicio = un archivo. Nunca se documenta un servicio en múltiples archivos.
• No se duplica información. Se referencia con [[wikilinks]].
• Las relaciones se declaran en metadatos, no copiando texto.
• Toda integración tiene su propio archivo en 01-Architecture/Integrations/.
• Todo cliente con entorno dedicado tiene su subcarpeta en 05-Clients/.
• Feature no documentada = feature no terminada.
• Cambio sin actualización de documentación = cambio no aprobado.

Reglas de Wikilinks

# Correcto
related_services:
  - "[[SVC-Queue-Engine]]"
  - "[[SVC-Notification-Service]]"

# Incorrecto
related_services:
  - Queue Engine
  - "ver archivo de notificaciones"

Reglas de Revisión