solo-audit

You can audit a markdown knowledge base by scanning for missing frontmatter, broken links, and orphaned files to generate actionable remediation guidance. This process validates YAML frontmatter presence and field consistency across your documentation corpus.

Knowledge base health auditing is the process of validating documentation quality by checking frontmatter, links, tags, and structure. It detects missing YAML frontmatter, broken internal links, tag inconsistencies, orphaned files, and coverage gaps across markdown files.

To check for orphaned files and tag inconsistencies, run a full health audit on your markdown corpus. The audit performs link integrity verification and tag normalization to identify unlinked files and standardize tag usage across the knowledge base.

Yes, you can configure validation checks using the optional ARGUMENTS parameter when auditing frontmatter consistency. This allows you to customize deterministic checks for YAML field presence, link verification, tag normalization, and orphaned-file detection based on your specific requirements.

The knowledge base audit tool works with any markdown-heavy project and requires no external dependencies. It applies deterministic checks directly to your documentation corpus to validate frontmatter, links, tags, and structural consistency without needing additional frameworks.

The best way to normalize tags and verify link integrity is running a comprehensive health audit that applies deterministic checks across all markdown files. This generates an actionable remediation report highlighting tag inconsistencies and broken links for systematic resolution.