compound-docs

Generate YAML frontmatter documentation by applying a validated frontmatter schema against captured problem data. The workflow requires this schema to organize the module name, symptom, root cause, and solution fields into structured markdown files under docs/solutions/<category>/ for reliable knowledge base generation.

YAML frontmatter improves knowledge base searchability by structuring solved problem details into validated metadata fields like module name, symptom, and root cause. This enables fast lookup and category-organized documentation across docs/solutions/<category>/ directories.

The best way to structure problem-solution knowledge capture is a templates-driven doc generation workflow that organizes files into docs/solutions/<category>/ directories. This applies after problem confirmation, capturing the module name, symptom, root cause, and solution into validated YAML frontmatter for scalable knowledge bases.

Yes, you need a frontmatter schema and a templates-driven doc generation workflow before generating docs. The schema validates the captured module name, symptom, root cause, and solution fields to ensure the generated markdown files under docs/solutions/<category>/ remain searchable and structured.