Skip to main content

Metadata obligatoria

Toda entry pública tiene que empezar con frontmatter YAML y declarar:
  • assetType fija el rail público donde vive la pieza.
  • sourceUrl tiene que ser la URL canónica pública del material que disparó el asset.

Reglas globales

  • Nada de placeholders (TODO, [insertar ...]).
  • Nada de URLs locales o privadas (localhost, 127.0.0.1, 0.0.0.0, rangos 10.x / 172.16-31.x / 192.168.x, *.local, *.internal).
  • Nada de claims factuales que no estén sostenidos por los moments fuente.
  • Cada pieza vive en un path canónico y la navegación de docs.json la publica bajo su grupo correcto.

File paths canónicos

  • Playbooks: growth/playbooks/<slug>.mdx
  • Guidelines: growth/guidelines/<slug>.mdx
  • Content: growth/content/<slug>.mdx

Plantilla: playbook

Plantilla: guideline

Plantilla: content

Por qué este contrato existe

Antes de este bootstrap, docs.json y la estructura on-disk eran una suposición difusa del app. Ahora son un contrato explícito: si una pieza no entra en este formato, el preflight la frena antes de abrir la branch de review.