torben
54d9540c08
Files changed: - .wikitool-kb.json - AGENTS.md - CHANGES.md - INSTALL-MCP.md - INSTALL.md - README.md - VERSION - instructions/capture-session.md - instructions/dev/issue-tracking.md - instructions/german-terminology.md - instructions/kb-profiles.md - instructions/migrate-corpus.md - instructions/migrations/5.0.0-confidence-removal.md - instructions/private-instance.md - instructions/setup-instance.md - instructions/wiki-lint/SKILL.md - instructions/wiki-manage/SKILL.md - instructions/wiki-query/SKILL.md - kb/CONTRACT.md - kb/CONVENTIONS.md - kb/CONVENTIONS.md.template - kb/concepts/architectures/Consolidation Tiers.md - kb/concepts/architectures/Context Isolation.md - kb/concepts/architectures/Cross-platform Agent Skills.md - kb/concepts/architectures/Episodic Memory.md - kb/concepts/architectures/Hybrid Search.md - kb/concepts/architectures/Implementation Spectrum.md - kb/concepts/architectures/Knowledge Graph.md - kb/concepts/architectures/LLM Wiki Pattern.md - kb/concepts/architectures/MCP-Leseserver.md - kb/concepts/architectures/Memory Lifecycle.md - kb/concepts/architectures/OKF Compatibility.md - kb/concepts/architectures/Optional Instance Context File.md - kb/concepts/architectures/Personalization Plane.md - kb/concepts/architectures/Procedural Memory.md - kb/concepts/architectures/RAG.md - kb/concepts/architectures/Scale Ceiling.md - kb/concepts/architectures/Semantic Memory.md - kb/concepts/architectures/Three-Layer Architecture.md - kb/concepts/architectures/Token Economics.md - kb/concepts/architectures/Working Memory.md - kb/concepts/decisions/Delete Rather Than Anonymize.md - kb/concepts/decisions/Denylist over Allowlist.md - kb/concepts/decisions/Diff-Reviewable Agent Edits.md - kb/concepts/decisions/Dual Licensing by File Plan.md - kb/concepts/decisions/Issue Label Scheme.md - kb/concepts/decisions/KB Stack Versioning.md - kb/concepts/decisions/Structural Enforcement over Documented Rule.md - kb/concepts/patterns/Audit Trail.md - kb/concepts/patterns/BM25.md - kb/concepts/patterns/Command Round-Trip Integrity.md - kb/concepts/patterns/Confidence Scoring.md - kb/concepts/patterns/Contradiction Resolution.md - kb/concepts/patterns/Entity Extraction.md - kb/concepts/patterns/Filter on Ingest.md - kb/concepts/patterns/Forgetting.md - kb/concepts/patterns/Graph Traversal.md - kb/concepts/patterns/Mesh Sync.md - kb/concepts/patterns/Quality Scoring.md - kb/concepts/patterns/Reciprocal Rank Fusion.md - kb/concepts/patterns/Self-Healing.md - kb/concepts/patterns/Shared vs Private.md - kb/concepts/patterns/Typed Relationships.md - kb/concepts/patterns/Vector Search.md - kb/concepts/patterns/Work Coordination.md - kb/concepts/problems/Ambient Environment Dependency.md - kb/concepts/problems/Detect-Repair Asymmetry.md - kb/concepts/problems/Green Suite Blind Spot.md - kb/concepts/problems/Naming Convention Conflict.md - kb/concepts/problems/Write-Once Frontmatter Fields.md - kb/concepts/protocols/CPPC.md - kb/concepts/protocols/Modbus.md - kb/concepts/protocols/SSD TRIM.md - kb/concepts/workflows/Anti-Cramming Heuristic.md - kb/concepts/workflows/Bulk Operations.md - kb/concepts/workflows/CI Integration.md - kb/concepts/workflows/Checkpoint Audit.md - kb/concepts/workflows/Claude Code Auto Mode.md - kb/concepts/workflows/Content Quality Control.md - kb/concepts/workflows/Crystallization.md - kb/concepts/workflows/Event-Driven Automation.md - kb/concepts/workflows/Hooks.md - kb/concepts/workflows/Index Scaling.md - kb/concepts/workflows/Iteration and Cost Limits.md - kb/concepts/workflows/KB Migration.md - kb/concepts/workflows/Knowledge Compounding.md - kb/concepts/workflows/Lint Workflow.md - kb/concepts/workflows/Mass-Update Gate.md - kb/concepts/workflows/Multi-Agent Collaboration.md - kb/concepts/workflows/Privacy and Governance.md - kb/concepts/workflows/Publish-Remote Gate.md - kb/concepts/workflows/Quality and Self-Correction.md - kb/concepts/workflows/Semantic Lint Automation.md - kb/concepts/workflows/Session Orientation.md - kb/concepts/workflows/Split Merge Reclassify.md - kb/concepts/workflows/Split Threshold.md - kb/concepts/workflows/Stub Threshold.md - kb/concepts/workflows/Supersession.md - kb/concepts/workflows/User Management.md - kb/concepts/workflows/Workflow Extraction.md - kb/concepts/workflows/Workflow Orchestration.md - kb/entities/people/Andrej Karpathy.md - kb/entities/people/E3DC GmbH.md - kb/entities/people/Rohit Gupta.md - kb/entities/people/Vannevar Bush.md - kb/entities/projects/BCDModule.md - kb/entities/projects/Chemenu.md - kb/entities/projects/andybalholm-edl.md - kb/entities/projects/goresponsiveness.md - kb/entities/projects/ha-core.md - kb/entities/projects/hacs-e3dc.md - kb/entities/projects/hacs-integration-blueprint.md - kb/entities/projects/llm-wiki-skills.md - kb/entities/projects/plugnburn-edl.md - kb/entities/projects/wiki-skills-vanillaflava.md - kb/entities/projects/wiki-skills.md - kb/entities/systems/AGENTS.md.md - kb/entities/systems/CLAUDE.md.md - kb/entities/systems/E3DC.md - kb/entities/systems/ENVIRONMENT.md.md - kb/entities/systems/Memex.md - kb/entities/systems/Tolkien Gateway.md - kb/entities/technologies/Arch Linux.md - kb/entities/technologies/Disk Encryption.md - kb/entities/technologies/Docker.md - kb/entities/technologies/GRUB.md - kb/entities/technologies/Gitea Actions.md - kb/entities/technologies/Gitea.md - kb/entities/technologies/Go.md - kb/entities/technologies/Home Assistant.md - kb/entities/technologies/Kernel PM Governors.md - kb/entities/technologies/LVM.md - kb/entities/technologies/Linux Kernel.md - kb/entities/technologies/MQTT.md - kb/entities/technologies/OPC UA.md - kb/entities/technologies/Python.md - kb/entities/technologies/Rust.md - kb/entities/technologies/Wine GE.md - kb/entities/technologies/Wine-Staging.md - kb/entities/technologies/acpi-cpufreq.md - kb/entities/technologies/amd-pstate.md - kb/entities/technologies/iii Engine.md - kb/entities/tools/AUR.md - kb/entities/tools/Act Runner.md - kb/entities/tools/Agent Memory.md - kb/entities/tools/Aura.md - kb/entities/tools/Bottles.md - kb/entities/tools/ChatGPT.md - kb/entities/tools/Claude Code.md - kb/entities/tools/Codex CLI.md - kb/entities/tools/Dataview.md - kb/entities/tools/GPG.md - kb/entities/tools/GitHub Copilot.md - kb/entities/tools/Gitea MCP Server.md - kb/entities/tools/Lutris.md - kb/entities/tools/Marp.md - kb/entities/tools/Mistral Vibe.md - kb/entities/tools/NotebookLM.md - kb/entities/tools/Obsidian Web Clipper.md - kb/entities/tools/Obsidian.md - kb/entities/tools/OpenAI Codex.md - kb/entities/tools/OpenCode.md - kb/entities/tools/Pi.md - kb/entities/tools/Proton.md - kb/entities/tools/Steam.md - kb/entities/tools/Wine.md - kb/entities/tools/awesome-llm-wiki.md - kb/entities/tools/farzaa gist.md - kb/entities/tools/gdeploy.md - kb/entities/tools/makepkg.md - kb/entities/tools/pascalandy schema.md - kb/entities/tools/qmd.md - kb/entities/tools/wikitool.md - kb/index.md - kb/log.md - raw/CONTRACT.md - tools/CONTRACT.md - tools/README.md - tools/chemenu/api.py - tools/chemenu/cli.py - tools/chemenu/commands/confidence_decay.py - tools/chemenu/commands/docs_verify.py - tools/chemenu/commands/doctor.py - tools/chemenu/commands/index_build.py - tools/chemenu/commands/new_page.py - tools/chemenu/commands/search.py - tools/chemenu/commands/touch.py - tools/chemenu/commands/version_cmd.py - tools/chemenu/conventions.py - tools/chemenu/corpus_diff.py - tools/chemenu/frontmatter_io.py - tools/chemenu/lint_core.py - tools/chemenu/mcp/server.py - tools/chemenu/page.py - tools/chemenu/search/base.py - tools/chemenu/search/filters.py - tools/chemenu/search/ripgrep.py - tools/chemenu/search/service.py - tools/chemenu/search/types.py - tools/chemenu/tests/conftest.py - tools/chemenu/tests/test_api.py - tools/chemenu/tests/test_confidence_decay.py - tools/chemenu/tests/test_corpus_diff.py - tools/chemenu/tests/test_docs_verify.py - tools/chemenu/tests/test_frontmatter_io.py - tools/chemenu/tests/test_index_build.py - tools/chemenu/tests/test_kb_scan.py - tools/chemenu/tests/test_lint.py - tools/chemenu/tests/test_mcp_server.py - tools/chemenu/tests/test_new_page.py - tools/chemenu/tests/test_page_ops.py - tools/chemenu/tests/test_provenance.py - tools/chemenu/tests/test_raw_cmd.py - tools/chemenu/tests/test_search.py - tools/chemenu/tests/test_touch.py - tools/chemenu/tests/test_type_resolver.py - tools/chemenu/tests/test_version_cmd.py - tools/chemenu/tests/test_xref.py - tools/chemenu/version.py - types/concept.md - types/concept.schema.yaml - types/entity.md - types/entity.schema.yaml - types/instruction.md - types/type-spec.md
101 lines
4.5 KiB
Markdown
101 lines
4.5 KiB
Markdown
---
|
|
type: types/entity.md
|
|
entity_type: system
|
|
tags: []
|
|
created: 2026-08-31
|
|
modified: 2026-09-01
|
|
related:
|
|
- depends-on: AGENTS.md
|
|
- uses: ENVIRONMENT.md
|
|
sources: [Source - Conversation - ENVIRONMENT.md as an Optional Third Session-Level File Session 2026-08-31]
|
|
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
|
|
|
|
## 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
|
|
- [[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]]
|
|
|
|
<!-- wikitool:links -->
|
|
## Beziehungen
|
|
|
|
- **depends-on:** [[AGENTS.md]]
|
|
- **uses:** [[ENVIRONMENT.md]]
|
|
<!-- /wikitool:links -->
|