Shelfery Architecture Documentation¶
Note (2026-07-27): the documents in this directory describe a
pre-implementation state (no architecture, no repository decided) that is no
longer current — Shelfery's implementation repository (shelfery, formerly
pantryplus) is a production app, and per
ADR-0017
this repository no longer holds Shelfery's product specification at all (see
ventures/shelfery/docs/architecture/implementation-alignment.md for the
reconciliation record). Fully updating this directory to reflect that is a
separate task from the product-governance restructuring that added this
note; treat system-context.md and the "When real architecture documentation
will start" section below as stale, not current.
This directory holds architecture-related documentation for the Shelfery venture. At this stage it contains deliberate placeholders rather than an actual architecture, because no product specification or technical approach has been approved yet.
Contents¶
system-context.md— states plainly that no application architecture exists yet, and what needs to happen before it does.repository-boundary.md— states that whether Shelfery's implementation will live in this repository or a separate one is unresolved.
When real architecture documentation will start¶
Real architecture work is expected to begin once a product specification
exists and has been reviewed — that specification now lives entirely in the
shelfery implementation repository, not under a ventures/shelfery/product/
path here (see the note above). Until this directory is properly updated,
documents in it should continue to describe the absence of a decision rather
than assume one.