Handbook

ADR — Architecture Decision Record

Dated decision log capturing context, decision, and consequences — common in fp and product repos.

What it is

Markdown ADRs under docs/adr/ or architecture folders. Referenced in Platform handbook.

When people say this

When recording irreversible technical choices, Cockpit strangler paths, or platform contracts.

Where it lives

forge-platform/docs/; product docs/adr/

How it fits the ecosystem

Ember Log captures product decisions; ADR captures technical architecture decisions.

Typical usage in plans and chat

Large (L/XL) cross-cutting plans should call out whether a new ADR is required on merge.

ARCH
fp

Term page — canonical catalog entry adr.