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
2.5 KiB
Markdown
64 lines
2.5 KiB
Markdown
---
|
|
type: types/concept.md
|
|
concept_type: problem
|
|
tags: [bug, drifts, kebab-case, human-readable]
|
|
created: 2026-08-03
|
|
modified: 2026-08-29
|
|
related: [AGENTS.md]
|
|
sources: [Source - LLM Improvements Codex Analysis]
|
|
confidence: 0.80
|
|
confidence_base: 0.80
|
|
provenance: sourced
|
|
summary: 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
|
|
|
|
1. **Einen Standard auswählen:** Für kebab-case oder Namen mit Leerzeichen entscheiden und alle Dokumentation aktualisieren
|
|
2. **Beide unterstützen:** Die Tooling so gestalten, dass beide Konventionen akzeptiert werden (komplex, nicht empfohlen)
|
|
3. **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)
|
|
- README.md (gibt kebab-case an)
|
|
- [[Source - LLM Improvements Codex Analysis]][^s-llm-improvements-codex-analysis]
|
|
|
|
## Beziehungen
|
|
|
|
- **beeinflusst:** [[AGENTS.md]]
|
|
|
|
## Siehe auch
|
|
|
|
- [[Source - LLM Improvements Codex Analysis]]
|
|
- [[AGENTS.md]]
|
|
|
|
## Fußnoten
|
|
|
|
[^s-llm-improvements-codex-analysis]: [[Source - LLM Improvements Codex Analysis]]
|