Files
annotating/README.md
T
jeffryandClaude Opus 5 d66a0a8db7 the annotating agreement, v0
Published to give the document an address. loom/externals already holds an
external pointing at this path, and until now it resolved to nothing.

This is the copy adopted by staribridge/substrate on 2026-08-21 and reconciled to
v0 the same day, read many times and never edited. If loom's own copy differs,
this one is wrong and should be replaced before anybody adopts it.

The README states what this agreement casts of bedrock's sibling facets — the
facet is notes, the source is fixed by the notes file existing, the pair is
released by rewriting the source — and the condition that is missing from the
agreement itself: that third answer holds only where you own the source. Where
you do not, use externals, which releases by replacement. Two agreements adopted
on 2026-08-21 stayed frozen for three weeks on exactly that absence.

The condition is stated in the README rather than added to the agreement, because
the agreement is loom's and this copy is frozen by annotations that are not
loom's to dissolve.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-07 10:51:21 -04:00

1.6 KiB

annotating

How two parties mark up each other's files without either of them having to diff anything.

Deliberately minimal. This is the most-depended-on thing loom publishes, so a revision costs everyone downstream an afternoon.

What it casts, and the one thing it does not

It is a casting of sibling facets, which leaves three choices to any convention built on it. This one answers: the facet is notes; the source is fixed by the notes file existing; the pair is released by rewriting the source and deleting the notes.

That third answer holds only where you own the source.

Where you do not — an adopted document, somebody else's agreement — you cannot rewrite it, and this agreement has no move for you. Use externals, which releases by replacement.

That condition is not yet written into the agreement below. Its absence is not theoretical: two agreements adopted on 2026-08-21 stayed frozen for three weeks, because the only stated release required rewriting a document belonging to somebody else. Nobody chose badly. Nobody was asked.

Provenance of this copy

This is the copy adopted by staribridge/substrate on 2026-08-21 and reconciled to v0 the same day. It has been read many times and never edited.

If loom's own copy differs, this one is wrong and should be replaced before anybody adopts it. Published here to give the document an address, which it did not have — externals already holds an external pointing at this path.