Skip to content

The modes a Mold may declare are the two that ship - #39

Merged
jmchilton merged 1 commit into
mainfrom
modes-match-substrate
Aug 4, 2026
Merged

The modes a Mold may declare are the two that ship#39
jmchilton merged 1 commit into
mainfrom
modes-match-substrate

Conversation

@jmchilton

Copy link
Copy Markdown
Member

Posted by Claude (AI assistant) on jmchilton's behalf.

Follow-on to the casting-determinism rewrite (#37, 2aff6b7), which was right to retire condensation and got the replacement vocabulary wrong.

The mode list needed one fewer term. It gained two: inlined and bundled appear in no package and no instance, and verbatim — the mode both corpora use for nearly every reference — dropped out of the sentence naming them. The provenance example in the-model.md also invented a key, "placement", where the record writes mode.

The shipped vocabulary is verbatim and sidecar (@galaxy-foundry/reference-contract). This site is where a reader is sent to learn that — reference-contract.yml's spec_url points into content/pattern/, so prose here is the definition rather than a gloss on one.

What is kept

placement mode — and it is now the better name. Nothing transforms a reference any more; both surviving modes carry it unchanged, one as its own bytes and one as a structured artifact built from them. That is exactly what makes a cast reproducible byte for byte, which is the claim the-model.md now makes two paragraphs earlier. The rename was the right instinct; only the enumeration was wrong.

Five places

file was now
the-model.md "inlined, bundled, or carried as a sidecar"; "placement": "bundled" / "inline" verbatim / sidecar; "mode": "verbatim"
standing-up-a-foundry.instructions.txt "verbatim, inline, bundled, and sidecar" the two that ship, and why a term is on the list
04-fair-skills.md "(inlined, bundled, or sidecar)" "(verbatim or sidecar)"
guiding-principles.md "inlined content from bundled or sidecar material" verbatim from sidecar
glossary.md prompt (inlined) prompt (copied verbatim)

The instructions file was the costly one: it told a third Foundry to expect four placement rules, half of them nonexistent, inside the paragraph telling it to narrow the group to what its targets implement.

22 tests pass, site builds 29 pages.

Related

jmchilton/foundry-lib#49 removes condense from the shared vocabulary, which is what makes "the two that ship" true rather than "the two that ship, plus one nobody implements." The two PRs are independent — this one describes what instances declare today either way.

Follow-up, not in this PR

reference-contract.yml's spec_url points at anatomy-of-an-instance.md, and that page never lists the five vocabularies. The package sends readers to a page that does not define its terms; the definitions are on the-model.md and glossary.md instead. Either the pointer moves or the page gains the list.

🤖 Generated with Claude Code

Retiring condensation left the mode list needing one fewer term. It got two more
instead: `inlined` and `bundled` appear in no package and no instance, and
`verbatim` — the mode both corpora use for nearly every reference — dropped out of
the sentence naming them. The provenance example went further and invented a key,
`"placement"`, where the record writes `mode`.

The shipped vocabulary is verbatim and sidecar. This page is where a reader is sent
to learn that: reference-contract's spec_url points into this site, so prose here is
the definition, not a gloss on one.

`placement mode` is kept, and is now the better name. Nothing transforms a reference
any more — both surviving modes carry it unchanged, one as its own bytes and one as a
structured artifact built from them. That is what makes a cast reproducible byte for
byte, which is the claim the same page now makes two paragraphs earlier.

The standing-up instructions were the costly copy: they told a third Foundry to
expect four placement rules, half of them nonexistent, in the paragraph telling it
to narrow the group to what its targets implement.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@jmchilton
jmchilton merged commit 7c4cf14 into main Aug 4, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant