Skip to content
DashboardWebsite

Turn an ADR into a rule

Open in the dashboard

When you are done: a decision your team wrote down is a rule every pull request is checked against.

  1. Open your repository, then its Knowledge tab.

    The repository's Knowledge tabThe repository's Knowledge tab
  2. Turn on Read ADRs from this repository and click Sync now. Each decision becomes a draft rule.

    The ADR file read, with one proposalThe ADR file read, with one proposal
  3. Open Rules, then the tab of rules to review, and open the file the draft came from.

    A drafted rule, next to the decision it came fromA drafted rule, next to the decision it came from
  4. Read the draft next to the decision, then click Apply. Nothing applies on its own.

    The rule appliedThe rule applied
  • Nothing is applied on its own: a person applies each draft.
  • Agent instruction files, such as CLAUDE.md, are read the same way.

Rules from ADRs explains how it works, and how to do it from the API.