Architecture Decision Records

An Architecture Decision Record (ADR) is a short document that captures a single architectural decision, the context behind it, the alternatives that were considered, and the consequences that follow. The goal is to give future engineers a clear answer to "why was this built this way?" without having to dig through Slack threads or old Google Docs. ADRs live in webapp/client/adrs/. Only write an ADR when the decision is final.

Creating an ADR

Use the Camunda create-architecture-decision AI skill. It guides you through the full workflow: source review, decision framing, drafting, file naming, and cross-referencing. Use it as the default way to create ADRs.