loom/loom-cli
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
loom-cli/.loom/orientation.md
T
jeffryandClaude Opus 5 d3fec24bc6 guarantees: promise visibility about the surface we do not promise 
loom's .usages.md for this page found the hole. The docs site depends on the
command surface — its README and publish script tell a person to type loomctl
external add loom/<repo> <doc>.md — and this page explicitly does not promise it.
Nothing parses the command, which is exactly why no check would catch a rename:
the thing that moved is not a document anybody adopted.

The answer is not to promise the surface, which would freeze the CLI. It is to
promise that a change to it lands on this page — which consumers already lock — so
a rename reports 200 the day it happens. The exclusion goes from "you are on your
own" to "you will be told", and it costs one append-only section.

Same shape as a supersession in the event log: the record is not that the thing
never changes, it is that the change is findable by whoever depended on it.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018UTxuSizozEA8yDitPuris
2026-09-08 10:41:29 -04:00

3.4 KiB
Raw Permalink Blame History

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

git.hypertheory-labs.dev/loom/annotating/annotating.md

git.hypertheory-labs.dev/loom/bedrock/loom-directory.md

git.hypertheory-labs.dev/loom/bedrock/publication.md

git.hypertheory-labs.dev/loom/bedrock/recording-decisions.md

git.hypertheory-labs.dev/loom/bedrock/sibling-facets.md

git.hypertheory-labs.dev/loom/bedrock/starting.md

git.hypertheory-labs.dev/loom/cart/cart.md

git.hypertheory-labs.dev/loom/externals/externals.md

This repository publishes

See .loom/published/. What is handed over for others to depend on is there; the rest of the repository is not hidden, it is simply not what anybody depends on.

Reference in New Issue View Git Blame Copy Permalink