From eae910a69f1646f9f87597f8484a14007f60197c Mon Sep 17 00:00:00 2001 From: Hector the Butler Date: Fri, 5 Jun 2026 13:08:01 +0200 Subject: [PATCH] =?UTF-8?q?fix:=20separate=20Karpathy's=20coding=20rules?= =?UTF-8?q?=20from=20KB=20concept=20=E2=80=94=20disclaimer=20added?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 23 ++++++++++++++++------- 1 file changed, 16 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index ed02b71..20cb8d0 100644 --- a/README.md +++ b/README.md @@ -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 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) 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. | -| **Simplicity First** | Keine overengineerten Memory-Backends. Flache Markdown-Dateien. Kein Schema, das keiner braucht. | -| **Surgical Changes** | Nur das einpflegen, was wirklich relevant ist. Nicht jeden Link, nur entscheidungsrelevante. | -| **Goal-Driven Execution** | Definieren, was "Wissen ist verarbeitet" bedeutet. Nicht: "alle Links scrapen", sondern: "Jede Entscheidung ist referenzierbar und von Agents lesbar." | +| **Persistente Dateien** | Agents lesen beim Start `CLAUDE.md` / `AGENTS.md` → Wissen geht nicht verloren | +| **Lesbares Format** | Reines Markdown, kein binäres Backend. Jeder Agent kann es lesen. | +| **Git-versioniert** | Änderungen nachvollziehbar, kollaborativ bearbeitbar | +| **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 @@ -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 +> **⚠️ 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 | Repo | Autor | Stars | Beschreibung | Stand |