DShotRMT/GEMINI.md

# GEMINI.md - Arbeitsanweisungen für den KI-Assistenten

Dieses Dokument beschreibt die Kernprinzipien und projektspezifischen Regeln, nach denen der KI-Assistent arbeitet.

## 1. Allgemeine Prinzipien

-   **Kontext-Treue:** Ich halte mich strikt an die Konventionen des Projekts (Code-Stil, Bibliotheken, Architektur). Vor Änderungen analysiere ich den bestehenden Code.
-   **Sicherheit:** Kritische Befehle, die das Dateisystem oder den Systemzustand verändern, werden vor der Ausführung erklärt. Ich verarbeite oder speichere niemals sensible Daten wie Passwörter oder Tokens.
-   **Effizienz und Präzision:** Meine Antworten sind kurz und direkt. Ich nutze Werkzeuge für Aktionen und Text nur für die Kommunikation.

## 2. Technische Arbeitsweise

-   **Dateisystem:** Ich verwende für alle Dateioperationen ausschließlich absolute Pfade.
-   **Shell-Befehle:** Modifizierende Befehle werden erklärt. Langlaufende Prozesse starte ich als Hintergrund-Jobs (`&`).
-   **Verifizierung:** Nach Code-Änderungen stelle ich durch Kompilieren oder das Ausführen von Tests (sofern im Projekt definiert) sicher, dass die Änderungen korrekt sind.

## 3. Git-Workflow

-   **Analyse:** Vor einem Commit analysiere ich den Zustand des Repositories mit `git status`, `git diff` und `git log`, um Konsistenz zu gewährleisten.
-   **Commit-Erstellung:** Ich schlage aussagekräftige Commit-Nachrichten vor, die die Änderungen und deren Zweck zusammenfassen.
-   **Manuelle Bestätigung:** Ich führe niemals `git push` aus, ohne explizit dazu aufgefordert zu werden.

## 4. Projektspezifische Konventionen (DShotRMT)

-   **Technologie-Stack:** C++, `arduino-cli`
-   **Build-Befehl:** `arduino-cli compile --fqbn esp32:esp32:esp32 <sketch-pfad>`
-   **Namenskonventionen:** `_private_var` für private Member, `camelCase` für öffentliche Funktionen.
-   **Sprache im Code:** Kommentare, Variablen und Funktionsnamen sind ausschließlich auf Englisch.
-   **Interaktion:** Code-Vorschläge und Änderungen werden begründet, um deren Vorteile aufzuzeigen.
feat(library): Add percent throttle, improve usability & fix bugs - Adds a new `sendThrottlePercent()` function for more intuitive throttle control. - Allows initializing the motor magnet count directly in the constructor. - Updates all examples to use the new features. - Adds a new `throttle_percent` example sketch. - Fixes a critical resource leak in `begin()` on partial init failure. - Hardens web examples with security warnings and improves the UI. - Updates README to reflect all changes. 2025-09-20 15:47:39 +01:00			`# GEMINI.md - Arbeitsanweisungen für den KI-Assistenten`

			`Dieses Dokument beschreibt die Kernprinzipien und projektspezifischen Regeln, nach denen der KI-Assistent arbeitet.`

			`## 1. Allgemeine Prinzipien`

			`- Kontext-Treue: Ich halte mich strikt an die Konventionen des Projekts (Code-Stil, Bibliotheken, Architektur). Vor Änderungen analysiere ich den bestehenden Code.`
			`- Sicherheit: Kritische Befehle, die das Dateisystem oder den Systemzustand verändern, werden vor der Ausführung erklärt. Ich verarbeite oder speichere niemals sensible Daten wie Passwörter oder Tokens.`
			`- Effizienz und Präzision: Meine Antworten sind kurz und direkt. Ich nutze Werkzeuge für Aktionen und Text nur für die Kommunikation.`

			`## 2. Technische Arbeitsweise`

			`- Dateisystem: Ich verwende für alle Dateioperationen ausschließlich absolute Pfade.`
			- Shell-Befehle: Modifizierende Befehle werden erklärt. Langlaufende Prozesse starte ich als Hintergrund-Jobs (`&`).
			`- Verifizierung: Nach Code-Änderungen stelle ich durch Kompilieren oder das Ausführen von Tests (sofern im Projekt definiert) sicher, dass die Änderungen korrekt sind.`

			`## 3. Git-Workflow`

			- Analyse: Vor einem Commit analysiere ich den Zustand des Repositories mit `git status`, `git diff` und `git log`, um Konsistenz zu gewährleisten.
			`- Commit-Erstellung: Ich schlage aussagekräftige Commit-Nachrichten vor, die die Änderungen und deren Zweck zusammenfassen.`
			- Manuelle Bestätigung: Ich führe niemals `git push` aus, ohne explizit dazu aufgefordert zu werden.

			`## 4. Projektspezifische Konventionen (DShotRMT)`

			- Technologie-Stack: C++, `arduino-cli`
			- Build-Befehl: `arduino-cli compile --fqbn esp32:esp32:esp32 <sketch-pfad>`
			- Namenskonventionen: `_private_var` für private Member, `camelCase` für öffentliche Funktionen.
			`- Sprache im Code: Kommentare, Variablen und Funktionsnamen sind ausschließlich auf Englisch.`
			`- Interaktion: Code-Vorschläge und Änderungen werden begründet, um deren Vorteile aufzuzeigen.`