Write Documentation

Documentation that is scannable, consistent, and actionable for AI agents.

Structure

• Max 150 lines per file, one concept per file
• Start with description: in YAML frontmatter
• Add TL;DR section at top with most-needed info

Content

• No duplicates (define once, link elsewhere)
• Use tables for structured data (parameters, config)
• Concrete examples for everything (copy-pasteable)
• Link to real code as templates

Naming