        
        Pre-launch — join the waitlist
      

Your codebase remembers why.

Decision Ledger keeps Architectural Decision Records where they belong — in your repo, in your editor, in your workflow. Never lose the reasoning behind a decision again.

View the docs → Join waitlist

$ npx decision-ledger init

docs/adr/0042-adopt-event-sourcing.md

# ADR-0042: Adopt event sourcing for orders
 
status:   accepted
date:     2026-06-14
deciders: @mika, @tomasz
supersedes: ADR-0017
 
## Context
Order state transitions are audited by
finance and disputed by support. CRUD
history reconstruction is lossy.
 
## Decision
Persist order lifecycle as an event
stream; project read models per team.
 
## Consequences
+ Full audit trail, replayable
- Higher onboarding cost for new devs

// decisions are code. version them like it.

        plain markdowngit-nativezero lock-in
      

01 — How it works

From "why did we do this?" to a searchable ledger.

{{ step.num }}

{{ step.cmd }}

02 — In your editor

Decisions surface where the code lives.

The VS Code extension links ADRs to the files and symbols they govern. Hover a module and see the decision that shaped it — status, date, and the trade-offs your team accepted.

▸ {{ pt }}

orders/service.ts adr/0042.md

14  export class OrderEventStore {

              
              ADR-0042 · accepted
            
Adopt event sourcing for orders. Supersedes ADR-0017.
Open record ⌘⇧A
15    async append(event: OrderEvent) {
16      await this.stream.write(event);
17    }
18  }

03 — Features

Everything a decision needs. Nothing it doesn't.

{{ f.tag }}

04 — The format

Plain markdown. Yours forever.

Every record is a markdown file in your repo. Readable in any editor, diffable in any PR, greppable at 3am. Decision Ledger adds structure, linking, and lifecycle — not a proprietary format.

docs/adr/ 47 records · 3 proposed

            
                {{ file.id }}
                {{ file.name }}
                {{ file.status }}

05 — FAQ

Questions

$ join --waitlist

Stop losing the why.

Decision Ledger is in private preview. Leave your email and we'll onboard you with your first ten ADRs migrated free.

✓ You're on the list. Watch your inbox.

error: enter a valid email address