jeffryandClaude Opus 5
da6e8b9b51
Generates .loom/orientation.md — what this repository depends on, where each copy came from, and which facets sit beside it — for whoever arrives next, of any make. One file rather than two, decided by loom's own rule. Generate what varies, adopt what does not: the publishing half varies not at all and is already adopted, so publication.md appears in the index like any other adopted document, in exactly the repositories that adopted it. A second command would emit a file whose whole content is a pointer to a file already in the tree, and would revive a noun declined when published check went. Restates no rule. The three moves are phrased as operations — what to run, what to write, where — and every rule stays in the document that owns it. The .usages.md is pointed at rather than summarised, because what depends on a document is free prose and anything extracting a claim from prose eventually extracts it wrong. It says nothing recorded when a document has no usages file, which is a finding rather than an omission and is currently true of six of nine. Byte-deterministic, pinned by a test that inserts records out of order and generates three times. Written to .loom/orientation.md rather than inside .loom/externals/, where check would report it as an unlocked external in every repository using the feature. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018UTxuSizozEA8yDitPuris
64 lines
3.2 KiB
Markdown
64 lines
3.2 KiB
Markdown
<!-- Generated by `loomctl orient`. Safe to overwrite; nobody typed it.
|
|
Regenerate after adopting a document or reconciling a change. -->
|
|
|
|
# What this repository depends on
|
|
|
|
Copies of other people's documents are kept under `.loom/externals/`, at a path
|
|
that says where each came from. **They are copies: do not edit them.** Anything
|
|
you want to say about one goes in a file *beside* it, never into it.
|
|
|
|
Three moves, and each has a document that owns the rule:
|
|
|
|
- **A copy is wrong, or you needed something it does not say** — write it in
|
|
`<name>.gaps.md` beside the copy.
|
|
- **What of ours depends on a copy** — write it in `<name>.usages.md` beside it.
|
|
- **A source changed** — `loomctl external check` says so and stages the new copy;
|
|
`loomctl external apply` takes it. Neither edits anything on its own.
|
|
|
|
## `git.hypertheory-labs.dev/jeffry/homelab-cluster/gitea.md`
|
|
|
|
- source: https://git.hypertheory-labs.dev/jeffry/homelab-cluster/raw/branch/main/.loom/published/gitea.md
|
|
- what of ours depends on it: `.loom/externals/git.hypertheory-labs.dev/jeffry/homelab-cluster/gitea.usages.md`
|
|
|
|
## `git.hypertheory-labs.dev/loom/annotating/annotating.md`
|
|
|
|
- source: https://git.hypertheory-labs.dev/loom/annotating/raw/branch/main/.loom/published/annotating.md
|
|
- what of ours depends on it: **nothing recorded** — no `.usages.md`
|
|
- what we expected and did not find: `.loom/externals/git.hypertheory-labs.dev/loom/annotating/annotating.gaps.md`
|
|
|
|
## `git.hypertheory-labs.dev/loom/bedrock/loom-directory.md`
|
|
|
|
- source: https://git.hypertheory-labs.dev/loom/bedrock/raw/branch/main/.loom/published/loom-directory.md
|
|
- what of ours depends on it: **nothing recorded** — no `.usages.md`
|
|
|
|
## `git.hypertheory-labs.dev/loom/bedrock/publication.md`
|
|
|
|
- source: https://git.hypertheory-labs.dev/loom/bedrock/raw/branch/main/.loom/published/publication.md
|
|
- what of ours depends on it: **nothing recorded** — no `.usages.md`
|
|
|
|
## `git.hypertheory-labs.dev/loom/bedrock/recording-decisions.md`
|
|
|
|
- source: https://git.hypertheory-labs.dev/loom/bedrock/raw/branch/main/.loom/published/recording-decisions.md
|
|
- what of ours depends on it: **nothing recorded** — no `.usages.md`
|
|
|
|
## `git.hypertheory-labs.dev/loom/bedrock/sibling-facets.md`
|
|
|
|
- source: https://git.hypertheory-labs.dev/loom/bedrock/raw/branch/main/.loom/published/sibling-facets.md
|
|
- what of ours depends on it: **nothing recorded** — no `.usages.md`
|
|
|
|
## `git.hypertheory-labs.dev/loom/bedrock/starting.md`
|
|
|
|
- source: https://git.hypertheory-labs.dev/loom/bedrock/raw/branch/main/.loom/published/starting.md
|
|
- what of ours depends on it: **nothing recorded** — no `.usages.md`
|
|
|
|
## `git.hypertheory-labs.dev/loom/cart/cart.md`
|
|
|
|
- source: https://git.hypertheory-labs.dev/loom/cart/raw/branch/main/.loom/published/cart.md
|
|
- what of ours depends on it: `.loom/externals/git.hypertheory-labs.dev/loom/cart/cart.usages.md`
|
|
- what we expected and did not find: `.loom/externals/git.hypertheory-labs.dev/loom/cart/cart.gaps.md`
|
|
|
|
## `git.hypertheory-labs.dev/loom/externals/externals.md`
|
|
|
|
- source: https://git.hypertheory-labs.dev/loom/externals/raw/branch/main/.loom/published/externals.md
|
|
- what of ours depends on it: `.loom/externals/git.hypertheory-labs.dev/loom/externals/externals.usages.md`
|