Skip to content

Shelfery Architecture Decision Records

This directory holds venture-level architecture decision records (ADRs) that are specific to Shelfery — decisions that don't belong at the company-wide level because they only affect this venture, but are significant enough to warrant a durable, dated record of the decision and its reasoning.

Current status

When to add an ADR here vs. company-wide

  • If a decision is specific to how Shelfery is built or organized (e.g. a Shelfery-only technology choice), record it here.
  • If a decision affects company-wide policy, multiple ventures, or the overall repository structure (e.g. the implementation-repository boundary question, currently tracked as a company-wide ADR), it belongs under ../../../../docs/decisions/ instead, even if Shelfery is the venture that prompted it.

Template

Use the company ADR template at ../../../../docs/decisions/adr-template.md when creating a new ADR in this directory, and follow the same numbering and status conventions described there.


Report an issue about this page