stack: TOC-Scope auf types/ und docs/, Sprachregeln nach AGENTS.md zentralisiert, alle Templates auf Control-Plane-Sprache, --breaking akkumuliert (schliesst #99)
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:
+55
-58
@@ -1,86 +1,83 @@
|
||||
<!-- wikitool:template-unfilled - TEMPLATE, noch nicht ausgefüllt. Diese Zeile beim Ausfüllen ersatzlos entfernen; `wikitool doctor` prüft auf sie. -->
|
||||
# ENVIRONMENT.md — <Instanz oder Rechnername>
|
||||
<!-- wikitool:template-unfilled - TEMPLATE, not filled in yet. Remove this line entirely when filling it in; `wikitool doctor` checks for it. -->
|
||||
# ENVIRONMENT.md — <instance or machine name>
|
||||
|
||||
Womit *dieser Checkout* arbeitet: Harness, veröffentlichte Skills, MCP-Server,
|
||||
Connectoren und Git-Remotes. Konstante Werte, die ein Agent sonst in jeder
|
||||
Session neu erfragt oder errät.
|
||||
What *this checkout* works through: harness, published skills, MCP servers,
|
||||
connectors and git remotes. Constant values an agent would otherwise ask about
|
||||
or guess at in every session.
|
||||
|
||||
**Diese Datei ist optional.** Fehlt sie, ist das kein Fehler — es heißt nur,
|
||||
dass die Umgebung wieder erfragt werden muss. `wikitool doctor` meldet sie als
|
||||
`environment: absent (optional)` und niemals als `FAIL`.
|
||||
**This file is optional.** Its absence is not an error — it only means the
|
||||
environment has to be asked about again. `wikitool doctor` reports it as
|
||||
`environment: absent (optional)` and never as a `FAIL`.
|
||||
|
||||
**Diese Datei ist Kontext, keine Autorität.** Sie beschreibt, *was da ist*, nicht,
|
||||
was erlaubt ist. Sie ändert keine Regel aus `AGENTS.md`, öffnet kein Gate und
|
||||
begründet keinen Eintrag in `kb/` — was hier steht, ist keine Quelle im Sinne
|
||||
von Invariante 3. Ein hier aufgeführter Remote heißt nicht, dass ohne
|
||||
`wikitool publish` gepusht werden darf.
|
||||
**This file is context, not authority.** It describes *what is there*, not what
|
||||
is allowed. It changes no rule from `AGENTS.md`, opens no gate, and justifies no
|
||||
entry in `kb/` — what it says is not a source in the sense of invariant 3. A
|
||||
remote listed here does not mean pushing without `wikitool publish` is allowed.
|
||||
|
||||
**Keine Geheimnisse.** Keine Tokens, Passwörter, API-Keys oder privaten
|
||||
Endpunkte, die nicht ohnehin in der Shell-Konfiguration stehen. Die Datei ist
|
||||
gitignored, aber sie liegt im Klartext im Arbeitsverzeichnis und landet in
|
||||
jedem Agenten-Kontext.
|
||||
**No secrets.** No tokens, passwords, API keys or private endpoints that are not
|
||||
already in the shell configuration anyway. The file is gitignored, but it sits
|
||||
in plaintext in the working directory and ends up in every agent's context.
|
||||
|
||||
**Ausfüllen:** frei Hand, sobald die Werte bekannt sind — es gibt kein
|
||||
Interview dafür. Ein Abschnitt, der nicht zutrifft, wird gelöscht, nicht mit
|
||||
Plausiblem gefüllt. Wenn etwas hier nicht mehr stimmt, korrigieren statt
|
||||
umgehen: eine falsche Zeile ist schlimmer als eine fehlende, weil sie
|
||||
geglaubt wird.
|
||||
**Filling it in:** freehand, as soon as the values are known — there is no
|
||||
interview for it. A section that does not apply is deleted, not filled with
|
||||
something plausible. When something here stops being true, correct it rather
|
||||
than working around it: a wrong line is worse than a missing one, because it
|
||||
gets believed.
|
||||
|
||||
## Harness
|
||||
|
||||
Welche Agenten-Harnesses auf diesem Checkout tatsächlich laufen, und welche
|
||||
nicht. Relevant, weil `.agents/skills/` und `.claude/skills/` unterschiedliche
|
||||
Leser haben.
|
||||
Which agent harnesses actually run on this checkout, and which do not. Relevant
|
||||
because `.agents/skills/` and `.claude/skills/` have different readers.
|
||||
|
||||
- **Primär:** <z. B. Claude Code>
|
||||
- **Daneben im Einsatz:** <z. B. Codex CLI, GitHub Copilot CLI, Mistral Vibe — oder streichen>
|
||||
- **Nicht im Einsatz:** <was bewusst nicht benutzt wird, damit niemand es vorschlägt>
|
||||
- **Primary:** <e.g. Claude Code>
|
||||
- **Also in use:** <e.g. Codex CLI, GitHub Copilot CLI, Mistral Vibe — or delete>
|
||||
- **Not in use:** <what is deliberately not used, so nobody proposes it>
|
||||
|
||||
## Skills
|
||||
|
||||
Nur was von der veröffentlichten Liste abweicht — der Normalfall (`wiki-ingest`,
|
||||
`wiki-query`, `wiki-manage`, `wiki-lint`, `wiki-status`) steht in `AGENTS.md`
|
||||
und gehört nicht noch einmal hierher.
|
||||
Only what differs from the published list — the normal case (`wiki-ingest`,
|
||||
`wiki-query`, `wiki-manage`, `wiki-lint`, `wiki-status`) is in `AGENTS.md` and
|
||||
does not belong here a second time.
|
||||
|
||||
- **Zusätzlich vorhanden:** <z. B. stack-dev in der Entwickler-Instanz>
|
||||
- **Bekannt fehlend:** <z. B. noch nicht gesynct, Harness neu gestartet nötig — oder streichen>
|
||||
- **Additionally present:** <e.g. stack-dev in the developer instance>
|
||||
- **Known missing:** <e.g. not synced yet, harness restart needed — or delete>
|
||||
|
||||
## MCP-Server
|
||||
## MCP servers
|
||||
|
||||
Welche MCP-Server in diesem Checkout erreichbar sind und wofür sie zuständig
|
||||
sind. Ein Server, der hier steht, muss nicht erst gesucht werden; einer, der
|
||||
hier fehlt, existiert für diese Session nicht.
|
||||
Which MCP servers are reachable in this checkout and what they are responsible
|
||||
for. A server listed here does not have to be looked for first; one missing
|
||||
here does not exist for this session.
|
||||
|
||||
| Server | Wofür | Anmerkung |
|
||||
|--------|-------|-----------|
|
||||
| `<name>` | <z. B. Issues, CI-Runs, Releases> | <z. B. bevorzugt gegenüber curl> |
|
||||
| Server | For what | Note |
|
||||
|--------|----------|------|
|
||||
| `<name>` | <e.g. issues, CI runs, releases> | <e.g. preferred over curl> |
|
||||
|
||||
## Connectoren und Integrationen
|
||||
## Connectors and integrations
|
||||
|
||||
Alles, was kein MCP-Server ist, aber trotzdem an dieser Instanz hängt:
|
||||
Dokument-Connectoren, Chat-Anbindungen, Notiz-Systeme.
|
||||
Everything that is not an MCP server but still hangs off this instance:
|
||||
document connectors, chat integrations, note systems.
|
||||
|
||||
- <z. B. Obsidian-Vault unter ~/..., liest kb/ read-only — oder streichen>
|
||||
- <e.g. Obsidian vault under ~/..., reads kb/ read-only — or delete>
|
||||
|
||||
## Git-Remotes
|
||||
## Git remotes
|
||||
|
||||
Wohin dieser Checkout veröffentlicht, und was sonst noch als Remote eingetragen
|
||||
ist. `wikitool publish` und `wikitool sync` sprechen genau einen davon an.
|
||||
Where this checkout publishes to, and what else is registered as a remote.
|
||||
`wikitool publish` and `wikitool sync` address exactly one of them.
|
||||
|
||||
| Remote | URL | Rolle |
|
||||
|--------|-----|-------|
|
||||
| `origin` | <URL> | <z. B. Publish-Ziel, CI läuft dort> |
|
||||
| Remote | URL | Role |
|
||||
|--------|-----|------|
|
||||
| `origin` | <URL> | <e.g. publish target, CI runs there> |
|
||||
|
||||
## CI
|
||||
|
||||
Wo die Pipeline läuft und wie ihre Läufe gelesen werden — nicht *was* sie
|
||||
prüft, das steht in `.gitea/workflows/`.
|
||||
Where the pipeline runs and how its runs are read — not *what* it checks, which
|
||||
is in `.gitea/workflows/`.
|
||||
|
||||
- **Läuft auf:** <z. B. Gitea Actions, Runner-Label linux-docker — oder streichen>
|
||||
- **Läufe lesen über:** <z. B. den Gitea-MCP-Server, nicht curl>
|
||||
- **Runs on:** <e.g. Gitea Actions, runner label linux-docker — or delete>
|
||||
- **Runs read via:** <e.g. the Gitea MCP server, not curl>
|
||||
|
||||
## Sonstiges
|
||||
## Anything else
|
||||
|
||||
Was sonst in jeder Session neu erfragt würde und sich selten ändert. Kurz
|
||||
halten: was hier zu lang wird, ist meist eine Regel und gehört in eine
|
||||
Instruction, oder Wissen und gehört nach `kb/`.
|
||||
Whatever else would be asked about in every session and rarely changes. Keep it
|
||||
short: what grows long here is usually a rule, and belongs in an instruction, or
|
||||
knowledge, and belongs in `kb/`.
|
||||
|
||||
Reference in New Issue
Block a user