jeffryandClaude Opus 5
42d963d24f
Depended on by the conventions built on this, and depending on none of them. - the .loom directory — everything lives there, a directory means a kind, a stream is a file. Fixes .loom/ and deliberately not which kinds exist. - sibling facets — x.<facet>.md beside x.md, owned by whoever wrote the facet, never by whoever wrote x.md. Plus the three choices a convention must make. - recording decisions — what an entry says, why it is never revised, and why it has no status field. - publication — the act, the contract, and that what is published is a document. Also carries the event log and declines from cart `almanac`, which ran 2026-09-04 to 2026-09-07 and produced seventy-eight entries. Read it forwards; entry 69 is where it changes its own mind and brackets most of what came before. The git history here starts now. The event log is the history that matters. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
23 lines
915 B
Markdown
23 lines
915 B
Markdown
# The `.loom` directory
|
|
|
|
**A repository that uses loom keeps everything in `.loom/` at its root.**
|
|
|
|
> **Type is determined by location.** *The directory a file is in says what it
|
|
> is.* **So frontmatter carries almost nothing, and often nothing at all.**
|
|
|
|
**A stream is a file. A collection of things with identity is a directory.** *A
|
|
log is appended to and no entry is ever addressed; a thing that is referred to
|
|
individually gets its own file.*
|
|
|
|
**Everything not recognised is shown rather than rejected.** *These files are
|
|
edited by hand and by agents, constantly, and that is supported. A reader that
|
|
fails on an unfamiliar directory is wrong.*
|
|
|
|
## What is fixed
|
|
|
|
**Only `.loom/` itself, and that a directory means a kind.** *Which kinds exist
|
|
is not fixed here — conventions built on this one declare their own, and a
|
|
repository has only the ones it uses.*
|
|
|
|
**Nothing outside `.loom/` is loom's business.**
|