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>
29 lines
1.2 KiB
Markdown
29 lines
1.2 KiB
Markdown
# Sibling facets
|
|
|
|
**For any file `x.md`, other things said about it live beside it as
|
|
`x.<facet>.md`.**
|
|
|
|
> **A facet is owned by whoever wrote the facet, never by whoever wrote `x.md`.**
|
|
|
|
**That is the whole of it.** *It exists so that two parties can both write about
|
|
one document without either of them reconciling two versions of it.*
|
|
|
|
## What a convention using this must decide
|
|
|
|
**Three things, and it must say all three or its adopters will not know they had
|
|
a choice.**
|
|
|
|
- **What the facet is called.** *`notes`, `usages`, `gaps` — the name is the
|
|
contract; a reader recognises the pair on sight.*
|
|
- **What fixes `x.md` while the facet exists.** *Something must, or the facet
|
|
comes loose from what it is about.*
|
|
- **How the pair is released.** *There must be an answer. **A convention that
|
|
does not say leaves its adopters stuck**, and they will not notice, because a
|
|
question nobody asks looks like a question already answered.*
|
|
|
|
## Why the facet is never owned by the source's author
|
|
|
|
**Because the source may not be theirs to change.** *An adopted document belongs
|
|
to whoever published it; a facet beside it is the only place a reader has to put
|
|
what they think.*
|