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