Saltar al contenido principal

Document Lifecycle

Objetivo​

Mantener una sola fuente de verdad para documentación: documents/.

Flujo único​

Paso a paso​

  1. Crear/editar documento en documents/{category}/.
  2. Validar estructura:
npm run validate-structure
  1. Generar índice unificado (MCP + Site):
npm run docs:index
  1. Verificar end-to-end:
npm run docs:check

Qué hace cada comando​

  • validate-structure: valida frontmatter y reglas editoriales.
  • docs:index: genera mcp/metadata/docs-index.v2.json y copia a site/static/search/docs-index.v2.json.
  • docs:check: corre validación, indexado, build de site y contract tests de MCP.

Criterios de calidad​

  • Frontmatter completo y válido.
  • IDs únicos.
  • Idioma (lang) correcto para el contenido.
  • ai_expose definido según política.
  • Build del sitio y contrato MCP en verde.

Política de edición​

  • Editar solo documents/.
  • No hay carpeta de documentos duplicados para IA.