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.

This page is a copy of a document published by loom/bedrock, rendered here. The source is https://git.hypertheory-labs.dev/loom/bedrock/raw/branch/main/.loom/published/loom-directory.md and is what the copy is checked against.