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 <vibe@mistral.ai>
Some checks failed
Deploy to GitHub Pages / build (push) Has been cancelled
Deploy to GitHub Pages / deploy (push) Has been cancelled

This commit is contained in:
paul2212
2026-03-18 20:06:51 +01:00
parent bd2637e8be
commit 527242808e

83
VIBECHAT.md Normal file
View File

@@ -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!* 🖨️