docs: Struktur .claude/docs versionieren, working/, Gitea-Index, Regeln
- .gitignore: .claude/docs, rules, commands tracken; settings.local weiter ignorieren - DOCUMENTATION.md: verbindliche Ablage functional/technical/working/issues - .claude/README.md: Agent-Einstieg; GITEA_ISSUES_INDEX aus MCP (Stand 2026-04-08) - Arbeitspapiere von docs/ nach .claude/docs/working/ verschoben - docs/MEMBERSHIP_SYSTEM.md als Stub; kanonisch technical/MEMBERSHIP_SYSTEM.md - CLAUDE.md Pflichtlektüre und Links angepasst; docs/README.md vereinfacht Made-with: Cursor
This commit is contained in:
1 parent
24daeeb83c
commit
7940dc7560
115 files changed
+45622
-1063
No files matched your search
@@ -0,0 +1,280 @@
|
||||
---
|
||||
description: Strukturierter Workflow für konzept-basierte Feature-Implementierung mit Requirement Analysis + User Approval
|
||||
args: <feature-name> <konzept-file>
|
||||
model: sonnet
|
||||
---
|
||||
|
||||
# Feature-Implementierung Workflow
|
||||
|
||||
Du wurdest aufgerufen mit:
|
||||
- **Feature:** {{feature-name}}
|
||||
- **Konzept:** {{konzept-file}}
|
||||
|
||||
Dieser Skill führt den strukturierten 5-Stufen-Prozess aus `.claude/rules/IMPLEMENTATION_RULES.md` aus.
|
||||
|
||||
---
|
||||
|
||||
## STUFE 1: Anforderungsanalyse
|
||||
|
||||
**Aufgabe:**
|
||||
1. Lies das Konzept-Dokument `{{konzept-file}}` VOLLSTÄNDIG
|
||||
2. Finde alle Anforderungen für `{{feature-name}}`
|
||||
3. Erstelle eine detaillierte Checkliste
|
||||
|
||||
**Gehe dabei wie folgt vor:**
|
||||
|
||||
### 1.1 Konzept lesen
|
||||
- Öffne `{{konzept-file}}` mit dem Read tool
|
||||
- Suche nach Abschnitten die `{{feature-name}}` betreffen
|
||||
- Lies ALLE relevanten Abschnitte vollständig (nicht nur überfliegen)
|
||||
|
||||
### 1.2 Anforderungs-Matrix erstellen
|
||||
|
||||
Erstelle eine Tabelle mit folgenden Spalten:
|
||||
|
||||
| Anforderung | Datenquelle | Status | Notizen |
|
||||
|-------------|-------------|--------|---------|
|
||||
| Kalorienaufnahme täglich | nutrition_log.kcal | ✓ Vorhanden | - |
|
||||
| Trainingskalorien | activity_log.kcal | ✗ Fehlt | Muss aggregiert werden |
|
||||
| ... | ... | ... | ... |
|
||||
|
||||
**Status-Codes:**
|
||||
- ✓ Vorhanden: Bereits implementiert (data_layer Funktion existiert)
|
||||
- ⚠ Partial: Teilweise vorhanden, muss erweitert werden
|
||||
- ✗ Fehlt: Muss neu gebaut werden
|
||||
|
||||
### 1.3 Gap-Analyse
|
||||
|
||||
Listen auf:
|
||||
- Welche data_layer Funktionen existieren bereits?
|
||||
- Welche data_layer Funktionen müssen neu geschrieben werden?
|
||||
- Welche Tabellen werden benötigt?
|
||||
- Welche Berechnungen sind nötig? (Formeln dokumentieren)
|
||||
|
||||
### 1.4 Offene Fragen
|
||||
|
||||
Dokumentiere alle Unklarheiten:
|
||||
- Interpretation unklar?
|
||||
- Mehrere Umsetzungsmöglichkeiten?
|
||||
- Fehlende Informationen im Konzept?
|
||||
|
||||
**OUTPUT:** Zeige dem User die Anforderungs-Matrix und Gap-Analyse.
|
||||
|
||||
---
|
||||
|
||||
## STUFE 2: Umsetzungskonzept erstellen
|
||||
|
||||
**Aufgabe:**
|
||||
Erstelle ein detailliertes technisches Umsetzungskonzept mit:
|
||||
|
||||
### 2.1 Backend-Design
|
||||
|
||||
**Neue Endpoints:**
|
||||
```
|
||||
GET /api/charts/{{feature-name}}?param1=value1
|
||||
|
||||
Args:
|
||||
param1: Beschreibung (default=X, range Y-Z)
|
||||
session: Auth session (injected)
|
||||
|
||||
Returns:
|
||||
Chart.js-compatible JSON (siehe unten)
|
||||
```
|
||||
|
||||
**Neue data_layer Funktionen:**
|
||||
```python
|
||||
def get_xyz_data(profile_id: str, days: int) -> Dict:
|
||||
"""
|
||||
Beschreibung was die Funktion tut.
|
||||
|
||||
Berechnung:
|
||||
1. Schritt 1 (SQL Query oder Formel)
|
||||
2. Schritt 2
|
||||
|
||||
Returns:
|
||||
{"key": value, ...}
|
||||
"""
|
||||
```
|
||||
|
||||
**Datenquellen:**
|
||||
- Welche Tabellen? (nutrition_log, activity_log, etc.)
|
||||
- Welche Spalten?
|
||||
- Welche JOINs?
|
||||
|
||||
**Berechnungen:**
|
||||
- Formeln dokumentieren (z.B. "7d avg = sum(values[-7:]) / 7")
|
||||
- Aggregationen beschreiben
|
||||
- Edge Cases behandeln (keine Daten, Division durch 0, etc.)
|
||||
|
||||
### 2.2 Response-Format
|
||||
|
||||
Zeige ein **vollständiges Beispiel** der JSON-Response:
|
||||
|
||||
```json
|
||||
{
|
||||
"chart_type": "line" | "bar" | "mixed" | "scatter",
|
||||
"data": {
|
||||
"labels": ["2026-01-01", "2026-01-02", ...],
|
||||
"datasets": [
|
||||
{
|
||||
"type": "line", // nur bei chart_type: mixed
|
||||
"label": "Label für Legende",
|
||||
"data": [100, 105, 103, ...],
|
||||
"borderColor": "#1D9E75",
|
||||
"backgroundColor": "rgba(29, 158, 117, 0.1)",
|
||||
"borderWidth": 2,
|
||||
"tension": 0.3,
|
||||
"fill": false,
|
||||
"yAxisID": "y1" // bei Dual-Axis
|
||||
}
|
||||
]
|
||||
},
|
||||
"metadata": {
|
||||
"confidence": "high" | "medium" | "low" | "insufficient",
|
||||
"data_points": 28,
|
||||
"avg_value": 123.4,
|
||||
"custom_field": "..."
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 2.3 Frontend-Design
|
||||
|
||||
**Component:**
|
||||
- Welche Datei? (z.B. `NutritionCharts.jsx`)
|
||||
- Welche Funktion? (z.B. `renderEnergyBalance()`)
|
||||
|
||||
**Chart-Library:**
|
||||
- Recharts oder Chart.js?
|
||||
- Welcher Chart-Typ? (LineChart, BarChart, ComposedChart, etc.)
|
||||
- Welche Features? (Tooltip, Legend, Dual-Axis, etc.)
|
||||
|
||||
**API-Integration:**
|
||||
- API-Funktion in `api.js` hinzufügen
|
||||
- State-Management (useState, useEffect)
|
||||
- Loading + Error Handling
|
||||
|
||||
### 2.4 Dependencies
|
||||
|
||||
- Müssen andere Module angepasst werden?
|
||||
- Neue npm-Pakete nötig?
|
||||
- DB-Migrationen nötig?
|
||||
|
||||
**OUTPUT:** Zeige dem User das vollständige Umsetzungskonzept.
|
||||
|
||||
---
|
||||
|
||||
## STUFE 3: User-Approval einholen
|
||||
|
||||
**Aufgabe:**
|
||||
1. Zeige Anforderungs-Matrix (Stufe 1)
|
||||
2. Zeige Umsetzungskonzept (Stufe 2)
|
||||
3. Liste offene Fragen auf
|
||||
4. Frage explizit: **"Soll ich mit der Implementierung beginnen? (ja/nein/Änderungen)"**
|
||||
|
||||
**WICHTIG:**
|
||||
- **Warte auf die Antwort des Users**
|
||||
- Beginne NICHT mit der Implementierung ohne explizites "ja"
|
||||
- Bei Änderungswünschen: Passe das Konzept an und zeige es erneut
|
||||
|
||||
---
|
||||
|
||||
## STUFE 4: Implementierung
|
||||
|
||||
**NUR ausführen wenn User "ja" gesagt hat!**
|
||||
|
||||
### 4.1 Backend implementieren
|
||||
|
||||
1. **Neue data_layer Funktionen:**
|
||||
- Erstelle/erweitere Dateien in `backend/data_layer/`
|
||||
- Implementiere genau nach Konzept (Stufe 2.1)
|
||||
- Docstrings mit Beschreibung + Args + Returns
|
||||
|
||||
2. **Neue Endpoints:**
|
||||
- Erstelle/erweitere Router in `backend/routers/`
|
||||
- Implementiere genau nach Konzept (Stufe 2.1)
|
||||
- Response-Format exakt wie spezifiziert (Stufe 2.2)
|
||||
|
||||
3. **Tests (falls vorhanden):**
|
||||
- Unit-Tests für data_layer Funktionen
|
||||
- Integration-Tests für Endpoints
|
||||
|
||||
### 4.2 Frontend implementieren
|
||||
|
||||
1. **API-Funktion hinzufügen:**
|
||||
- Ergänze `frontend/src/utils/api.js`
|
||||
- Syntax: `getXyzChart: (days=28) => req(\`/charts/xyz?days=${days}\`)`
|
||||
|
||||
2. **Component erstellen/erweitern:**
|
||||
- Implementiere Chart-Darstellung
|
||||
- Verwende Chart-Library wie spezifiziert
|
||||
- Loading + Error Handling
|
||||
|
||||
3. **Integration:**
|
||||
- Füge Component in Parent-Page ein
|
||||
- Teste UI-Flow
|
||||
|
||||
### 4.3 Commit
|
||||
|
||||
```
|
||||
feat: {{feature-name}} (konzept-konform)
|
||||
|
||||
Backend:
|
||||
- data_layer: [Liste neue Funktionen]
|
||||
- Endpoint: [Liste neue Endpoints]
|
||||
|
||||
Frontend:
|
||||
- Component: [Beschreibung]
|
||||
- Chart-Type: [Typ]
|
||||
|
||||
Konzept: {{konzept-file}}
|
||||
|
||||
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## STUFE 5: Compliance-Check
|
||||
|
||||
**Aufgabe:**
|
||||
Prüfe JEDE Anforderung aus der Anforderungs-Matrix (Stufe 1):
|
||||
|
||||
```
|
||||
□ Anforderung 1: [Beschreibung] - Status: ✓ / ✗
|
||||
□ Anforderung 2: [Beschreibung] - Status: ✓ / ✗
|
||||
...
|
||||
```
|
||||
|
||||
**Alle Checkboxen müssen ✓ sein vor Push!**
|
||||
|
||||
Falls ✗:
|
||||
- Identifiziere was fehlt
|
||||
- Implementiere nach
|
||||
- Erneut prüfen
|
||||
|
||||
**OUTPUT:** Zeige dem User die Final-Checkliste.
|
||||
|
||||
---
|
||||
|
||||
## WICHTIG: Workflow-Reihenfolge
|
||||
|
||||
```
|
||||
Stufe 1 (Anforderungen) → Stufe 2 (Konzept) → Stufe 3 (Approval)
|
||||
↓
|
||||
User sagt "ja"?
|
||||
↓
|
||||
Stufe 4 (Implementierung) → Stufe 5 (Compliance-Check) → Push
|
||||
```
|
||||
|
||||
**Niemals:**
|
||||
- Stufen überspringen
|
||||
- Ohne Approval implementieren
|
||||
- "Ähnliches" statt Gefordertes bauen
|
||||
|
||||
---
|
||||
|
||||
## Los geht's!
|
||||
|
||||
Beginne jetzt mit **STUFE 1: Anforderungsanalyse**.
|
||||
|
||||
Lies `{{konzept-file}}` und erstelle die Anforderungs-Matrix für `{{feature-name}}`.
|
||||
Reference in new issue
Block a user