Decision Record

Turn a trade-off into a clean ADR that captures the why.

Turns a discussion into a one-screen ADR

Captures context, options, and the real trade-off

Records consequences — what gets harder, not just easier

Sets a 'revisit when' trigger for the future team

See it in action

What actually happens

claude

❯/decision-record:log we picked Postgres over DynamoDB for the core store — relational data, small team, no global scale yet

Decision Record turns a discussion or trade-off into a lightweight Architecture Decision Record — the kind that tells a future teammate why a call was made, not just what was built.

It captures the context and constraints, the options that were actually on the table, the honest consequences, and a trigger for when the decision should be reopened. One screen, ready for a docs/adr folder or Notion.

What it does

Records the decision, options, and trade-off
Names what gets harder, not just easier
Sets a clear 'revisit when' signal