Frontmatter Standard

Overview

Todos los documentos en documents/ deben incluir frontmatter YAML para que Site y MCP usen el mismo contrato.

Required Fields

---
id: unique-document-id
title: Document Title
category: development | business | design | architecture | guides
lang: es | en
ai_expose: true | false
---

Optional Fields

---
# ... required fields ...
tags: [tag1, tag2]
audiencia: [frontend, backend, fullstack, pm, qa, devops, todos]
tecnologias: [React, NestJS, TypeScript]
tipo: guia | referencia | template | feature | workflow | prompt | arquitectura | diseño
related: [another-doc-id]
description: Breve resumen
---

Field Notes

• id: único en todo el repositorio.
• category: taxonomía principal para navegación y filtros.
• lang: idioma real del documento (es o en).
• ai_expose: si es false, el documento queda fuera del índice MCP.

Language policy (editorial)

• Técnicos/código (especialmente development): preferencia en.
• Compañía/procesos (business): preferencia es.
• Estas reglas son editoriales (warning), no bloqueo duro.

Example

---
id: backend-api-standards
title: Backend API Standards (NestJS)
category: development
lang: en
ai_expose: true
tags: [backend, nestjs, api, standards]
audiencia: [backend, fullstack]
description: Standards for NestJS APIs
---

Validation

npm run validate-structure