robertblust · robertblust · Sep 18, 2026 · Sep 18, 2026
diff --git a/.github/workflows/conventions.yml b/.github/workflows/conventions.yml
@@ -5,4 +5,4 @@ on:
   pull_request:
 jobs:
   conventions:
-    uses: robertblust/conventions/.github/workflows/check.yml@v1.15.0
+    uses: robertblust/conventions/.github/workflows/check.yml@v1.17.0
diff --git a/AGENTS.md b/AGENTS.md
@@ -1,4 +1,4 @@
-<!-- conventions · v1.15.0 -->
+<!-- conventions · v1.17.0 -->
 Shared conventions of the robertblust, guestgraph and companygraph organizations live in
 `conventions/`, vendored from robertblust/conventions at the release `conventions.json`
 names. Read them before writing or committing anything here.

diff --git a/conventions.json b/conventions.json
@@ -1 +1 @@
-{ "repo": "robertblust/conventions", "tag": "v1.15.0", "exclude": ["node_modules", ".superpowers", "docs/superpowers"] }
+{ "repo": "robertblust/conventions", "tag": "v1.17.0", "exclude": ["node_modules", ".superpowers", "docs/superpowers"] }
diff --git a/conventions/AGENTS.md b/conventions/AGENTS.md
@@ -1,4 +1,4 @@
-<!-- conventions · v1.15.0 -->
+<!-- conventions · v1.17.0 -->
 Shared conventions of the robertblust, guestgraph and companygraph organizations live in
 `conventions/`, vendored from robertblust/conventions at the release `conventions.json`
 names. Read them before writing or committing anything here.

diff --git a/conventions/GLOSSARY.md b/conventions/GLOSSARY.md
@@ -30,7 +30,22 @@ marks `TRANSLATOR.md` repeats are the only places the shared files carry German
 | figure | figure | `Diagramm` | The drawn graph on a model page. The owner's choice over `Zeichnung`, which reads as a drawing by hand. |
 | experience | experience | `Erfahrung` | An entry in the model's experiences folder, whatever its kind; blust.ch's timeline and model pages. The row it makes on the timeline is an `Eintrag`. |
 | kind of experience | kind of experience | `Erfahrungsart` | The experience-kind entities — Role, Project, Community, Education, Independent — whose names stay English in both views. The owner's choice over the bare `Art` on a control, which the page's prose may still use for the short form. |
-| surface | surface | `surface` | A place the company publishes that no script writes, and the type in `model/surfaces/`. A name the ecosystem reads, so not `Oberfläche`, which in German software prose is the user interface. |
+| surface | surface | `Surface` | A page the model is published on, written by hand or built by a repository's build, and the type in `model/surfaces/`. A name the ecosystem reads, so not `Oberfläche`, which in German software prose is the user interface. Capitalized as a German noun; feminine, `die Surface`, plural `die Surfaces`. |
+| owner | owner | `Owner` | The one person the company of one is, and the role of that name in the model. Kept English, because the role's name on blust.ch's team page is English in both views and the word and the role are one thing. The owner's choice over `Inhaber`. Masculine, `der Owner`. |
+| build | build | `Build` | What a repository runs to write a page or a built surface from the model. Kept English like `Connector`; masculine, `der Build`. |
+| pin | pin | `Pin` | The visible line in which one repository takes another's release or commit; the participle is `gepinnt`. Masculine, `der Pin`. |
+| commit | commit | `Commit` | A git commit, and the one a pin names. Masculine, `der Commit`; plural `die Commits`. |
+| MCP | MCP | `MCP` | The protocol an agent reads a model over. A name, English in both languages, and it compounds with a hyphen. |
+| MCP server | MCP server | `MCP-Server` | The server that answers over MCP; `companygraph/mcp-server` is the package. Masculine, `der MCP-Server`. |
+| MCP Registry | MCP Registry | `MCP Registry` | The public index a server is published to. A proper name, English in both languages, and feminine: `in der MCP Registry`, never `im`. No page carried German for it before, which is why the gender is recorded here rather than left to the next sentence. |
+| AI agent | AI agent | `KI-Agent` | The reader a model serves beside a person. Masculine, `der KI-Agent`, plural `die KI-Agenten`, the form blust.ch's ideas page already uses. |
+| read-only | read-only | `nur lesend` | Of a server that answers and never writes. Not `schreibgeschützt`, which says write-protected and describes what may be done to a file rather than what a server offers. |
+| shipped | shipped | `ausgeliefert` | Of a thing released and running, as against designed or built. Not `gebaut`, which says only built, and not `fertig`, which says finished. |
+| entity | entity | `Entität` | One file in the model, of whatever type. The form blust.ch's model page uses. |
+| type | type | `Typ` | One of the types a schema declares; plural `Typen`, and `Kerntypen` for core's own, as blust.ch's ideas page writes it. |
+| claim | claim | `Anspruch` | What a profile asserts of itself and a page then has to show. blust.ch's model page: `Ein Anspruch ohne konkreten Beleg daneben ist im Modell ein Fehler`. |
+| evidence | evidence | `Beleg` | The fact a claim rests on, in the cell beside it. Same sentence as above. |
+| declare | declares | `deklariert` | Of what a schema states a type carries, or an instance states of itself. Not `erklärt`, which reads as explains. |
 
 English forms fixed here whose German no page carries yet, to be chosen the first time a text
 needs them: pack, design system, deck.
