Arch-Decision – A multi-agent architecture tool for Claude Code (github.com)

Arch-decision is an innovative open-source AI orchestrator designed to streamline the creation of Architecture Decision Records (ADRs) within software codebases. By analyzing a codebase in under five minutes, it generates formal documentation that captures the rationale behind architectural decisions immediately after an issue is raised. This tool is particularly significant for the AI/ML community as it addresses the common problem of lost knowledge when decisions are not documented, which can lead to repetitive discussions and errors as new engineers join teams. The arch-decision tool operates through a multi-agent architecture that intelligently breaks down the ADR creation process into eight phased activities. It utilizes parallel agents to explore prior art, impact mapping, and constraints, culminating in tailored approach recommendations and trade-off tables—all subject to human approval before finalizing the documents. This interactive system not only ensures thorough documentation but also encourages collaboration among developers while preserving the nuances of each decision. By establishing a structured and efficient way to document architectural choices, arch-decision enhances team understanding and continuity, ultimately elevating the quality of software projects across various programming languages and frameworks.