Skip to content

Architecture Decision Records

Architecture Decision Records capture choices that shape Harrier's public contracts, safety model, runtime architecture, and operational posture.

When To Add An ADR

Add an ADR when a change:

  • Alters MCP tool inputs, outputs, or lifecycle.
  • Changes AWS, Kubernetes, GitHub, or storage permissions.
  • Adds a supported runtime or changes the evidence model.
  • Changes report semantics in a way clients or operators may rely on.
  • Introduces a new deployment or release pattern.

Format

Use this structure:

# ADR N: Title

## Status

Accepted, proposed, superseded, or deprecated.

## Context

What problem or constraint led to the decision?

## Decision

What did we choose?

## Consequences

What improves, what gets harder, and what must be watched?

Records