torben
18ae28f918
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.
64 lines
4.1 KiB
Markdown
64 lines
4.1 KiB
Markdown
---
|
|
type: types/source.md
|
|
source_type: notes
|
|
author: Codex LLM
|
|
raw_files: [raw/notes/llm-improvements-codex.md]
|
|
source_language: en
|
|
date: 2026-08-03
|
|
tags: [analysis, improvement, wikitool, codex, sonnet-comparison-planned]
|
|
entities: [wikitool, AGENTS.md]
|
|
concepts: [Workflow Orchestration, Session Orientation, Semantic Lint Automation, Split Merge Reclassify, CI Integration, OKF Compatibility, Naming Convention Conflict]
|
|
summary: 'Codex-Analyse, die AGENTS.md und wikitool mit awesome-llm-wiki und Farzas Gist vergleicht und 7 aussichtsreiche Verbesserungen sowie zu vermeidende Anti-Muster benennt. Hinweis: eine Sonnet-Analyse zum Vergleich ist vorgesehen.'
|
|
---
|
|
# Source: LLM Improvements Codex Analysis
|
|
|
|
**Autor:** Codex LLM
|
|
**Datum:** 2026-08-03
|
|
**Quelle:** raw/notes/llm-improvements-codex.md
|
|
**Typ:** Notizen
|
|
|
|
**Hinweis:** Dies ist eine Codex-LLM-Analyse. Eine Sonnet-LLM-Analyse ist für späteren Vergleich geplant.
|
|
|
|
## Zusammenfassung
|
|
|
|
Diese Quelle dokumentiert die Analyse eines Codex-LLM des aktuellen LLM-Wiki-Repository, vergleicht das interne AGENTS.md-Schema und die wiki_tools-CLI mit externen Referenzen aus dem awesome-llm-wiki-Repository und einem farzaa-Gist. Die Analyse zeigt, dass dieses Repository bereits konzeptionell vielen öffentlichen LLM-Wiki-Implementierungen voraus ist, aufgrund seiner Verpflichtung zum Determinismus durch die wikitool-CLI.
|
|
|
|
Die Analyse identifizierte sieben Verbesserungsbereiche mit höchstem Potenzial: Workflow-Orchestrierung als einzelne Befehle pro Operation, harte Sicherheits-Gates vor Massenänderungen, Session-Orientierung als obligatorischer Preflight, semi-automatisierte semantische Lint-Heuristiken, dedizierte Split-/Merge-/Reklassifizierungs-Befehle, CI-Integration-Hooks und optionale OKF-Kompatibilität als Export-/Validierungs-Profil. Es flaggte auch konkreten Drift zur Behebung, insbesondere den Benennungskonventions-Konflikt zwischen README.md (kebab-case) und AGENTS.md (Human-Readable mit Leerzeichen).
|
|
|
|
Zu vermeidende Anti-Patterns wurden identifiziert: Person-zentrische Taxonomien, aggressive „Always-Rewrite"-Schleifen und vorzeitige Multi-Agent-Orchestrierung, bevor lokale Qualitäts-Metriken stabil sind.
|
|
|
|
## Kernaussagen
|
|
|
|
- **Aktuelle Stärken:** Der deterministische Ansatz des Repository (AGENTS.md + wikitool) ist bereits stärker als die meisten öffentlichen LLM-Wiki-Skills, denen mechanische Durchsetzung fehlt
|
|
- **Provenance-Reife:** Coverage-/Trace-/Reverse-Index-Infrastruktur via provenance_cmd.py ist ungewöhnlich reif für ein Test-Repository
|
|
- **Lint-Abdeckung:** Erfasst bereits harte Fehler einschließlich Citation-/Frontmatter-Drift, unabgedeckte Raw-Dateien und Provenance-Marker
|
|
- **7 Verbesserungsbereiche mit höchstem Potenzial:** Workflow-Orchestrierung, Sicherheits-Gates, Session-Orientierung, semantische Lint-Automatisierung, Split-/Merge-/Reklassifizierungs-Befehle, CI-Integration, OKF-Kompatibilität
|
|
- **Zu vermeidende Anti-Patterns:** Person-zentrische Taxonomien, Always-Rewrite-Schleifen, vorzeitige Multi-Agent-Orchestrierung
|
|
- **Konkreter Bug:** Benennungskonventions-Drift zwischen README.md (kebab-case) und AGENTS.md (Human-Readable mit Leerzeichen)
|
|
|
|
## Aufgaben
|
|
|
|
- [ ] Workflow-Orchestrierungs-Befehle implementieren erwägen (`ingest run`, `lint run`, `update run`)
|
|
- [ ] Harte Sicherheits-Gates für Massenänderungen (≥ N Dateien) vor Veröffentlichung hinzufügen
|
|
- [ ] Session-Orientierung als obligatorischer Preflight vor Query/Update implementieren
|
|
- [ ] Maschinen-Heuristiken für semantisches Lint hinzufügen (veraltete Aussagen, Änderungsdichte, schwache Verknüpfung)
|
|
- [ ] Dedizierte Split-/Merge-/Reklassifizierungs-Befehle mit automatischer Link-/Frontmatter-Korrektur erstellen
|
|
- [ ] CI-Hooks vor Veröffentlichung einrichten (Pre-Commit/CI-Integration)
|
|
- [ ] Optionale OKF-Kompatibilität als Export-/Validierungs-Modus erwägen
|
|
- [x] Benennungskonventions-Konflikt zwischen README.md und AGENTS.md beheben
|
|
|
|
## Verwandte Entities
|
|
|
|
- [[wikitool]]
|
|
- [[AGENTS.md]]
|
|
|
|
## Verwandte Concepts
|
|
|
|
- [[Workflow Orchestration]]
|
|
- [[Session Orientation]]
|
|
- [[Semantic Lint Automation]]
|
|
- [[Split Merge Reclassify]]
|
|
- [[CI Integration]]
|
|
- [[OKF Compatibility]]
|
|
- [[Naming Convention Conflict]]
|