# Portabilitaet: UNIVERSAL
# Zuletzt validiert: 2026-01-28 (Gemini)
# Naechste Pruefung: 2027-01-28
# Quellen: [skills/_protocols/docs-analyse.md]

DOKUMENTEN-ANFORDERUNGSANALYSE (KONZEPT)
========================================

Stand: 2026-01-28

DAS PROBLEM: DOKUMENTATIONS-EROSION
-----------------------------------
In Softwareprojekten driften Anforderungen (Docs) und Realitaet (Code) oft auseinander. Dokumente werden veraltet ("Code Rot") und verlieren ihren Wert.

DIE LOESUNG: AUTOMATISCHER ABGLEICH
-----------------------------------
Die Docs Analyse ist kein manueller Review-Prozess, sondern ein **Workflow-gestuetzter Audit**. Er behandelt Dokumentation wie testbaren Code.

KERNKONZEPTE
------------

### 1. Requirements Extraction
Der Analyzer parst Markdown-Dateien in `docs/` und sucht nach:
- Checklisten (`- [ ]`)
- Tabellen mit Status-Spalten
- Schluesselwoertern (TODO, FEHLT)
- Expliziten Anforderungsbloecken

### 2. Evidence-Based Verification
Jede Anforderung muss "bewiesen" werden durch:
- **Existenz:** File-System Check (z.B. "Datei X muss existieren")
- **Code:** Grep-Suche (z.B. "Funktion Y muss implementiert sein")
- **Schema:** DB-Inspection (z.B. "Tabelle Z muss Spalte A haben")

### 3. Der Erfuellungsgrad & Archivierung
Jedes Dokument erhaelt einen Score ("Analyse-Score").
- **< 75% Erfuellt:** Das Dokument ist "lebendig" und bleibt im Arbeitsordner `docs/`. Es ist eine offene Spezifikation.
- **>= 75% Erfuellt:** Das Dokument gilt als weitgehend umgesetzt und wandert ins Archiv `docs/_archive/`. Es dient nur noch als historische Referenz.

### 4. Versionierung (conN)
Analysen sind Momentaufnahmen. Wir verwenden ein `conN_` Praefix (Consensus Version):
- `con1_...`: Erste Analyse
- `con2_...`: Zweite Analyse (Delta zur ersten)
Dies erlaubt es, den Fortschritt ueber die Zeit zu tracken ("Trendlinie").

OUTPUT ARTIFACTS
----------------
- **ANFORDERUNGSANALYSE.md:** Das "Big Picture". Welche Dokumente sind wie weit?
- **consense_diff.md:** Das "Action Item List". Nur die Dinge, die noch FEHLEN, aggregiert aus allen Dokumenten. Ideal fuer Sprint-Planning.

SIEHE AUCH
----------
skills/_protocols/docs-analyse.md    Der technische Workflow
docs/help/practices.txt                   Best Practices (#7 Doku-Wahrheit)
