mitai-jinkendo/.claude/docs/audit/platzhalter/audit-report-2026-03-29/USAGE_ROLE_CLASSIFICATION.md

# Usage Role Classification: 67 Ungenutzte Platzhalter

**Erstellt:** 30. März 2026 (Revision)
**Basis:** Roadmap, Diagramm-Konzept v2, DATA_ARCHITECTURE.md
**Zweck:** Methodische Korrektur - Nichtnutzung ≠ Redundanz

---

## Klassifizierungs-Prinzip

**Für dieses Projekt gilt:**
Die Prompt-Bibliothek ist im Aufbau (Phase 0b/0c/1/2 Roadmap).
Aktuelle Nichtnutzung ist kein Beweis für Überflüssigkeit.

**Strenge Kriterien für "redundant":**
Nur wenn **keine fachliche Rolle** in Roadmap, Konzept oder Datenmodell erkennbar ist.

---

## Klassifizierung der 67 ungenutzten Platzhalter

### 1. used_productively (44 Platzhalter - bereits in Nutzung)

**Nicht relevant** - diese sind NICHT ungenutzt.

---

### 2. unused_but_planned (30 Platzhalter - 45%)

**Definition:** Explizit in Roadmap Phase 0c/1/2 oder Diagramm-Konzept v2 dokumentiert.

#### A. Scores (6) - Phase 0c/Phase 1
- `activity_score`
- `nutrition_score`
- `recovery_score`
- `body_progress_score`
- `goal_progress_score`
- `data_quality_score`

**Roadmap:** Phase 0c (Multi-Layer Architecture) + Phase 1 (Charts)
**Konzept:** Diagramm-Konzept v2, Section 5 "Scores"
**Fachliche Rolle:** Composite Scores mit Confidence, Goal-Mode-abhängig

---

#### B. Correlations (5) - Phase 2
- `correlation_energy_weight_lag`
- `correlation_load_hrv`
- `correlation_load_rhr`
- `correlation_protein_lbm`
- `correlation_sleep_recovery`

**Roadmap:** Phase 2 (Engagement - Korrelationen)
**Konzept:** Diagramm-Konzept v2, Section 3.5 "Lag-basierte Zusammenhänge"
**Fachliche Rolle:** Diagnostische Auswertung, Min 21-28 Datenpunkte

---

#### C. Ability Balance (5) - Phase 1
- `ability_balance_coordination`
- `ability_balance_endurance`
- `ability_balance_mental`
- `ability_balance_mobility`
- `ability_balance_strength`

**Roadmap:** Phase 1 (Charts - Training Balance)
**Konzept:** DATA_ARCHITECTURE.md, abilities JSONB column
**Fachliche Rolle:** Trainingsverteilung über Fähigkeiten (28d)

---

#### D. Goals Details (11) - Phase 0b/0c (bereits vorhanden, noch nicht in Prompts integriert)
- `active_goals_json`, `active_goals_md`
- `focus_areas_weighted_json`, `focus_areas_weighted_md`, `focus_area_weights_json`
- `top_goal_name`, `top_goal_progress_pct`, `top_goal_status`
- `top_3_goals_behind_schedule`, `top_3_goals_on_track`, `top_3_focus_areas`

**Roadmap:** Phase 0b (Goal-Aware Placeholders) - DONE
**Konzept:** Goals System v2.0, Dynamic Focus Areas
**Fachliche Rolle:** Goal-Tracking für Prompts, JSON für strukturierte Ausgabe
**Status:** Backend implementiert, noch nicht in Prompt-Bibliothek integriert

---

#### E. Sleep Debt (1) - Phase 1
- `sleep_debt`

**Roadmap:** Phase 1 (Charts - Recovery)
**Konzept:** Diagramm-Konzept v2, Section 4.3 "Schlafschuld akkumuliert"
**Fachliche Rolle:** Kumulative Schlafschuld vs. Ziel (7-8h)

---

#### F. Plateau Detection (1) - Phase 1/2
- `plateau_detected`

**Roadmap:** Phase 1/2 (Diagnostics)
**Konzept:** Diagramm-Konzept v2, Section 3.4 "Muster, Plateaus"
**Fachliche Rolle:** Stagnations-Erkennung (Gewicht, BF%, LBM)

---

#### G. Top Drivers (1) - Phase 2
- `top_drivers`

