51 lines
1.4 KiB
Markdown
51 lines
1.4 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
.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:
|
|
|
|
```bash
|
|
grep -R 'version.*0\\.7\\.0' -n pyproject.toml addon/config.yaml app/main.py
|
|
```
|
|
|
|
Die konkrete Zielversion im Befehl anpassen.
|