docgen ADR

Record a single architecture decision as an ADR — the context, the options, the choice, and its consequences — so the reasoning lives in the repo alongside the code.

When to Use

• "Record this decision"
• "Write an ADR for choosing Postgres"
• "Document why we picked X over Y"
• "Add an architecture decision record"
• Any time a significant, hard-to-reverse technical choice is being made

Prerequisites

The docs/ tree must exist (run docgen-init if not) and docgen must be installed (run docgen-install if not). ADRs live in docs/3-ENGINEERING/ADRs/.

Steps