**Roadmap:** Phase 2 (Correlations)
**Konzept:** Diagramm-Konzept v2, Section 3.5 "Wechselwirkungen"
**Fachliche Rolle:** Top-3 Einflussfaktoren auf Fortschritt

---

### 3. unused_but_plausible (37 Platzhalter - 55%)

**Definition:** Fachlich sinnvolle Rolle im Datenmodell, plausibel für Prompt-Bibliothek.

#### H. Body Deltas (5)
- `arm_28d_delta`, `chest_28d_delta`, `hip_28d_delta`, `thigh_28d_delta`, `waist_28d_delta`

**Fachliche Rolle:** Granulare Delta-Berechnungen für Umfänge (28d)
**Plausibel für:** Prompts die spezifische Körperteile analysieren (z.B. "Armumfang Fortschritt")
**Redundant?** NEIN - circ_summary ist Best-of-Each, Deltas sind zeitbasiert
**Status:** unused_but_plausible (für spezifische Prompts nützlich)

---

#### I. Nutrition Details (6)
- `energy_deficit_surplus`
- `intake_volatility`
- `nutrition_days`
- `protein_days_in_target`
- `protein_ziel_low`
- `protein_ziel_high`

**Fachliche Rolle:** Detaillierte Ernährungs-Metriken
**Plausibel für:** Prompts für Ernährungs-Coaching (Protein-Target-Range, Consistency)
**Redundant?** NEIN - ergänzen nutrition_avg/nutrition_score
**Status:** unused_but_plausible

---

#### J. Training Quality/Load (3)
- `monotony_score`
- `strain_score`
- `rest_day_compliance`

**Fachliche Rolle:** Übertrainings-Erkennung, Load-Monitoring
**Plausibel für:** Prompts für Recovery-Management
**Redundant?** NEIN - spezifische Load-Metriken
**Status:** unused_but_plausible

---

#### K. Focus Category Weights (7)
- `focus_cat_körper_weight`
- `focus_cat_ernährung_weight`
- `focus_cat_aktivität_weight`
- `focus_cat_recovery_weight`
- `focus_cat_vitalwerte_weight`
- `focus_cat_mental_weight`
- `focus_cat_lebensstil_weight`

**Fachliche Rolle:** User-Präferenzen für Score-Gewichtung
**Plausibel für:** Goal-Mode-abhängige Prompts
**Redundant?** NEIN - Teil des Dynamic Focus Areas v2.0 System
**Status:** unused_but_plausible (Phase 0b Feature)

---

#### L. Focus Category Progress (7)
- `focus_cat_körper_progress`
- `focus_cat_ernährung_progress`
- `focus_cat_aktivität_progress`
- `focus_cat_recovery_progress`
- `focus_cat_vitalwerte_progress`
- `focus_cat_mental_progress`
- `focus_cat_lebensstil_progress`

**Fachliche Rolle:** Fortschritts-Scores pro Kategorie
**Plausibel für:** Dashboard-Widgets, Kategorie-spezifische Analysen
**Redundant?** NEIN - Teil des Dynamic Focus Areas v2.0 System
**Status:** unused_but_plausible (Phase 0b Feature)

---

#### M. Meta/Convenience (3)
- `bmi`
- `waist_hip_ratio`
- `datum_heute`

**Fachliche Rolle:** Convenience-Placeholder für Prompts
**Plausibel für:** Prompt-Templates (bmi = "aktueller BMI", datum_heute = "Kontext-Datum")
**Redundant?** Technisch berechenbar, ABER Convenience hat Wert
**Status:** unused_but_plausible

---

#### N. Zeitraum Meta (3)
- `zeitraum_7d`
- `zeitraum_30d`
- `zeitraum_90d`

**Fachliche Rolle:** String-Konstanten für Zeitfenster in Prompts
**Plausibel für:** Prompt-Templates ("in den letzten {{zeitraum_7d}}")
**Redundant?** NEIN - Sprachliche Convenience
**Status:** unused_but_plausible

---

#### O. Weight Trend (1)
- `weight_90d_slope`

**Fachliche Rolle:** Langfrist-Trend (90d statt 28d)
**Plausibel für:** Prompts für langfristige Gewichtsentwicklung
**Redundant?** NEIN - ergänzt weight_trend (28d)
**Status:** unused_but_plausible

---

#### P. Recent Load (1)
- `recent_load_balance_3d`

