Chemenu 2.1.0 - deterministischer Wissenskompiler
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.
This commit is contained in:
@@ -0,0 +1,136 @@
|
||||
---
|
||||
type: types/entity.md
|
||||
entity_type: system
|
||||
tags: [schema, configuration, wiki, operating-system]
|
||||
created: 2026-08-03
|
||||
modified: 2026-08-31
|
||||
related: [wikitool, Naming Convention Conflict, CLAUDE.md, Denylist over Allowlist, ENVIRONMENT.md]
|
||||
sources: [Source - LLM Improvements Codex Analysis, Source - LLM Improvements Sonnet Analysis, Source - LLM Wiki v2, Source - Copilot Skill Restructure Instructions, Source - Conversation - AGENTS.md Skill Restructuring Session 2026-08-04, Source - LLM Improvements Production Agent Gaps 2026, Source - Conversation - Comma Bug Budget Refund and Lint Report Path Session 2026-08-31, Source - Conversation - Hardening the Test Suite Against Silent Environment Dependencies Session 2026-08-31, Source - Conversation - ENVIRONMENT.md as an Optional Third Session-Level File Session 2026-08-31]
|
||||
confidence: 0.90
|
||||
confidence_base: 0.90
|
||||
provenance: sourced
|
||||
summary: 'Kontrollebene des LLM-Wikis: Invarianten, Dateibenennung, Routing, Gates, seit 1.1.0 Personalization und seit 1.8.0 der Environment-Abschnitt; erreicht Claude Code nur ueber den Import in CLAUDE.md'
|
||||
---
|
||||
# AGENTS.md
|
||||
|
||||
**Typ:** system
|
||||
|
||||
## Beschreibung
|
||||
|
||||
AGENTS.md ist das Schema und Betriebssystem für die LLM Wiki. Es definiert die vollständige Methodik, wie die LLM die Wiki pflegt, Quellen verarbeitet, Anfragen beantwortet, Linting durchführt, Seiten erstellt und Konsistenz über alle Operationen hinweg aufrechterhält. Das Dokument etabliert den Grundsatz „Niemals ableiten. Immer kompilieren." und erzwingt eine strenge Trennung zwischen mechanischen Operationen (von wikitool gehandhabt) und semantischen Operationen (von der LLM gehandhabt).
|
||||
|
||||
Die Codex-Analyse identifizierte AGENTS.md als Bereitstellung einer deterministisch erzwungenen Grundlage, die vielen öffentlichen LLM-Wiki-Skills voraus ist. Sie kodifiziert Workflows (INGEST, QUERY, LINT, CREATE, UPDATE), Qualitätsstandards, Namenskonventionen, Seitenformate, Cross-Reference-Regeln und die drei-schichtige Architektur (Rohquellen, von LLM verwaltete Wiki, Schema).
|
||||
|
||||
## Kerndaten
|
||||
|
||||
- **Zweck:** Kontrollebene für die Wiki: Invarianten, Dateibenennnung, Routing, Gates
|
||||
- **Status:** Aktiv, unter aktiver Entwicklung
|
||||
- **Version:** Umstrukturiert 2026-08-22 - siehe `CHANGES.md`
|
||||
- **Sprache/Technik:** Markdown, YAML-Frontmatter
|
||||
- **Standort:** Repo-Wurzel: `/AGENTS.md`
|
||||
|
||||
## Beziehungen
|
||||
|
||||
- **Implementiert von:** [[wikitool]]
|
||||
- **Definiert:** [[LLM Wiki Pattern]], [[Three-Layer Architecture]], [[Workflow Orchestration]]
|
||||
- **Verwendet von:** Alle LLM-Operationen in dieser Wiki
|
||||
- **hat:** [[Naming Convention Conflict]]
|
||||
- **Analysiert in:** [[Source - LLM Improvements Codex Analysis]], [[Source - LLM Improvements Sonnet Analysis]]
|
||||
- **verwandt mit:** [[CLAUDE.md]]
|
||||
- **begründet:** [[Denylist over Allowlist]]
|
||||
- **beschreibt:** [[ENVIRONMENT.md]]
|
||||
|
||||
## Hauptabschnitte
|
||||
|
||||
AGENTS.md enthält diese Hauptabschnitte:
|
||||
|
||||
- **Übersicht:** Grundsätze und Architektur
|
||||
- **Werkzeuge:** wikitool-CLI-Befehlsreferenz
|
||||
- **Provenienz und Zitation:** raw_files, Provenienz-Marker, Inline-Zitationen
|
||||
- **Entity-Typen:** Projects, Systems, Tools, Technologies, People
|
||||
- **Concept-Typen:** Architecture, Pattern, Protocol, Workflow, Decision, Problem
|
||||
- **Relationship-Typen:** depends on, uses, implements, extends, replaces, etc.
|
||||
- **Workflows:** ~~INGEST, QUERY, LINT, CREATE, UPDATE mit detaillierten Schritten~~ **abgelöst** - die
|
||||
5 Workflow-Schritt-Listen wurden wörtlich in diskrete Skills unter `.agents/skills/`
|
||||
extrahiert (`wiki-ingest`, `wiki-query`, `wiki-lint`, `wiki-manage` (CREATE+UPDATE zusammengeführt), `wiki-status`
|
||||
(neu, schreibgeschützt)); die Root-Datei enthält jetzt nur eine Zeiger-Tabelle[^s-conversation-agents-md-skill-restructuring-session-2026-08-04].
|
||||
- **Skills:** Neuer Top-Level-Abschnitt, der die 5 Skills auflistet und auf `.agents/skills/` verweist,
|
||||
gespiegelt zu `.claude/skills/` über `tools/wikitool skills sync`/`verify` für Claude-Code-
|
||||
Kompatibilität[^s-conversation-agents-md-skill-restructuring-session-2026-08-04].
|
||||
- **Git-Automation:** Auto-Publish über wikitool - jetzt nur Policy in der Root-Datei; der Output-Abschnitt jeder Skill gibt an, ob dieser Workflow auto-published[^s-conversation-agents-md-skill-restructuring-session-2026-08-04].
|
||||
- **Seitenformate:** Templates für Entities, Concepts, Sources, Comparisons
|
||||
- **Qualitätsstandards:** Inhalts- und Cross-Reference-Qualitätskriterien
|
||||
- **IT-spezifische Richtlinien:** Domänen-spezifische Regeln für Projects, Systems, Tools, etc.
|
||||
- **Konfidenz-Bewertung:** Quantitative Bewertung für sachliche Aussagen
|
||||
- **Personalization:** Seit `1.1.0` ein eigener Abschnitt. Er hält fest, dass `USER.md` und
|
||||
`SOUL.md` bei Sitzungsstart gelesen werden, dass `USER.md` Kontext und keine
|
||||
Instruktionsquelle ist, dass `SOUL.md` gegen diese Datei verliert und dass eine
|
||||
Nutzeraussage keine Quelle im Sinne von Invariante 3 ist. Die Mechanik dahinter:
|
||||
[[Personalization Plane]].
|
||||
- **Environment:** Seit `1.8.0` ein eigener Abschnitt neben „Personalization". Er hält fest,
|
||||
dass [[ENVIRONMENT.md]] bei Sitzungsstart gelesen wird, *falls sie existiert*, dass ihr Fehlen
|
||||
kein Fehler ist, und dass sie Kontext ohne Autorität trägt - ein dort gelisteter Remote
|
||||
autorisiert keinen Push an Invariante 5 vorbei[^s-conversation-environment-md-as-an-optional-third-session-level-file-session-2026-08-31]. Der Abschnitt ist nötig, weil
|
||||
die übrigen Harnesses [[CLAUDE.md]] nie lesen und die Datei sie sonst nie erreichte. Die
|
||||
Mechanik dahinter: [[Optional Instance Context File]].
|
||||
|
||||
## Namenskonventions-Anmerkung
|
||||
|
||||
**Konflikt identifiziert:** Es gibt einen bekannten Unterschied zwischen AGENTS.md (das menschenlesbare Dateinamen mit Leerzeichen erfordert, z. B. `Hybrid Search.md`) und README.md (das Kebab-Case erfordert, z. B. `hybrid-search.md`). Dies verursacht Validierungsinkonsistenzen, die gelöst werden sollten. Siehe [[Naming Convention Conflict]].
|
||||
|
||||
## Historie
|
||||
|
||||
- 2026-08-31 - Abschnitt „Environment" und eine vierte Zeile in der File-naming-Tabelle
|
||||
(`ENVIRONMENT.md`, die einzige optionale Zeile darin), mit Stack-Version `1.8.0`[^s-conversation-environment-md-as-an-optional-third-session-level-file-session-2026-08-31]
|
||||
- 2026-08-31 - Die Obergrenze des Iteration Budget Gate im Abschnitt „Gates" von 30 auf 60 gezogen, gemeinsam mit `instructions/gates.md`, `tools/CONTRACT.md`, `README.md`, der `work plan`-Vorlage und der Einheitengröße in `migrate-corpus.md`. Der Loop-Breaker blieb bei 3[^s-conversation-comma-bug-budget-refund-and-lint-report-path-session-2026-08-31]
|
||||
- 2026-08-30 - Abschnitt „Personalization" und drei neue Zeilen in der File-naming-Tabelle
|
||||
(`CLAUDE.md`, `USER.md`, `SOUL.md`). Im selben Zug stellte sich heraus, dass diese
|
||||
Datei [[Claude Code]] nie erreicht hatte, weil dieses Harness ausschließlich [[CLAUDE.md]]
|
||||
lädt
|
||||
|
||||
- 2026-08-04 - Umstrukturiert: Die 5 Workflow-Abschnitte wurden in `.agents/skills/`-Skills extrahiert (`wiki-ingest`, `wiki-query`, `wiki-lint`, `wiki-manage`, `wiki-status`), Datei von 745 auf ~573 Zeilen reduziert, neue „## Skills"-Sektion und Git-Automation-Policy-only-Umschreiben[^s-conversation-agents-md-skill-restructuring-session-2026-08-04].
|
||||
- 2026-08-03 - Seite während der Aufnahme der Codex-Analyse erstellt
|
||||
- 2026-08-02 - Namenskonventionen auf menschenlesbare Titel mit Leerzeichen aktualisiert
|
||||
- 2026-07-26 - Mit Git-Automation- und Tooling-Abschnitten aktualisiert
|
||||
- 2026-07-25 - Initiales IT-fokussiertes Schema erstellt
|
||||
|
||||
## Analyseergebnisse
|
||||
|
||||
Die Sonnet-Analyse kam zu dem Ergebnis, dass AGENTS.md in drei Schlüsselbereichen konzeptionell bereits vor den meisten öffentlichen LLM-Wiki-Implementierungen ist:
|
||||
- **Provenienz und Zitation:** Die raw_files:, provenance:, [^s-llm-wiki-v2]-Marker und provenance.md-Rückwärtsindex bieten ungewöhnlich reife Coverage[^s-llm-improvements-sonnet-analysis]
|
||||
- **Deterministisches CLI:** wikitool handhabt mechanische Operationen präzise, anstatt an Ad-hoc-LLM-Scripts zu delegieren[^s-llm-improvements-sonnet-analysis]
|
||||
- **Konfidenz-Bewertung:** Die Verfallsformel und das Bewertungssystem existieren und funktionieren effektiv[^s-llm-improvements-sonnet-analysis]
|
||||
|
||||
Die Sonnet-Analyse identifizierte jedoch Lücken, wo AGENTS.md verbessert werden könnte:
|
||||
- Einen Abschnitt „Content Quality & Style" mit Seitenlängen-Schwellwerten und Style-Guide-Regeln hinzufügen[^s-llm-improvements-sonnet-analysis]
|
||||
- Session-Orientierung als obligatorischen ersten Schritt für alle Workflows einbauen[^s-llm-improvements-sonnet-analysis]
|
||||
|
||||
## Siehe auch
|
||||
|
||||
- [[wikitool]]
|
||||
- [[LLM Wiki Pattern]]
|
||||
- [[Three-Layer Architecture]]
|
||||
- [[Naming Convention Conflict]]
|
||||
- [[Content Quality Control]]
|
||||
- [[Session Orientation]]
|
||||
- [[Cross-platform Agent Skills]]
|
||||
- [[Source - LLM Improvements Codex Analysis]][^s-llm-improvements-codex-analysis]
|
||||
- [[Source - LLM Improvements Sonnet Analysis]]
|
||||
- [[Source - LLM Wiki v2]]
|
||||
- [[Source - Copilot Skill Restructure Instructions]]
|
||||
- [[Source - Conversation - AGENTS.md Skill Restructuring Session 2026-08-04]]
|
||||
- [[Source - LLM Improvements Production Agent Gaps 2026]]
|
||||
- [[CLAUDE.md]]
|
||||
- [[Denylist over Allowlist]]
|
||||
- [[Source - Conversation - Hardening the Test Suite Against Silent Environment Dependencies Session 2026-08-31]]
|
||||
- [[ENVIRONMENT.md]]
|
||||
- [[Source - Conversation - ENVIRONMENT.md as an Optional Third Session-Level File Session 2026-08-31]]
|
||||
|
||||
## Fußnoten
|
||||
|
||||
[^s-conversation-agents-md-skill-restructuring-session-2026-08-04]: [[Source - Conversation - AGENTS.md Skill Restructuring Session 2026-08-04]]
|
||||
[^s-conversation-environment-md-as-an-optional-third-session-level-file-session-2026-08-31]: [[Source - Conversation - ENVIRONMENT.md as an Optional Third Session-Level File Session 2026-08-31]]
|
||||
[^s-conversation-comma-bug-budget-refund-and-lint-report-path-session-2026-08-31]: [[Source - Conversation - Comma Bug Budget Refund and Lint Report Path Session 2026-08-31]]
|
||||
[^s-llm-wiki-v2]: [[Source - LLM Wiki v2]]
|
||||
[^s-llm-improvements-sonnet-analysis]: [[Source - LLM Improvements Sonnet Analysis]]
|
||||
[^s-llm-improvements-codex-analysis]: [[Source - LLM Improvements Codex Analysis]]
|
||||
@@ -0,0 +1,97 @@
|
||||
---
|
||||
type: types/entity.md
|
||||
entity_type: system
|
||||
tags: []
|
||||
created: 2026-08-31
|
||||
modified: 2026-09-01
|
||||
related: [AGENTS.md, ENVIRONMENT.md]
|
||||
sources: [Source - Conversation - ENVIRONMENT.md as an Optional Third Session-Level File Session 2026-08-31]
|
||||
confidence: 0.50
|
||||
confidence_base: 0.50
|
||||
provenance: sourced
|
||||
summary: Datei, die Claude Code beim Sitzungsstart laedt; importiert AGENTS.md/USER.md/SOUL.md und seit 1.8.0 ENVIRONMENT.md, traegt selbst keine Regeln
|
||||
---
|
||||
# CLAUDE.md
|
||||
|
||||
**Typ:** System
|
||||
|
||||
## Beschreibung
|
||||
|
||||
`CLAUDE.md` ist die Datei, die [[Claude Code]] beim Sitzungsstart automatisch lädt. In
|
||||
[[Chemenu]] enthält sie **keine eigenen Regeln**, sondern ausschließlich Importe:
|
||||
`@AGENTS.md`, `@USER.md` und `@SOUL.md`, seit Stack-Version `1.8.0` zusätzlich
|
||||
`@ENVIRONMENT.md`[^s-conversation-environment-md-as-an-optional-third-session-level-file-session-2026-08-31]. Ihr einziger Zweck ist, die Kontrollebene in ein
|
||||
Harness zu bringen, das sie sonst nicht sieht.
|
||||
|
||||
Der Grund ist eine Asymmetrie zwischen den Agenten-Werkzeugen: Codex CLI, GitHub Copilot und
|
||||
Mistral Vibe lesen [[AGENTS.md]] nativ, Claude Code nicht. Solange keine `CLAUDE.md` existierte,
|
||||
lief jede Claude-Code-Sitzung ohne Invarianten, Routing und Gate-Regeln - es sei denn, der Agent
|
||||
öffnete `AGENTS.md` von sich aus. Der Defekt blieb unbemerkt, weil er unter keinem anderen
|
||||
Harness auftrat.
|
||||
|
||||
## Kerndaten
|
||||
|
||||
- **Zweck:** Kontrollebene und Personalization Plane in Claude-Code-Sitzungen laden
|
||||
- **Status:** Aktiv, eingeführt mit Stack-Version `1.1.1`
|
||||
- **Version:** eingeführt 2026-08-30, Commit `adfa220`
|
||||
- **Sprache/Technik:** Markdown mit `@pfad`-Importsyntax
|
||||
- **Standort:** Repo-Wurzel: `/CLAUDE.md`
|
||||
- **Ausgeliefert:** ja, über die Root-Allowlist von `dist export`
|
||||
|
||||
## Beziehungen
|
||||
- **importiert:** [[AGENTS.md]]
|
||||
- **importiert:** [[ENVIRONMENT.md]]
|
||||
|
||||
## Details
|
||||
|
||||
### Warum keine eigenen Regeln
|
||||
|
||||
Eine Regel in `CLAUDE.md` wäre eine zweite Kopie einer bereits existierenden Regel und damit ein
|
||||
Verstoß gegen Invariante 8 von [[AGENTS.md]]. Sie wäre zugleich die am schnellsten driftende
|
||||
Kopie, weil nur ein einziges Harness sie liest: eine Abweichung fiele unter Codex oder Copilot
|
||||
gar nicht auf. Die Datei beschränkt sich deshalb auf Importe und die Begründung, warum sie
|
||||
existiert.
|
||||
|
||||
### Auslieferung
|
||||
|
||||
`CLAUDE.md` steht in `ROOT_FILES` von `tools/chemenu/commands/dist_cmd.py` und geht damit in
|
||||
jede Distribution - aus demselben Grund wie `.claude/settings.json`: eine ausgelieferte Instanz
|
||||
unter Claude Code hätte sonst denselben Defekt. Anders als bei `USER.md` und `SOUL.md` wird die
|
||||
Datei selbst ausgeliefert und nicht als Template, weil sie keinen persönlichen Inhalt trägt.
|
||||
|
||||
### Kein doctor-Check
|
||||
|
||||
Für `CLAUDE.md` gibt es bewusst keinen `wikitool doctor`-Check. Die Datei ist
|
||||
harness-spezifisch; eine Instanz, die ausschließlich unter Codex CLI betrieben wird, braucht sie
|
||||
nicht, und ein `FAIL` wäre dort schlicht falsch. Das unterscheidet sie von `USER.md` und
|
||||
`SOUL.md`, die jedes Harness liest und die deshalb geprüft werden - siehe
|
||||
[[Personalization Plane]].
|
||||
|
||||
### Verhalten während der Installation
|
||||
|
||||
Während des Setups einer frischen Instanz existieren `USER.md` und `SOUL.md` noch nicht; sie
|
||||
entstehen erst im Personalization-Schritt. Die Setup-Sitzung löst daher nur `@AGENTS.md` auf.
|
||||
Ob Claude Code einen fehlenden `@import` still überspringt oder meldet, ist **unbestätigt** und
|
||||
wurde in der einführenden Sitzung nicht geprüft.
|
||||
|
||||
Mit [[ENVIRONMENT.md]] wiegt diese offene Frage seit `1.8.0` schwerer: jene Datei ist optional
|
||||
und gitignored, ein unaufgelöster Import ist dort also kein Übergangszustand während des Setups,
|
||||
sondern der Normalfall[^s-conversation-environment-md-as-an-optional-third-session-level-file-session-2026-08-31]. Auch die Sitzung, die den Import einführte, hat das
|
||||
Verhalten nicht beobachtet - sie fügte ihn einer laufenden Sitzung hinzu, deren Kontext bereits
|
||||
geladen war.
|
||||
|
||||
## Historie
|
||||
|
||||
- 2026-08-30 - Angelegt mit Stack-Version `1.1.1` (Commit `adfa220`), nachdem aufgefallen war,
|
||||
dass `AGENTS.md` Claude Code nie erreicht hatte
|
||||
- 2026-08-03 - Die Seite [[AGENTS.md]] führte `CLAUDE.md` bereits als „analoge
|
||||
Konfigurationsdatei für Claude Code" - zu diesem Zeitpunkt gab es die Datei im Repo nicht
|
||||
|
||||
## Siehe auch
|
||||
- [[AGENTS.md]]
|
||||
- [[ENVIRONMENT.md]]
|
||||
- [[Source - Conversation - ENVIRONMENT.md as an Optional Third Session-Level File Session 2026-08-31]]
|
||||
|
||||
## Fußnoten
|
||||
|
||||
[^s-conversation-environment-md-as-an-optional-third-session-level-file-session-2026-08-31]: [[Source - Conversation - ENVIRONMENT.md as an Optional Third Session-Level File Session 2026-08-31]]
|
||||
@@ -0,0 +1,86 @@
|
||||
---
|
||||
type: types/entity.md
|
||||
entity_type: system
|
||||
tags: [energy-storage, solar, battery, home-automation]
|
||||
created: 2026-07-25
|
||||
modified: 2026-08-29
|
||||
related: [ha-core, hacs-e3dc, hacs-integration-blueprint, Home Assistant, E3DC GmbH]
|
||||
sources: []
|
||||
confidence: 0.80
|
||||
confidence_base: 0.80
|
||||
provenance: general
|
||||
summary: Deutsches Heim-Energiespeichersystem, das Solarstromerzeugung mit Lithium-Batteriespeicher für Eigenverbrauch und Notstrom verbindet.
|
||||
---
|
||||
# E3DC
|
||||
|
||||
**Typ:** System
|
||||
|
||||
## Beschreibung
|
||||
|
||||
E3DC (Energy 3DC) ist ein deutscher Hersteller von Heimenergiespeichersystemen. Diese Systeme kombinieren Solarenergieerzeugung mit Batteriespeichern und ermöglichen es Hausbesitzern, die Eigennutzung von Solarenergie zu maximieren und Backupstrom bereitzustellen.
|
||||
|
||||
Das E3DC-System umfasst typischerweise:
|
||||
- Hybrid-Wechselrichter/Ladegerät
|
||||
- Lithium-Ionen-Batteriespeicher
|
||||
- Energiemanagementsystem
|
||||
- Überwachungs- und Steuerungsschnittstellen
|
||||
|
||||
## Kerndaten
|
||||
|
||||
- **Typ:** Heimenergiespeichersystem
|
||||
- **Hersteller:** [[E3DC GmbH]]
|
||||
- **Primärer Zweck:** Solarenergiespeicherung und -verwaltung
|
||||
- **Status:** Kommerzielles Produkt (aktiv)
|
||||
|
||||
## Beziehungen
|
||||
|
||||
- **Integriert mit:** [[Home Assistant]] über [[ha-core]], [[hacs-e3dc]]
|
||||
- **Verwendet von:** Hausbesitzer, Installateure, Systemintegratoren
|
||||
- **Verwandt mit:** [[hacs-integration-blueprint]]
|
||||
- **Teil von:** Heimenergiemanagement-Ökosystem
|
||||
|
||||
## Technische Details
|
||||
|
||||
### Kommunikation
|
||||
|
||||
E3DC-Systeme stellen typischerweise zur Verfügung:
|
||||
- Modbus-TCP-Schnittstelle
|
||||
- REST-API (variiert je nach Modell)
|
||||
- Lokale Web-Schnittstelle
|
||||
- Cloud-Konnektivität (optional)
|
||||
|
||||
### Gängige Modelle
|
||||
|
||||
- S10 E (10 kWh)
|
||||
- S10 E Mini
|
||||
- Verschiedene kommerzielle/industrielle Modelle
|
||||
|
||||
### Datenpunkte
|
||||
|
||||
Typische Überwachungsdaten umfassen:
|
||||
- Batterieladezustand (SOC)
|
||||
- Batterieenergie (Laden/Entladen)
|
||||
- PV-Erzeugung
|
||||
- Hausverbrauch
|
||||
- Netzbezug/-einspeisung
|
||||
- Systemstatus und Alarme
|
||||
|
||||
## Integrationsansätze
|
||||
|
||||
1. **Direktes Modbus** - Am zuverlässigsten, erfordert Netzwerkzugriff auf Wechselrichter
|
||||
2. **Lokale API** - HTTP-basiert, variiert je nach Firmware-Version
|
||||
3. **Cloud-API** - Erfordert Internet, kann Ratenlimits haben
|
||||
4. **Home-Assistant-Integration** - Über [[ha-core]] und [[hacs-e3dc]]
|
||||
|
||||
## Historie
|
||||
|
||||
- [2026-07-25] - Entity-Seite erstellt als Teil des anfänglichen Wiki-Gerüsts
|
||||
|
||||
## Siehe auch
|
||||
|
||||
- [[E3DC GmbH]]
|
||||
- [[Home Assistant]]
|
||||
- [[ha-core]]
|
||||
- [[hacs-e3dc]]
|
||||
- [[hacs-integration-blueprint]]
|
||||
- [[Modbus]] Protocol
|
||||
@@ -0,0 +1,117 @@
|
||||
---
|
||||
type: types/entity.md
|
||||
entity_type: system
|
||||
tags: []
|
||||
created: 2026-08-31
|
||||
modified: 2026-08-31
|
||||
related: [CLAUDE.md, Optional Instance Context File, AGENTS.md]
|
||||
sources: [Source - Conversation - ENVIRONMENT.md as an Optional Third Session-Level File Session 2026-08-31]
|
||||
confidence: 0.50
|
||||
confidence_base: 0.50
|
||||
provenance: sourced
|
||||
summary: 'Optionale, gitignorete Root-Datei: Harness, Skills, MCP-Server, Connectoren, Remotes und CI-Ort eines Checkouts; doctor meldet sie, scheitert aber nie an ihr'
|
||||
---
|
||||
# ENVIRONMENT.md
|
||||
|
||||
**Typ:** System
|
||||
|
||||
## Beschreibung
|
||||
|
||||
`ENVIRONMENT.md` hält fest, womit *ein bestimmter Checkout* arbeitet: welches Harness läuft,
|
||||
welche Skills publiziert sind, welche MCP-Server erreichbar sind, welche Connectoren dranhängen,
|
||||
wohin `publish` veröffentlicht und wo CI läuft. Es ist das dritte Root-Dokument der
|
||||
Sitzungsebene neben `USER.md` und `SOUL.md`, und es beantwortet die Frage, die die beiden offen
|
||||
lassen: `USER.md` sagt, *wer* die Instanz bedient, `SOUL.md`, *wie* sie klingt — womit sie
|
||||
arbeitet, sagte bis dahin niemand.
|
||||
|
||||
Das Problem war nicht Unkenntnis, sondern Wiederholung. Es sind über Wochen konstante Werte, die
|
||||
trotzdem jede Sitzung neu erfragte, weil nichts sie festhielt.
|
||||
|
||||
Die Datei ist **optional** und **gitignored**. Beides unterscheidet sie von der
|
||||
[[Personalization Plane]], deren Muster sie sonst übernimmt; die Verallgemeinerung steht unter
|
||||
[[Optional Instance Context File]].
|
||||
|
||||
## Kerndaten
|
||||
|
||||
- **Zweck:** Harness, Skills, MCP-Server, Connectoren, Remotes und CI-Ort eines Checkouts festhalten
|
||||
- **Status:** Aktiv, eingeführt mit Stack-Version `1.8.0`[^s-conversation-environment-md-as-an-optional-third-session-level-file-session-2026-08-31]
|
||||
- **Version:** eingeführt 2026-08-31, Commit `a243a4a`[^s-conversation-environment-md-as-an-optional-third-session-level-file-session-2026-08-31]
|
||||
- **Sprache/Technik:** Markdown, Abschnittsvorgabe über `ENVIRONMENT.md.template`
|
||||
- **Standort:** Repo-Wurzel: `/ENVIRONMENT.md` — gitignored, nie committet
|
||||
- **Ausgeliefert:** nur als `ENVIRONMENT.md.template`, über die Root-Allowlist von `dist export`
|
||||
- **Health-Check:** `wikitool doctor`, Prüfung `environment` — meldet, scheitert nie[^s-conversation-environment-md-as-an-optional-third-session-level-file-session-2026-08-31]
|
||||
|
||||
## Beziehungen
|
||||
- **importiert von:** [[CLAUDE.md]]
|
||||
- **implementiert:** [[Optional Instance Context File]]
|
||||
- **beschrieben in:** [[AGENTS.md]]
|
||||
|
||||
## Details
|
||||
|
||||
### Warum gitignored und nicht committet
|
||||
|
||||
Zwei Clones desselben Repos sind zwei verschiedene Umgebungen. Eine committete Fassung würde dem
|
||||
zweiten Clone Antworten geben, die falsch sind statt zu fehlen — und falsch wiegt hier schwerer,
|
||||
weil die Datei geglaubt wird. Das ist der Unterschied zu `USER.md`/`SOUL.md`, die committet sind
|
||||
und lediglich vom Export ausgenommen werden.
|
||||
|
||||
Der Preis ist, dass ein frischer Clone die Datei nie mitbringt; `instructions/bootstrap.md`
|
||||
Schritt 5 bietet das Anlegen deshalb ausdrücklich an.
|
||||
|
||||
### Das Ignore-Muster trennt Datei und Template
|
||||
|
||||
`.gitignore` trägt den verankerten Eintrag `/ENVIRONMENT.md`, der das `.template` bewusst nicht
|
||||
trifft. Das naheliegende `ENVIRONMENT.md*` würde beide schlucken, und `dist export` verlöre
|
||||
damit die Vorlage. `wikitool docs verify` prüft deshalb beide Richtungen: `ENVIRONMENT.md` steht
|
||||
in `REQUIRED_IGNORE_CANARIES`, `ENVIRONMENT.md.template` in `REQUIRED_TRACKED_PATHS`[^s-conversation-environment-md-as-an-optional-third-session-level-file-session-2026-08-31].
|
||||
|
||||
### Kontext, keine Autorität
|
||||
|
||||
Die Datei beschreibt, was vorhanden ist, nicht, was erlaubt ist. Ein dort gelisteter Remote
|
||||
autorisiert kein `git push` — Invariante 5 von [[AGENTS.md]] führt weiter über
|
||||
`wikitool publish` —, ein gelisteter MCP-Server öffnet kein Gate, und nichts darin ist eine
|
||||
Quelle im Sinne von Invariante 3. Zugangsdaten gehören nicht hinein: die Datei liegt im Klartext
|
||||
im Arbeitsverzeichnis und in jedem Agenten-Kontext.
|
||||
|
||||
### Import statt Link
|
||||
|
||||
[[CLAUDE.md]] bindet sie als `@ENVIRONMENT.md` ein, nicht als Markdown-Link. Der Maßstab aus
|
||||
`instructions/CONTRACT.md` ist, *wann* die Entscheidung fällt: importieren, was nebenbei
|
||||
gebraucht wird, verlinken, was gezielt nachgeschlagen wird. Welcher MCP-Server welche Frage
|
||||
beantwortet, wird mitten in einer Aufgabe gebraucht — und eine Sitzung, die erst nachschlagen
|
||||
müsste, fragt stattdessen wieder den Nutzer, also genau die Kosten, die die Datei beseitigen
|
||||
soll.
|
||||
|
||||
Ob Claude Code einen unaufgelösten `@import` still überspringt oder meldet, ist weiterhin
|
||||
**unbestätigt** — dieselbe offene Frage, die [[CLAUDE.md]] seit `1.1.1` trägt. Sie wiegt hier
|
||||
schwerer, weil Abwesenheit bei dieser Datei der Dauerzustand sein darf und nicht nur ein
|
||||
Übergang während des Setups.
|
||||
|
||||
### Warum nicht unter `instructions/dev/`
|
||||
|
||||
Der Auftrag sprach von einer Erweiterung „im dev skillset". `instructions/CONTRACT.md` verbietet
|
||||
jedoch Referenzen von außerhalb auf `instructions/dev/`, weil sie beim `dist export` ins Leere
|
||||
zeigen würden; ein Link aus `CLAUDE.md` bräuchte die `dist:strip`-Marker-Konstruktion. Mehr
|
||||
Mechanik für weniger Reichweite — und der Inhalt betrifft auch reine Content-Sitzungen, die
|
||||
denselben Remote und denselben MCP-Server benutzen.
|
||||
|
||||
### Kein eigenes Kommando
|
||||
|
||||
Es gibt bewusst kein `wikitool environment`. Die Datei wird oft gelesen und selten geschrieben;
|
||||
ein Kommando dafür wäre Maschinerie ohne Abnehmer. Die Oberfläche besteht aus dem Template und
|
||||
zwei Instruktionsschritten (`bootstrap.md` Schritt 5, `setup-instance.md` Schritt 9).
|
||||
|
||||
## Historie
|
||||
|
||||
- 2026-08-31 — Angelegt mit Stack-Version `1.8.0` (Commit `a243a4a`), aus Gitea-Issue #24[^s-conversation-environment-md-as-an-optional-third-session-level-file-session-2026-08-31]
|
||||
|
||||
## Siehe auch
|
||||
- [[CLAUDE.md]]
|
||||
- [[AGENTS.md]]
|
||||
- [[Personalization Plane]]
|
||||
- [[Optional Instance Context File]]
|
||||
- [[Source - Conversation - ENVIRONMENT.md as an Optional Third Session-Level File Session 2026-08-31]]
|
||||
|
||||
## Fußnoten
|
||||
|
||||
[^s-conversation-environment-md-as-an-optional-third-session-level-file-session-2026-08-31]: [[Source - Conversation - ENVIRONMENT.md as an Optional Third Session-Level File Session 2026-08-31]]
|
||||
@@ -0,0 +1,98 @@
|
||||
---
|
||||
type: types/entity.md
|
||||
entity_type: system
|
||||
tags: [history, knowledge-management, concept, '1945']
|
||||
created: 2026-07-26
|
||||
modified: 2026-08-29
|
||||
related: [Vannevar Bush, LLM Wiki Pattern]
|
||||
sources: [Source - LLM Wiki Pattern]
|
||||
confidence: 0.90
|
||||
confidence_base: 0.90
|
||||
provenance: sourced
|
||||
summary: Vannevar Bushs Konzept eines Wissensmanagementsystems von 1945 mit assoziativen Pfaden und Hypertext; geistiger Vorläufer moderner Wikis.
|
||||
---
|
||||
# Memex
|
||||
|
||||
**Typ:** System (Konzeptionelles Wissensmanagement-System)
|
||||
|
||||
## Beschreibung
|
||||
|
||||
Memex (Memory Extender) ist ein konzeptionelles Wissensmanagement-System, das [[Vannevar Bush]] in seinem Artikel "As We May Think" von 1945 vorgeschlagen hat. Es stellt eine frühe Vision von Hypertext und persönlichem Wissensmanagement dar, die dem modernen Web vorausgeht und direkt das [[LLM Wiki Pattern]] inspiriert.
|
||||
|
||||
## Kerndaten
|
||||
|
||||
- **Vorgeschlagen von:** [[Vannevar Bush]]
|
||||
- **Jahr:** 1945
|
||||
- **Status:** Konzeptionell (wurde nie physisch gebaut)
|
||||
- **Einfluss:** Hypertext, World Wide Web, Persönliches Wissensmanagement
|
||||
|
||||
## Beziehungen
|
||||
|
||||
- **Erfunden von:** [[Vannevar Bush]]
|
||||
- **Geistiger Vorgänger von:** [[LLM Wiki Pattern]]
|
||||
- **Verwandtes Konzept:** [[Knowledge Compounding]]
|
||||
|
||||
## Konzept-Übersicht
|
||||
|
||||
Memex wurde als ein Gerät konzipiert, das:
|
||||
|
||||
### Kernfunktionen
|
||||
- Alle Bücher, Aufzeichnungen und Kommunikation eines Benutzers speichern
|
||||
- Sofortige Abrufbarkeit jedes Elements ermöglichen
|
||||
- **Assoziative Pfade** unterstützen - von Benutzern erstellte Links zwischen Dokumenten
|
||||
- Erstellung neuer Pfade durch Kombinieren bestehender ermöglichen
|
||||
- Eine permanente Aufzeichnung aller Hinzufügungen und Änderungen führen
|
||||
|
||||
### Assoziative Indexierung
|
||||
Anstelle hierarchischer oder alphabetischer Ordnung nutzte Memex **assoziative Indexierung**:
|
||||
- Elemente sind basierend auf benutzerdefinierten Beziehungen verlinkt
|
||||
- Pfade können wie Wege durch Wissen erstellt und verfolgt werden
|
||||
- Verbindungen zwischen Dokumenten sind gleichberechtigte Einträge
|
||||
|
||||
### Physische Beschreibung
|
||||
Bush stellte sich Memex als ein Gerät vor mit:
|
||||
- Schreibtischgroßem Format mit transparenten Bildschirmen
|
||||
- Mikrofilm-basierter Speicherung (hochmoderne Technologie der Zeit)
|
||||
- Tastatur und Schaltflächen zur Bedienung
|
||||
- Optischer Zeichenerkennung für die Eingabe
|
||||
|
||||
## Bezug zum LLM Wiki Pattern
|
||||
|
||||
Der [[LLM Wiki Pattern]]-Artikel vermerkt, dass Memex:
|
||||
- dem LLM-Wiki-Pattern näher im Geist steht als dem, was das Web wurde
|
||||
- privat und aktiv kuratiert ist (gegenüber dem öffentlichen, passiv konsumierten Web)
|
||||
- Verbindungen zwischen Dokumenten ebenso wertvoll erachtet wie die Dokumente selbst
|
||||
- **Das fehlende Stück:** Bush konnte nicht lösen, wer die Wartung übernehmen würde. Das LLM-Wiki-Pattern beantwortet dies mit LLMs, die die Verwaltung übernehmen.
|
||||
|
||||
## Vermächtnis und Einfluss
|
||||
|
||||
### Direkter Einfluss
|
||||
- Inspirierte Ted Nelsons **Xanadu**-Projekt (Hypertext)
|
||||
- Beeinflusste Tim Berners-Lees **World Wide Web**
|
||||
- Vorausgegangen für moderne **Wikis** und **Wissensgraphen**
|
||||
|
||||
### Moderne Realisierungen
|
||||
- Werkzeuge für persönliches Wissensmanagement (Obsidian, Roam Research etc.)
|
||||
- Das LLM-Wiki-Pattern selbst
|
||||
- Fan-Wikis wie [[Tolkien Gateway]]
|
||||
|
||||
## Vergleich mit modernen Systemen
|
||||
|
||||
| Merkmal | Memex (1945) | LLM Wiki Pattern | World Wide Web |
|
||||
|---------|--------------|-------------------|----------------|
|
||||
| Privat | Ja | Ja | Nein |
|
||||
| Kuratiert | Ja | Ja | Variabel |
|
||||
| Assoziative Links | Ja | Ja | Ja (Hypertext) |
|
||||
| Automatisierte Wartung | Nein | Ja (LLM) | Nein |
|
||||
| Sofortige Abrufbarkeit | Geplant | Ja | Ja |
|
||||
|
||||
## Historie
|
||||
|
||||
- [1945] - Konzept beschrieben in "As We May Think" (Atlantic Monthly)
|
||||
- [2026-07-26] - Entity-Seite während der Aufnahme des LLM-Wiki-Pattern-Artikels erstellt
|
||||
|
||||
## Siehe auch
|
||||
|
||||
- [[Vannevar Bush]]
|
||||
- [[LLM Wiki Pattern]]
|
||||
- [[Tolkien Gateway]]
|
||||
@@ -0,0 +1,90 @@
|
||||
---
|
||||
type: types/entity.md
|
||||
entity_type: system
|
||||
tags: [wiki, fan-community, example, knowledge-base]
|
||||
created: 2026-07-26
|
||||
modified: 2026-08-29
|
||||
related: [LLM Wiki Pattern, Memex]
|
||||
sources: [Source - LLM Wiki Pattern]
|
||||
confidence: 0.85
|
||||
confidence_base: 0.85
|
||||
provenance: sourced
|
||||
summary: Von Fans erstelltes Wiki mit Tausenden verlinkten Seiten zum Tolkien-Legendarium; Beispiel für den Aufbau einer persönlichen Wissensbasis durch schrittweise Anhäufung.
|
||||
---
|
||||
# Tolkien Gateway
|
||||
|
||||
**Typ:** System (Fan-Wiki / Wissensdatenbank)
|
||||
|
||||
## Beschreibung
|
||||
|
||||
Tolkien Gateway ist ein Fan-erstelltes Wiki, das sich J.R.R. Tolkiens Legendarium widmet. Es dient als Beispiel im [[LLM Wiki Pattern]]-Artikel dafür, was durch inkrementelle Wissensakkumulation aufgebaut werden kann. Das Wiki enthält Tausende miteinander verlinkter Seiten, die Charaktere, Orte, Ereignisse, Sprachen und mehr abdecken.
|
||||
|
||||
## Kerndaten
|
||||
|
||||
- **Typ:** Fan-Wiki / Wissensdatenbank
|
||||
- **Thema:** J.R.R. Tolkiens Werke (Lord of the Rings, Silmarillion, etc.)
|
||||
- **URL:** https://tolkiengateway.net/wiki/Main_Page
|
||||
- **Status:** Aktiv
|
||||
- **Umfang:** Tausende miteinander verlinkter Seiten
|
||||
- **Gepflegt von:** Gemeinschaft von Freiwilligen
|
||||
|
||||
## Beziehungen
|
||||
|
||||
- **Beispiel für:** [[LLM Wiki Pattern]] (was persönlich mit LLM-Unterstützung gebaut werden kann)
|
||||
- **Verwandt mit:** [[Memex]] (ähnliche Vision von vernetztem Wissen)
|
||||
|
||||
## Funktionen
|
||||
|
||||
### Inhaltsabdeckung
|
||||
- Charaktere (Aragorn, Gandalf, Galadriel, etc.)
|
||||
- Orte (Middle-earth, Gondor, Rivendell, etc.)
|
||||
- Ereignisse (War of the Ring, Fall of Gondolin, etc.)
|
||||
- Sprachen (Sindarin, Quenya, Adûnaic, etc.)
|
||||
- Gegenstände (One Ring, Palantíri, etc.)
|
||||
- Rassen (Elves, Dwarves, Hobbits, Men, etc.)
|
||||
- Historische Zeitlinien
|
||||
|
||||
### Struktur
|
||||
- **Verlinkte Seiten:** Umfassende Querverweise zwischen Artikeln
|
||||
- **Kategorien:** Organisiert nach Thementyp
|
||||
- **Templates:** Standardisierte Seitenlayouts
|
||||
- **Quellenangaben:** Zitate aus Tolkiens Werken
|
||||
|
||||
## Bedeutung für das LLM-Wiki-Pattern
|
||||
|
||||
Der [[LLM Wiki Pattern]]-Artikel verwendet Tolkien Gateway als Beispiel:
|
||||
- "Denken Sie an Fan-Wikis wie Tolkien Gateway — Tausende miteinander verlinkter Seiten, die Charaktere, Orte, Ereignisse, Sprachen abdecken, von einer Gemeinschaft von Freiwilligen über Jahre hinweg gebaut."
|
||||
- "Sie könnten persönlich etwas Ähnliches während des Lesens aufbauen, wobei das LLM alle Querverweise und Wartung übernimmt."
|
||||
|
||||
Dies veranschaulicht die **kumulative Wirkung** der Wissensakkumulation:
|
||||
- Was eine Gemeinschaft Jahre kostet, kann persönlich mit LLM-Unterstützung erreicht werden
|
||||
- Das LLM übernimmt die mühsame Querverweisverwaltung und Wartung
|
||||
- Der Mensch konzentriert sich auf Lesen, Verständnis und Lenkung der Analyse
|
||||
|
||||
## Größe und Umfang
|
||||
|
||||
- **Seiten:** Tausende von Artikeln
|
||||
- **Zeitrahmen:** Über viele Jahre gebaut
|
||||
- **Mitwirkende:** Gemeinschaft von Tolkien-Enthusiasten
|
||||
- **Qualität:** Hochdetailliert, gut zitiert, umfassend
|
||||
|
||||
## Vergleich mit LLM-Wiki-Ansatz
|
||||
|
||||
| Aspekt | Tolkien Gateway | LLM Wiki Pattern |
|
||||
|--------|------------------|-------------------|
|
||||
| Schöpfer | Gemeinschaft | Einzelperson + LLM |
|
||||
| Zeit zum Aufbau | Jahre | Wochen/Monate |
|
||||
| Wartung | Gemeinschaftsanstrengung | LLM automatisiert |
|
||||
| Querverweise | Manuell | LLM übernimmt |
|
||||
| Umfang | Einzelne Domäne (Tolkien) | Jede Domäne |
|
||||
|
||||
## Historie
|
||||
|
||||
- [Unbekannt] - Tolkien Gateway gegründet
|
||||
- [2026-07-26] - Entity-Seite während der Aufnahme des LLM-Wiki-Pattern-Artikels erstellt
|
||||
|
||||
## Siehe auch
|
||||
|
||||
- [[LLM Wiki Pattern]]
|
||||
- [[Knowledge Compounding]]
|
||||
- [[Memex]]
|
||||
Reference in New Issue
Block a user