torben
18ae28f918
Chemenu kompiliert Rohnotizen zu einem verlinkten, quellengebundenen Wiki: raw/ -> types/ + tools/ -> kb/ -> reports/. Was mechanisch ist, macht tools/wikitool; was Urteil braucht, macht ein Agent unter Contracts, deren Grenzen in Code durchgesetzt sind statt im Prompt. Dieser Commit ist der Startpunkt der oeffentlichen Historie. Die vorherige Entwicklung fand in einer privaten Instanz statt und ist nicht Teil dieses Repositorys; ihre Erzaehlung steht vollstaendig in CHANGES.md, das mit 44 Eintraegen von 0.1.0 bis 2.1.0 erhalten geblieben ist. Der mitgelieferte Korpus ist ein Testbett und eine Demo: 170 Seiten ueber den Stack selbst - Gates, Lint, Versionierung, Suche, das Wiki-Muster. Er dokumentiert das Werkzeug mit den eigenen Mitteln des Werkzeugs. Lizenz: AGPL-3.0 fuer den Stack (tools/, types/), CC-BY-4.0 fuer die Inhalte. Die Grenze zwischen beiden ist der Dateiplan, den dist export berechnet - siehe NOTICE.
87 lines
3.6 KiB
Plaintext
87 lines
3.6 KiB
Plaintext
<!-- 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>
|
|
|
|
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.
|
|
|
|
**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`.
|
|
|
|
**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.
|
|
|
|
**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.
|
|
|
|
**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.
|
|
|
|
## Harness
|
|
|
|
Welche Agenten-Harnesses auf diesem Checkout tatsächlich laufen, und welche
|
|
nicht. Relevant, weil `.agents/skills/` und `.claude/skills/` unterschiedliche
|
|
Leser haben.
|
|
|
|
- **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>
|
|
|
|
## 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.
|
|
|
|
- **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>
|
|
|
|
## MCP-Server
|
|
|
|
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.
|
|
|
|
| Server | Wofür | Anmerkung |
|
|
|--------|-------|-----------|
|
|
| `<name>` | <z. B. Issues, CI-Runs, Releases> | <z. B. bevorzugt gegenüber curl> |
|
|
|
|
## Connectoren und Integrationen
|
|
|
|
Alles, was kein MCP-Server ist, aber trotzdem an dieser Instanz hängt:
|
|
Dokument-Connectoren, Chat-Anbindungen, Notiz-Systeme.
|
|
|
|
- <z. B. Obsidian-Vault unter ~/..., liest kb/ read-only — oder streichen>
|
|
|
|
## 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.
|
|
|
|
| Remote | URL | Rolle |
|
|
|--------|-----|-------|
|
|
| `origin` | <URL> | <z. B. Publish-Ziel, CI läuft dort> |
|
|
|
|
## CI
|
|
|
|
Wo die Pipeline läuft und wie ihre Läufe gelesen werden — nicht *was* sie
|
|
prüft, das steht 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>
|
|
|
|
## Sonstiges
|
|
|
|
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/`.
|