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.
Widerspruch zwischen README.md (kebab-case) und AGENTS.md (lesbar mit Leerzeichen), der zu Drift bei der Validierung führt
Naming Convention Conflict
Typ: problem
Definition
Naming Convention Conflict ist ein spezifischer Drift/Bug, bei dem README.md und AGENTS.md unterschiedliche Benennungskonventionen für Wiki-Dateien angeben. README.md erfordert kebab-case (z. B. hybrid-search.md), während AGENTS.md benutzerfreundliche Titel mit Leerzeichen erfordert (z. B. Hybrid Search.md). Diese Inkonsistenz verursacht Validierungsdrift und macht es unmöglich, beide Anforderungen gleichzeitig zu erfüllen.
Kernpunkte
README.md-Anforderung: kebab-case-Dateinamen (z. B. my-page.md)
AGENTS.md-Anforderung: Benutzerfreundliche Titel mit Leerzeichen (z. B. My Page.md)
Auswirkung: Verursacht Validierungsinkonsistenzen und verwirrt sowohl Menschen als auch automatisierte Tools
Entdeckung: Während der Codex-Analyse von Repo-Drift identifiziert
Beispiele
Konflikt: Sollte CI/CD Architecture.md sein wie CI/CD Architecture.md (AGENTS.md) oder ci-cd-architecture.md (README.md)?
Ergebnis: Einige Seiten folgen einer Konvention, andere folgen der anderen und erzeugen Inkonsistenz
Lösungsoptionen
Einen Standard auswählen: Für kebab-case oder Namen mit Leerzeichen entscheiden und alle Dokumentation aktualisieren
Beide unterstützen: Die Tooling so gestalten, dass beide Konventionen akzeptiert werden (komplex, nicht empfohlen)
Migrationspfad: Eine Zielkonvention wählen und alle vorhandenen Seiten migrieren
Status
Identifiziert: 2026-08-03 (Codex-Analyse)
Schweregrad: Mittel - verursacht Drift, aber Wiki funktioniert immer noch
Geplant: Sollte vor dem Sonnet-Analyse-Vergleich gelöst werden
Verwandte Concepts
AGENTS.md (gibt benutzerfreundliche Titel mit Leerzeichen an)
torben
18ae28f918