Skip to content

0001 — Record architecture decisions

  • Status: Accepted
  • Date: 2026-07-22

Context

This is a portfolio project meant to be read by potential employers, and a learning project where understanding why matters as much as what. Decisions made without a record tend to be forgotten or second-guessed.

Decision

We keep lightweight Architecture Decision Records (ADRs) in docs/decisions/. Each ADR is one Markdown file describing the context, the decision, and its consequences.

Consequences

  • The reasoning behind the project is transparent and reviewable.
  • New decisions are cheap to add; superseded ones are marked, not deleted.
  • The ADR log doubles as a narrative of the project's evolution.