Writing Effective Design Documents

When the user asks to create a design, follow a structured workflow with explicit approval gates. Generate design documents following AWS best practices.

Purpose

This guide provides structured instructions for creating clear, effective engineering design documents. A good design document:

📝 Note: This document focuses on technical design documents for software engineering implementations. For business narratives and decision-making documents, see narrative-writing documentation.

1. Communicates ideas and transfers knowledge to the team
2. Convinces stakeholders of the value of your approach
3. Solicits feedback to improve the design before implementation
4. Facilitates thinking through complex problems in a structured way
5. Enables collaboration by creating shared understanding

Document Structure and Format

Formatting Standards