sillyhome-next/AGENTS.md

AGENTS.md

Diese Datei ist die kurze Arbeitsanweisung für Menschen und kleine Coding-Modelle.

Reihenfolge

1. README.md lesen.
2. Für Verhaltenslogik docs/BEHAVIOR_ENGINE.md lesen.
3. Für Fehler docs/DEBUGGING.md abarbeiten.
4. Für HA-Automationen docs/CONTROL_HANDOFF.md lesen.
5. Vor Release oder Live-Update docs/OPERATIONS.md vollständig abarbeiten.

Verbindliche Regeln

• Erst Zustand und Logs prüfen, dann Ursache formulieren, dann ändern.
• Keine Annahme als Fakt darstellen.
• Vor Live-Änderungen Backup oder klaren Rollback-Punkt erstellen.
• Bestehende Nutzeränderungen nicht zurücksetzen.
• Kleine, fokussierte Änderungen mit passenden Tests.
• Eigene SillyHome-Schaltungen niemals als neues Nutzerverhalten lernen.
• Ein Aktor darf nicht unbeabsichtigt ohne Steuerung bleiben:
  • SillyHome aktiv: passende HA-Automation darf pausiert sein.
  • SillyHome Shadow: HA-Automation muss auf Wunsch fortgesetzt werden können.
• Keine Secrets in Code, Dokumentation, Commits oder Logs.

Pflichtprüfung

.venv/bin/pytest -q
.venv/bin/ruff check .
.venv/bin/mypy app backend tests
git diff --check

Versionsstellen

Bei jedem Release dieselbe Version setzen:

• pyproject.toml
• addon/config.yaml
• app/main.py
• CHANGELOG.md

Danach prüfen:

grep -R 'version.*0\\.7\\.0' -n pyproject.toml addon/config.yaml app/main.py

Die konkrete Zielversion im Befehl anpassen.