decision-log

An Architecture Decision Record (ADR) is a structured text document that captures a decision's context, options, and consequences. A decision journal maintains these numbered Markdown records to help teams avoid re-litigating settled questions and track review schedules.

To create a decision record, run a Python script command specifying the title and context. The system generates a numbered Markdown document following the ADR pattern, documenting the status, alternatives considered, final decision, and consequences for team review.

Yes, you can manage team decision records using only Python 3.11 or higher. This decision journal requires no external dependencies, handling text and Markdown-based decision documents natively to ensure records are searchable and self-contained.

The best way to search past decisions is using the built-in search functionality across all Markdown decision records. You can set up review schedules within the decision metadata to ensure past decisions are periodically evaluated and kept up-to-date.

You need to document decisions in an ADR format when a team requires a durable record of what was decided, the rationale behind it, alternatives considered, and when the decision should be reviewed. This prevents knowledge loss and recurring debates.

Yes, this decision management tool works for both AI agents and human teams. It maintains a searchable, structured record of decisions that integrates into automated workflows while remaining readable as standard Markdown text for human collaborators.