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¶
There are no Shelfery-specific ADRs yet. This is expected at this stage:
the venture has not yet made architecture-level decisions to record (see
ventures/shelfery/docs/architecture/system-context.md and
repository-boundary.md).
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.