ADR.Bot

The tool examines a repository, automatically detecting its languages, frameworks and existing conventions to build a precise taxonomy without any manual configuration. It then retrieves best‑practice Architectural Decision Records (ADRs) that match the identified stack and writes them into context files such as CLAUDE.md, AGENTS.md or Cursor rules, keeping those files synchronized on each run.

By storing ADRs in shared context files, the software ensures that all AI coding agents work from the same architectural constraints, preventing drift and inconsistent patterns across pull requests. The generated guardrails act as hard constraints for the agents, helping them produce code that aligns with the team’s decisions.

It can be installed via a single Homebrew command on macOS and Linux, run with npx where Node is available, or added through the OpenClaw skill manager, making it usable locally or in CI pipelines. Supported frameworks include TypeScript/Next.js, HeroUI, Rust/Ratatui, Python/FastAPI, Django, Java, and Spring Boot.