---
type: types/concept.md
concept_type: problem
tags: [bug, drifts, kebab-case, human-readable]
created: 2026-08-03
modified: 2026-08-29
related:
  - operates-on: 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

- README.md (gibt kebab-case an)
- [[Source - LLM Improvements Codex Analysis]][^s-llm-improvements-codex-analysis]

## Beziehungen

## Siehe auch

- [[Source - LLM Improvements Codex Analysis]]

## Fußnoten

[^s-llm-improvements-codex-analysis]: [[Source - LLM Improvements Codex Analysis]]

<!-- wikitool:links -->
## Beziehungen

- **operates-on:** [[AGENTS.md]]
<!-- /wikitool:links -->