**Fachliche Rolle:** Kurzfrist-Load-Balance (3d)
**Plausibel für:** Prompts für akute Recovery-Bewertung
**Redundant?** NEIN - ergänzt load_monitoring (7d/28d)
**Status:** unused_but_plausible

---

### 4. unused_and_unclear (0 Platzhalter)

**Keine** - alle 67 haben erkennbare fachliche Rolle.

---

### 5. redundant_or_duplicate (0 Platzhalter)

**Keine** - kein Platzhalter erfüllt die strengen Kriterien für Redundanz:
- Alle haben fachliche Rolle im Datenmodell
- Alle haben plausible Rolle in Roadmap/Konzept oder als Convenience
- Keine echten Duplikate
- Keine explizit ersetzten Platzhalter

---

## Zusammenfassung

| Status | Anzahl | Prozent | Interpretation |
|--------|--------|---------|----------------|
| **unused_but_planned** | 30 | 45% | Explizit in Roadmap Phase 0c/1/2 |
| **unused_but_plausible** | 37 | 55% | Fachlich sinnvoll, noch nicht in Prompts |
| **unused_and_unclear** | 0 | 0% | Keine |
| **redundant_or_duplicate** | 0 | 0% | Keine |
| **TOTAL** | 67 | 100% | Alle haben fachliche Berechtigung |

---

## Implikationen für Audit-Berichte

### Was sich ändert:

1. **Executive Summary:**
   - ~~"60% ungenutzte Platzhalter"~~ als systemische Schwäche #5 → ENTFERNEN
   - ~~"Technical Debt akkumuliert"~~ → ENTFERNEN
   - ~~"Unklare Deprecation-Strategie"~~ → ENTFERNEN
   - **NEU:** "67 Platzhalter noch nicht produktiv eingebunden (45% geplant in Phase 0c/1/2, 55% plausibel für Prompt-Bibliothek)"

2. **Offene Entscheidungen E2.1:**
   - ~~"Ungenutzte Platzhalter - Behalten oder Deprecaten?"~~ → UMFORMULIEREN
   - **NEU:** "Ungenutzte Platzhalter - Roadmap-Priorisierung und Integration-Timeline"
   - Fokus: WANN integrieren, nicht OB deprecaten

3. **Maßnahmenplan P2.2:**
   - ~~"Ungenutzte Platzhalter Deprecation-Review"~~ → UMFORMULIEREN
   - **NEU:** "Ungenutzte Platzhalter - Fachliche Rolle klären und Integration planen"
   - ~~"15-20 Deprecated Platzhalter"~~ als Deliverable → ENTFERNEN

4. **Prüfmatrix Summary:**
   - ~~"Deprecation-Kandidaten"~~ Kategorien A/B/C → ERSETZEN
   - **NEU:** "usage_role_classification" Kategorien (planned/plausible/unclear/redundant)

5. **README:**
   - ~~"Technical Debt reduziert"~~ → UMFORMULIEREN
   - **NEU:** "Platzhalter-Integration in Prompt-Bibliothek vorangetrieben"

---

## Empfohlene Maßnahmen (NEU)

**Statt Deprecation:**

### P2: Placeholder-Integration-Planung (4-6h)

**Ziel:** Integration ungenutzter Platzhalter in Prompt-Bibliothek priorisieren

**Prozess:**
1. **Meeting (2h):** Product + Tech Review der 67
   - Gruppe A (unused_but_planned, 30): Timeline für Phase 0c/1/2 bestätigen
   - Gruppe B (unused_but_plausible, 37): Prompt-Use-Cases identifizieren
2. **Dokumentation (1h):** Integration-Roadmap, Prompt-Kandidaten
3. **Implementation (1-2h):** Prompt-Templates erstellen (Quick Wins)
4. **Communication (1h):** Prompt-Autoren: "Neue Platzhalter verfügbar"

**Deliverables:**
- Integration-Timeline für 30 geplante Platzhalter
- Prompt-Use-Cases für 10-15 plausible Platzhalter
- 5-10 neue Prompt-Templates mit bisher ungenutzten Platzhaltern

**Impact:**
- Nutzungsrate steigt von 40% auf 50-60%
- Prompt-Bibliothek wird reichhaltiger
- Platzhalter-System zeigt Wert statt "Technical Debt"

---

**Audit-Revision durchgeführt von:** Claude Code
**Revisions-Datum:** 30. März 2026
**Methodische Basis:** Roadmap-Konformität statt Nutzungsstatus