diff --git a/conventions/manifest.json b/conventions/manifest.json
@@ -1,14 +1,14 @@
 {
   "repo": "robertblust/conventions",
-  "tag": "v1.15.0",
+  "tag": "v1.17.0",
   "files": {
     "conventions/WRITING.md": "sha256:6c507657ea6215de85a6bdb740fac6153ecbe20eee4d479f5b9fa09c1d15ee3a",
     "conventions/WORKING.md": "sha256:78f1e40d7ff61752ef3a26cb5bf48d502bca64319170cecc2e27a86feb5d08ce",
     "conventions/REPOSITORIES.md": "sha256:c0d3a58a2c8e5af36d7523c26317d525500b03b1d69867e2f5b7da29e35e4f78",
     "conventions/WRITER.md": "sha256:f808e9bb7806e04882bd08369c97de453c10354ebaa920670264c7d12c10557c",
     "conventions/TRANSLATOR.md": "sha256:ab6cd9ce38e39452f57528f258bb9de593f1663c05ad21caa1c012bab75c69f0",
-    "conventions/GLOSSARY.md": "sha256:d43a3417d995067d21f2830fdb68f70c505ce02997c923eabb6fde769b3a2a72",
-    "conventions/AGENTS.md": "sha256:d56b842aed8de89f4f7cd11f6a22db017f5da0c6a8e76acc5edd2911ed678e1a",
+    "conventions/GLOSSARY.md": "sha256:bf3353cd7be7f2d4a3d5beda507e2d12d2f2e830c2a815ba6afa81f7ddb4d616",
+    "conventions/AGENTS.md": "sha256:e107368a918138721e476032e58b8f383f487b865c03290216a8d825033f600e",
     "conventions/conventions-sync": "sha256:4a59e85eee756399cf76a9f332d262694549b08472b46d45f26ac3314a28f4c2",
     "conventions/conventions-check": "sha256:fd6b7520e9543a2ee6f0d7c374f4f9c3bcd098395e3e9a27467cfcd5118fb241"
   }
Original file line number	Diff line number	Diff line change
		@@ -1 +1 @@
		{ "repo": "robertblust/conventions", "tag": "v1.15.0", "exclude": ["node_modules", ".superpowers", "docs/superpowers"] }
		{ "repo": "robertblust/conventions", "tag": "v1.17.0", "exclude": ["node_modules", ".superpowers", "docs/superpowers"] }