# bedrock

**The primitives.** Four documents, in `.loom/published/`:

- [The `.loom` directory](.loom/published/loom-directory.md) — everything lives
  there, and a directory means a kind
- [Sibling facets](.loom/published/sibling-facets.md) — `x.<facet>.md` beside
  `x.md`, owned by whoever wrote the facet
- [Recording decisions](.loom/published/recording-decisions.md) — what an entry
  says, and why it is never revised
- [Publication](.loom/published/publication.md) — what `.loom/published/` means

**Nothing here says what to *do*.** *`loom/annotating`, `loom/cart` and
`loom/externals` are built on these and are where the practices live.*

**Most repositories will never read this.** *Its audience is people building
conventions, not people using them — and it is a good sign that a primitive is
one nobody needs.*

**Publishers are the exception**, because publication is defined here, and the
people whose choices land on somebody else should have read the primitives.