docs: page-material passages name subtype templates (#117)
CI / verify (push) Successful in 5m27s
CI / pwsh (push) Successful in 2m5s
Release / release (push) Successful in 35s

Files changed:
- CHANGES.md
- VERSION
- docs/language-boundaries.md
- tools/chemenu/commands/dist_cmd.py
- types/type-guidance.md
- types/type-spec.md

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SnAJ7Z3CpVD3PRbN73QtU2
This commit is contained in:
torbenandClaude Opus 5.5 committed 2026-10-03 17:07:52 +02:00
1 parent d8cb494d58
commit dd565d249f
6 files changed
+26 -12

No files matched your search

+5 -3
View File
@@ -90,7 +90,9 @@ Making the control plane English does not make the instance's language an implem
experiences:
- **Page text.** Every page under `kb/`, and inside the page type-specs exactly the parts that
become page text - each one's `## Template` block and its `layout:` titles.
become page text - each one's `## Template` block, its `layout:` titles, and the subtype
templates `types/<name>.<value>.md` beside it, which are page text from the first line to the
last.
- **What an agent says.** An agent speaks the KB language, whatever the file it just read was
written in. An instruction that models a sentence for the operator writes that model in
English, like the rest of the control plane, and the agent delivers it in the instance's
@@ -103,8 +105,8 @@ English instructions. The English is what the machinery is written in, not what
A page type's contract is where the two languages meet most closely, and it is worth knowing
which part is which before editing any of it. Its authoring guidance addresses an agent and is
English; its `## Template` block and `layout:` titles become the literal headings of pages and
follow the KB language; its field names and enum values are identifiers and are translated in
English; its `## Template` block, `layout:` titles and subtype templates become the literal
headings of pages and follow the KB language; its field names and enum values are identifiers and are translated in
neither direction.
The language line did not move when the *file* line did. A `root: kb` type-spec may now put its