$ actual adr-botSave 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.
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/actualInstalls the native binary. Run actual adr-bot from any repo.
npx
Zero install
npx @actualai/actual adr-botNo install needed. Works anywhere Node is available — great for CI and quick tries.
Clawhub
OpenClaw
clawhub install actualInstalls the skill, which will install the binary automatically. Should reduce token usage by downloading ADRs when new repositories are created.
Supported Frameworks
Works with your
stack
Curated ADR banks for every framework below — so architectural decisions are always tailored to your tech.
Next.js
HeroUI
Ratatui
FastAPI
Django
Spring Boot
Next.js
HeroUI
Ratatui
FastAPI
Django
Spring Boot