Technical Specification & Design Documents

Expert guidance for writing effective technical design documents, RFCs, Architecture Decision Records, and technology evaluation frameworks.

Core Philosophy

• Write before code — Design documents prevent costly rework and align teams
• Living documents — Keep docs updated as the system evolves
• Clarity over completeness — Simple, direct language reduces cognitive load
• Diagrams as code — Version-controlled, maintainable architecture diagrams
• Decisions over descriptions — Document why, not just what

Hard Rules (Must Follow)

These rules are mandatory. Violating them means the skill is not working correctly.

Alternatives Required