blueprints-writing

Installation
SKILL.md

Writing Technical Blueprints

Purpose

Technical blueprints document how systems work internally. They differ from user documentation (how to use) and README files (project overview).

When to Write Blueprints

Write blueprints for:

  • Complex systems with multiple components
  • Public APIs and their contracts
  • Architecture decisions and their rationale
  • Behavior that isn't obvious from code
  • Integration points between systems

Skip blueprints for:

  • Self-documenting code (simple utilities)
Related skills
Installs
17
GitHub Stars
150
First Seen
Jan 22, 2026