Skip to content

Architecture decision records

ADRs capture decisions that materially constrain public contracts, infrastructure, security, or maintenance. Copy the next numeric filename, state the context, decision, consequences, alternatives, and provenance, then submit it with the implementation.

Accepted ADRs are immutable except for status and links. A new ADR supersedes an old decision and explains migration implications.

Accepted decisions

  • ADR 0001: AWS ECS Fargate as the first certified runtime (GCP Autopilot later certified; see ADR 0007).
  • ADR 0002: Provider topology stays outside portable contracts.
  • ADR 0003: The finalized artifact manifest is external to the image.
  • ADR 0004: Provider-specific packages stay behind stable extension boundaries.
  • ADR 0005: Local development uses a generated Docker Compose execution context.
  • ADR 0006: GitHub CI and state recovery use separate trusted roles.
  • ADR 0007: Multi-provider roadmap and community targets.
  • ADR 0008: Ports and adapters for multi-provider stacks.
  • ADR 0009: Day-2 Magento ports on StackModule.
  • ADR 0010: Database dump seed for new/ephemeral envs (attach-out-of-scope consequence superseded by Phase 8 / ATTACH-02 — brownfield-attach).