Authoring Guides

Agent-oriented writing templates for Doc Driven Development.

These guides are designed to be copied into your repository and referenced by AI agents before authoring documents. They provide structured templates, constraints, and examples that help agents produce consistent, high-quality documentation.

How to Use These Guides

1. Copy to your repo: Place relevant guides in your project's docs/ or .ai/ directory
2. Reference in prompts: Tell your agent to "read the spec writing guide before creating SPEC.md"
3. Maintain consistency: Use across projects to build a library of well-structured documents

Available Guides

• Spec Writing: Structure, examples, and validation to make behavior falsifiable
• Plan Writing: Step templates and TDD discipline for actionable plans
• Kickoff Writing: "Napkin physics" approach to project initialization
• README Writing: Concise orientation docs for internal libraries
• Learnings Writing: Capturing evidence, pivots, and architectural insights

Each guide includes templates, constraints, anti-patterns, and real examples to help agents author documents that integrate seamlessly with the DocDD workflow.