What problem does it solve?
Traditional Markdown documents are optimized for human readability but often poorly parsed by AI models, leading to missed context, misinterpreted key decisions, and incorrect extraction of structured data from technical documentation.
Core Features & Use Cases
- Semantic Heading Markers: Label document sections with tags like [CONTEXT], [DECISION], and [RATIONALE] so AI can instantly identify content types without reading full paragraphs.
- AI-Visible Annotation Blocks: Add context-rich notes for AI to highlight critical warnings, cross-references, and background information without disrupting human reading flow.
- Structured Data Annotations: Tag table columns with explicit data types for accurate AI parsing, plus lightweight ADR templates to standardize architecture decision records.
- Use Case: A development team can use HADS to format their API design documents so both new engineers and AI coding assistants can quickly locate authentication requirements, decision rationales, and pending tasks without confusion.
Quick Start
Use the hads skill to convert your existing product requirement document into HADS format with semantic headings and AI annotation blocks.