fix: separate Karpathy's coding rules from KB concept — disclaimer added

This commit is contained in:
Hector the Butler 2026-06-05 13:08:01 +02:00
parent ab5310164a
commit eae910a69f

View file

@ -16,20 +16,24 @@ Der RamaDama-Topic ist voll mit guten Links, Architekturüberlegungen und Tool-E
- **Nicht referenzierbar** — kein Agent (ich nicht, kein anderer) kann das Wissen beim nächsten Start wiederfinden - **Nicht referenzierbar** — kein Agent (ich nicht, kein anderer) kann das Wissen beim nächsten Start wiederfinden
- **Nicht teilbar** — was Pit, k9ert, Nazim, Rüdiger oder René reinwerfen, ist weg sobald der Chat weiterläuft - **Nicht teilbar** — was Pit, k9ert, Nazim, Rüdiger oder René reinwerfen, ist weg sobald der Chat weiterläuft
### 2. Karpathys Ansatz ### 2. Karpathys Ansatz — das Konzept (nicht die Coding-Regeln!)
> Quelle: https://x.com/karpathy/status/2015883857489522876 (Jan 2026, 40K+ Likes) > Quelle: https://x.com/karpathy/status/2015883857489522876 (Jan 2026, 40K+ Likes)
Karpathys Kernidee: **`CLAUDE.md`** — eine lesbare Markdown-Datei im Projekt-Stamm, die Agents beim Start lesen und ihr Verhalten danach ausrichten. Karpathys Kernidee: **`CLAUDE.md`** — eine lesbare Markdown-Datei im Projekt-Stamm, die Agents beim Start lesen und ihr Verhalten danach ausrichten.
Die vier Prinzipien aus Karpathys Post, die direkt auf Knowledge-Base-Arbeit übertragbar sind: **Wichtig:** Der Post handelt von vier Coding-Verhaltensprinzipien (Think Before Coding, Simplicity First, etc.). Das Konzept dahinter — **persistente, agents-lesbare Instruction Files** — ist die eigentliche konzeptionelle Grundlage für unsere Knowledge Base. Nicht die Coding-Regeln selbst.
| Prinzip | Bedeutung für die KB | Aus Karpathys Post für die KB relevant:
| Konzept | Bedeutung für die KB |
|---------|---------------------| |---------|---------------------|
| **Think Before Coding** | Nicht einfach losrennen. Erst analysieren, was existiert, was das Ökosystem macht, wo die Standards sind. | | **Persistente Dateien** | Agents lesen beim Start `CLAUDE.md` / `AGENTS.md` → Wissen geht nicht verloren |
| **Simplicity First** | Keine overengineerten Memory-Backends. Flache Markdown-Dateien. Kein Schema, das keiner braucht. | | **Lesbares Format** | Reines Markdown, kein binäres Backend. Jeder Agent kann es lesen. |
| **Surgical Changes** | Nur das einpflegen, was wirklich relevant ist. Nicht jeden Link, nur entscheidungsrelevante. | | **Git-versioniert** | Änderungen nachvollziehbar, kollaborativ bearbeitbar |
| **Goal-Driven Execution** | Definieren, was "Wissen ist verarbeitet" bedeutet. Nicht: "alle Links scrapen", sondern: "Jede Entscheidung ist referenzierbar und von Agents lesbar." | | **Projektverzeichnis** | Wissen liegt da, wo die Arbeit passiert — nicht in einem externen System |
**Was ich falsch gemacht hab:** Die vier Coding-Prinzipien 1:1 auf die KB-Struktur übertragen. Die sind für Coding-Verhalten, nicht für Wissensorganisation. Karpathy hat später mit `autoresearch` (`program.md`) gezeigt, dass das Instruction-File-Konzept auch für Nicht-Coding-Agenten funktioniert.
### 3. Was multica-ai besser macht ### 3. Was multica-ai besser macht
@ -129,6 +133,11 @@ Alle Repos und Tools, die direkt oder indirekt auf Karpathys Post vom 26. Jan 20
> Quelle: https://x.com/karpathy/status/2015883857489522876 > Quelle: https://x.com/karpathy/status/2015883857489522876
> **⚠️ Wichtige Klarstellung:** Die folgenden Repos sind fast alle **Coding-Verhaltensregeln** (Claude Code Skills, AGENTS.md). Sie implementieren die *vier Prinzipien* aus Karpathys Post, nicht das *Knowledge-Base-Konzept*. Sie sind hier trotzdem dokumentiert, weil sie zeigen:
> 1. Wie sich der Instruction-File-Standard entwickelt hat (`CLAUDE.md``AGENTS.md` → offener Standard)
> 2. Welche Plattformen das Format unterstützen (Claude Code, Codex, Cursor, Gemini CLI, **OpenClaw**)
> 3. Dass swarmclawai bereits einen OpenClaw-Adapter gebaut hat
### Direkte Implementierungen ### Direkte Implementierungen
| Repo | Autor | Stars | Beschreibung | Stand | | Repo | Autor | Stars | Beschreibung | Stand |