Architecture Decision Records

Formal, versioned records of technical decisions made within a project.

What is an ADR?

An ADR (Architecture Decision Record) captures the context, decision, and consequences of a significant technical or architectural choice. In Nexus, ADRs are first-class entities with a review lifecycle:

draft → under_review → accepted / rejected

ADRs are searchable via kb_search and surface in agent context at session start via kb_memory.

Creating an ADR

/nexus-adr-draft

Or via MCP tool directly:

{
  "tool": "adr_create",
  "title": "Use Supabase RLS for row-level access control",
  "context": "...",
  "decision": "...",
  "consequences": "..."
}