What

Add standardized YAML frontmatter metadata to all markdown files in docs/
directories across 8 ecosystem projects (~578 files total).

Why

Without frontmatter metadata, it is impossible to programmatically track document
currency, ownership, or status. YAML frontmatter enables automated validation,
version tracking, and document registry management. This is a prerequisite for the
document audit tool.

Where

How

Frontmatter Schema

---
doc_id: "{PREFIX}-{CATEGORY}-{NNN}"
doc_title: "Document Title"
doc_version: "1.0.0"
doc_date: "YYYY-MM-DD"
doc_status: "Released"
project: "{project_name}"
category: "{category}"
---

Field Definitions

Project Prefix Table

Category Enum

Implementation Strategy

1. Create a Python script tools/add_frontmatter.py that:
   • Scans docs/ for .md files without frontmatter
   • Infers category from filename patterns
   • Generates doc_id from project prefix + category + sequential number
   • Adds frontmatter without modifying existing content
   • Outputs a summary report
2. Run script per-project, review output, commit
3. Validate with grep: grep -rL "^---" docs/*.md should return 0 matches

Acceptance Criteria

• tools/add_frontmatter.py script created in common_system
• All ~578 docs/ markdown files have valid YAML frontmatter
• All doc_id values follow {PREFIX}-{CAT}-{NNN} format
• No duplicate doc_id values within a project
• Existing document content unchanged (frontmatter prepended only)
• Script can be re-run idempotently (skips files with existing frontmatter)

Related

• Part of docs: Ecosystem documentation improvement — enterprise-level standardization #559 (Ecosystem documentation improvement)
• Prerequisite for SSOT registry and document audit tool