aget-healthcheck-kb

To run a knowledge base health check, validate the directory structure, frontmatter compliance, and content staleness. This process audits your markdown files and generates an overall health score with actionable maintenance alerts.

Knowledge base staleness assessment identifies markdown files that have not been updated beyond 90 and 180 days. It reports aging content with counts and percentages to help maintain freshness and ensure reliable, up-to-date guidance.

Validate frontmatter compliance by checking that each topic markdown contains the required metadata fields. The health check confirms structural layout and frontmatter rules to produce a conformance score for your knowledge base.

Yes, this knowledge base health check is explicitly suitable for periodic audits. It evaluates structural validation and content freshness over time, outputting an OK, WARN, or CRITICAL status to guide ongoing maintenance.

Your knowledge base must be organized under a knowledge directory containing a README and topic markdowns. The diagnostic validation confirms this specific layout exists before assessing frontmatter and content staleness.

A critical health score indicates severe knowledge base issues, such as missing structural elements like the README or high content staleness beyond 180 days. The diagnostic report provides actionable alerts to resolve these maintenance thresholds.