hads

HADS format is a structured documentation standard that optimizes text for token-efficient AI reading. It requires a frontmatter with name and description, an AI manifest, and properly formatted SPEC and BUG blocks to ensure reliable AI interpretation.

You validate HADS compliance by checking documents for required frontmatter, an AI manifest, and properly formatted bolded SPEC, NOTE, and BUG blocks. This ensures your documentation meets the standard for AI reading rules and automated quality checks.

Token-efficient documentation formatting structures text into standardized blocks to reduce token consumption during AI processing. You need it when converting technical docs like READMEs to enable reliable AI interpretation and automated quality checks.

The best way to structure technical docs with SPEC and BUG blocks is converting existing Markdown into HADS format. This adds an AI manifest and frontmatter, creating a standardized structure that enables reliable AI interpretation and automated quality checks.

Converting Markdown to HADS format requires no external dependencies. You can structure content into SPEC, NOTE, and BUG blocks and validate frontmatter directly without installing prerequisite packages or configuring environment setup.