Actual AI Logo
Actual AI
Open menu
$ actual adr-bot

Save tokens. Skip steps. Generate better code.

ADR bot analyzes your repo and downloads best-practice Architectural Decision Records (ADRs) for your chosen frameworks to keep every coding agent aligned, automatically.

Install Now
actual-software/actualADR.Bot - Best practice ADRs for coding agents | Product Hunt
actual adr-bot

Supported Frameworks

Works with your

stack

Curated ADR banks for every framework below — so architectural decisions are always tailored to your tech.

TypeScript

Next.js

Next.js logo
TypeScript

HeroUI

HeroUI logo
Rust

Ratatui

Ratatui logo
Python

FastAPI

FastAPI logo
Python

Django

Django logo
Java

Spring Boot

Spring Boot logo
TypeScript

Next.js

Next.js logo
TypeScript

HeroUI

HeroUI logo
Rust

Ratatui

Ratatui logo
Python

FastAPI

FastAPI logo
Python

Django

Django logo
Java

Spring Boot

Spring Boot logo

How it works

Three steps to

architecturally aligned agents

Codebase Analysis

Understand your repo instantly

actual inspects your languages, frameworks, and existing conventions to build a precise taxonomy — no manual config required.

Context File Management

Context files that stay in sync

Architectural Decisions are fetched, tailored to your codebase, and written into CLAUDE.md, AGENTS.md, or Cursor rules — updated on every sync.

Architectural Guardrails

Keep every agent on the same page

Your team's decisions become hard constraints for AI agents. No more architectural drift, no more inconsistent patterns across PRs.

Installation

Up and running in

one command

Homebrew

macOS & Linux

brew install actual-software/actual/actual

Installs the native binary. Run actual adr-bot from any repo.

npx

Zero install

npx @actualai/actual adr-bot

No install needed. Works anywhere Node is available — great for CI and quick tries.

Clawhub

OpenClaw

clawhub install actual

Installs the skill, which will install the binary automatically. Should reduce token usage by downloading ADRs when new repositories are created.

Frequently asked questions

The CLI brings your architectural guardrails to the terminal. It analyzes your repository, pulls the right Architecture Decision Records for your stack, and writes them into the context file your AI coding agent reads. After that, every agent working in the repo stays aligned with your architecture automatically.
Install it with Homebrew (brew install actual-software/actual/actual) or run it directly with npx. Authenticate once, then run actual adr-bot from any git repository to generate your context file. Re-run it whenever your architecture changes.
No. The CLI writes to the context file your agents already read, so once you've run it, your existing tools pick up the architecture rules with no extra setup.