AI Documentation Standards

Name: AI Documentation Standards
Availability: InStock
Author: randalmurphal

Standardize AI-focused documentation with structured formats and hierarchical CLAUDE.md inheritance.

Updated Sep 8, 2025

Search Tags:#documentation #ai #structure #CLAUDE.md #hierarchy

Ready to run

npx skills add https://github.com/randalmurphal/claude-config --skill ai-documentation-standards

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: AI Documentation Standards
Source: https://github.com/randalmurphal/claude-config/tree/main/skills/ai-documentation
Command: npx skills add https://github.com/randalmurphal/claude-config --skill ai-documentation-standards

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Write AI-readable documentation following concise-over-comprehensive principle, hierarchical CLAUDE.md/AGENTS.md inheritance (100-200 line rule), structured formats (tables over prose), parallel validation, and session knowledge capture. Use when writing documentation, updating docs, or optimizing existing docs.

Core Features & Use Cases

Concise over Comprehensive: AI-friendly summaries with strict boundaries.
Hierarchical Inheritance: CLAUDE.md levels to minimize duplication.
Structured Formats: Tables, bullets, and references for AI parsing.

Quick Start

Create overview and architecture docs with 100-200 lines, reference.md for details, and CLAUDE.md for hierarchy guidance.

Frequently Asked Questions about AI Documentation Standards

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I write documentation that AI can read and parse effectively?▼

AI-readable documentation requires concise, structured formats with clear hierarchy. Use tables over prose, enforce file:line references, apply the 100-200 line rule per document, and maintain consistent terminology. This standard ensures AI systems can extract context and traverse codebases reliably without ambiguity or verbosity.

What's the best way to organize documentation for large monorepos?▼

Organize with hierarchical CLAUDE.md/AGENTS.md inheritance to minimize duplication across levels. Create overview and architecture docs (100-200 lines each), use reference.md for detailed specifications, and apply structured formats consistently. This approach scales documentation maintenance across complex systems while keeping AI context windows efficient.

How do I reduce documentation size while keeping it complete for AI systems?▼

Apply the concise-over-comprehensive principle: strip explanatory filler, use structured tables instead of prose, and enforce strict line limits per file. Reference external docs rather than duplicating content, and capture session knowledge concisely. This produces machine-readable summaries optimized for AI parsing without sacrificing necessary detail.

Can I update existing documentation to be AI-friendly without rewriting everything?▼

Yes. Convert existing docs incrementally: extract prose into structured tables, add file:line references, enforce the 100-200 line rule, and establish CLAUDE.md hierarchy. Parallel validation ensures compliance. You can optimize current documentation in place while maintaining readability for both AI and human audiences.

What documentation formats work best for AI parsing in complex systems?▼

Structured formats—tables, bullet lists, and explicit references—outperform prose for AI extraction. Pair these with location references (file:line), hierarchical CLAUDE.md guidance, and consistent terminology. These formats enable reliable parsing across monorepos and reduce context needed for AI to understand codebase relationships and architecture.

Why use hierarchical inheritance in documentation rather than flat structure?▼

Hierarchical CLAUDE.md/AGENTS.md inheritance eliminates duplication and creates inheritance chains that AI can traverse. Each level maintains 100-200 lines, reducing redundancy and context load. This approach ensures AI systems access the right level of detail without parsing duplicate information across files, improving both efficiency and accuracy.