Skip to main content

Architecture Decisions

Architecture Decision Records (ADRs) capture significant choices, their context, and their consequences—so recruiters, collaborators, and future-you can understand why, not just what.

ADR index

ADRTitleStatus
ADR-001Portfolio Platform (Docusaurus)Accepted
ADR-002Public Proof BoundaryAccepted
ADR-003Static Deployment (GitHub Pages)Accepted
ADR-004Evidence FirstAccepted
ADR-005Human ApprovalAccepted
ADR-006Privacy BoundaryAccepted
ADR-007Repository GovernanceAccepted

Format

Each ADR includes:

  • Status — Proposed, Accepted, Deprecated, Superseded
  • Context — Forces and constraints
  • Decision — What was chosen
  • Consequences — Tradeoffs and follow-ups

Scope

These ADRs govern this public documentation site and portfolio publishing model. They do not replace architecture decisions inside private operating systems or client engagements.