From 527242808e7a8023f312318b03f3c4e80e5201b8 Mon Sep 17 00:00:00 2001 From: paul2212 Date: Wed, 18 Mar 2026 20:06:51 +0100 Subject: [PATCH] Added VIBECHAT.md for project guidelines and collaboration\n\n- Created collaboration guidelines for Mistral Vibe\n- Defined project context, goals, and working methods\n- Added checklists for consistent workflows\n- Documented technical standards and best practices\n\nGenerated by Mistral Vibe.\nCo-Authored-By: Mistral Vibe --- VIBECHAT.md | 83 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 83 insertions(+) create mode 100644 VIBECHAT.md diff --git a/VIBECHAT.md b/VIBECHAT.md new file mode 100644 index 0000000..80d5deb --- /dev/null +++ b/VIBECHAT.md @@ -0,0 +1,83 @@ +# Anweisungen für Mistral Vibe - Fichero Printer Projekt + +## Projektkontext +- **Ziel**: Home Assistant Add-on für Fichero/D11s Thermodrucker +- **Technologie**: Python, BLE/Classic Bluetooth, FastAPI +- **Referenz**: Original-Code in `original/` funktioniert - halte dich daran + +## Arbeitsweise + +### 1. Code-Änderungen +- **Vereinfachen**: Bevorzuge einfache, robuste Lösungen +- **Referenz**: Original-Code als Goldstandard nutzen +- **Dokumentation**: Klare Kommentare für komplexe Logik +- **Testen**: Vor dem Commit lokal testen + +### 2. Versionierung +- **Semantic Versioning**: MAJOR.MINOR.PATCH +- **Changelog**: Detaillierte Einträge mit: + - **Fixed**: Bugfixes + - **Added**: Neue Features + - **Changed**: Änderungen an bestehendem Verhalten + - **Improved**: Verbesserungen ohne API-Änderungen + +### 3. Git-Workflows +- **Commits**: Atomar, mit klaren Nachrichten +- **Branches**: Feature-Branches für Experimente +- **Tags**: Versionen mit `vX.Y.Z` markieren +- **History**: Saubere, nachvollziehbare Commits + +### 4. Fehlerbehandlung +- **Priorität**: Zuverlässigkeit über Features +- **Logging**: Klare, actionable Fehlermeldungen +- **Fallback**: Graceful Degradation implementieren +- **Benutzerführung**: Hilfreiche Fehlermeldungen + +### 5. Kommunikation +- **Fragen**: Bei Unklarheiten nachfragen +- **Optionen**: Bei Entscheidungen Alternativen vorstellen +- **Best Practices**: Python/AsyncIO/Bluetooth Standards folgen +- **Dokumentation**: Code und Prozesse dokumentieren + +## Checkliste für Pull Requests + +- [ ] Code vereinfacht und getestet +- [ ] Referenz zum Original-Code geprüft +- [ ] Dokumentation aktualisiert +- [ ] Version erhöht (CHANGELOG.md) +- [ ] Git-History sauber +- [ ] Tests bestanden (falls vorhanden) + +## Projektziele + +1. **Stabilität**: Zuverlässige Drucker-Verbindung +2. **Benutzerfreundlichkeit**: Einfache Konfiguration +3. **Wartbarkeit**: Sauberer, dokumentierter Code +4. **Kompatibilität**: Home Assistant Standards einhalten + +## Technische Richtlinien + +### Python +- Type Hints verwenden +- PEP 8 einhalten +- Async/Await korrekt nutzen + +### Bluetooth +- BLE bevorzugen (zuverlässiger) +- Classic Bluetooth als Fallback +- Zeitouts sinnvoll setzen + +### Home Assistant +- Add-on Standards einhalten +- Konfiguration validieren +- Logging für Debugging + +## Entscheidungsfindung + +1. **Einfache Lösungen bevorzugen** +2. **Original-Code als Referenz** +3. **Benutzererfahrung priorisieren** +4. **Dokumentation nicht vergessen** + +--- +*Let's build reliable printer connections!* 🖨️ \ No newline at end of file