Naming¶
- Fichero:
<type>/<slug>.mdcon kebab-case (ej:platform/cilium/overview.md) - ID:
PREFIX-<SLUG>en UPPER_SNAKE oPREFIX-<NNNN>para series (ADR/RFC/INC/INV) - IDs globales e inmutables: sobreviven renombres de fichero
- Un documento = un ID; el ID nunca se reutiliza
Prefijos de ID¶
| Prefijo | Tipo | Estado | Dónde vive |
|---|---|---|---|
OBJ- |
Objetivo/contrato | oficial | operations/objectives/ |
SVC- |
Ficha de servicio | oficial | platform/<svc>/ |
ADR- |
Decisión arquitectónica | oficial | decisions/ |
RUN- |
Runbook | oficial | operations/runbooks/ |
REC- |
Registro operativo | oficial | records/ |
ART- |
Artifact/evidencia | oficial | raw/ / S3 |
DES- |
~~retirado por ADR-0016~~ — un diseño nuevo nace como ADR proposed | retirado (ADR-0016) | — |
ARCH- |
Arquitectura de infra/plataforma | legacy aceptado (docs) | infrastructure/, platform/edge |
PROC- |
Procedimiento | legacy aceptado (docs) | operations/procedures/ |
REF- |
Índice/referencia | legacy aceptado (docs) | index.md de dominios |
RFC/DES/INV/INC/CON/PROJ- |
graduales | se activan con el primer caso real | — |
Registro viviente con IDs asignados: records/id-registry.md.