stack: TOC-Scope auf types/ und docs/, Sprachregeln nach AGENTS.md zentralisiert, alle Templates auf Control-Plane-Sprache, --breaking akkumuliert (schliesst #99)
CI / verify (push) Successful in 45s
Release / release (push) Successful in 36s

Files changed:
- AGENTS.md
- CHANGES.md
- ENVIRONMENT.md.template
- SOUL.md
- SOUL.md.template
- USER.md.template
- VERSION
- docs/ownership-and-templates.md
- docs/version-model.md
- instructions/CONTRACT.md
- instructions/dev/doc-pull-through.md
- instructions/dev/stack-close/SKILL.md
- instructions/dev/stack-dev/SKILL.md
- instructions/dev/version-parts.md
- instructions/setup-instance.md
- kb/CONVENTIONS.md
- kb/CONVENTIONS.md.template
- kb/concepts/COLLECTION.md
- kb/sources/COLLECTION.md
- tools/CONTRACT.md
- tools/chemenu/commands/types_cmd.py
- tools/chemenu/commands/version_cmd.py
- tools/chemenu/tests/test_toc.py
- tools/chemenu/tests/test_version_cmd.py
- tools/chemenu/toc.py
- tools/chemenu/version.py
- types/comparison.md
- types/concept.md
- types/entity.md
- types/lint-report.md
- types/source.md
This commit is contained in:
2026-09-15 16:21:02 +02:00
parent c0dc2129bb
commit c64479fe02
31 changed files with 1093 additions and 603 deletions
+21 -22
View File
@@ -35,32 +35,31 @@ tone, relationship labels, the confidence rubric. Neither is restated here.
## Types offered
`concept` (`tools/wikitool types describe concept`). Das Feld `concept_type:`
wählt die Area:
`concept` (`tools/wikitool types describe concept`). The `concept_type:` field
picks the area:
| Area | Hält |
|------|------|
| `architectures/` | Aufbau und Struktur: wie ein System geschnitten ist und warum die Schnitte dort liegen |
| `patterns/` | Wiederverwendbare Lösungsformen, die über mehr als einen Gegenstand hinweg gelten |
| `protocols/` | Kommunikationsprotokolle und Standards, in ihrer üblichen Schreibweise benannt |
| `workflows/` | Abläufe und Prozesse, die projektübergreifend wiederkehren |
| `decisions/` | Architektur- und Entwurfsentscheidungen (siehe unten) |
| `problems/` | Wiederkehrende Problemstellungen und ihre Lösungsansätze |
| Area | Holds |
|------|-------|
| `architectures/` | Shape and structure: how a system is cut up, and why the cuts fall where they do |
| `patterns/` | Reusable solution shapes that hold across more than one subject |
| `protocols/` | Communication protocols and standards, named in their usual spelling |
| `workflows/` | Procedures and processes that recur across projects |
| `decisions/` | Architectural and design decisions (see below) |
| `problems/` | Recurring problems and the approaches taken to them |
Das sind Areas, keine Collections: sie erben diesen Contract und tragen keine
eigene `COLLECTION.md`.
These are areas, not collections: they inherit this contract and carry no
`COLLECTION.md` of their own.
Die Zuordnung trifft niemand von Hand — sie steht als `layout:` in
`types/concept.md`, und `wikitool new` legt eine neue Seite direkt dort ab.
Eine Seite, die anderswo liegt, meldet `wikitool lint` als *misplaced*;
`wikitool move --page "<Titel>"` bringt sie an ihren berechneten Ort.
Nobody assigns them by hand — the mapping is the `layout:` in
`types/concept.md`, and `wikitool new` puts a new page straight there. A page
sitting anywhere else is reported by `wikitool lint` as *misplaced*;
`wikitool move --page "<title>"` moves it to its computed location.
Die Aufteilung ist keine Geschmacksfrage, sondern das, was die Shard-Schwelle
des Katalogs überhaupt wirksam macht: `index rebuild` teilt **pro Area**, und
eine Collection ohne Areas teilt sich niemit 80 Seiten in einer einzigen
Tabelle war die Schwelle hier ein toter Wert. Keine der sechs
Areas liegt derzeit über der Schwelle, also bekommt auch keine einen eigenen
Shard; wächst eine hinein, passiert das ohne Zutun.
The split is not a matter of taste but what makes the catalog's shard threshold
effective at all: `index rebuild` splits **per area**, and a collection without
areas never splitswith 80 pages in a single table the threshold was a dead
value here. None of the six areas is currently above it, so none gets a shard of
its own; when one grows into it, that happens without anyone acting.
## Decisions