Steuerkram/docs/automatisierung.md

50 lines
1.7 KiB
Markdown

# Automatisierung & Support
## Automatisierungsagent
Issues mit dem Label **`automate`** im [Codeberg-Repo](https://codeberg.org/fds2610/Steuerkram/issues) werden automatisch durch einen stündlich per Cron gestarteten Agenten (Claude CLI) verarbeitet. Mehrere offene Tickets werden in einer Sitzung sequenziell abgearbeitet. Ein Lockfile verhindert parallele Läufe.
### Ablauf je Ticket
1. Issue-Body und alle Kommentare laden (inkl. Diskussionsergebnisse früherer Rückfragen)
2. Relevante Codebase-Dateien lesen
3. **Klarheitscheck**: Sind die Anforderungen eindeutig? Falls nicht → Rückfragen als Kommentar posten, `automate`-Label entfernen, warten
4. Analyse (Ursache, Lösungsplan, Risiken)
5. Lösung implementieren
6. Tests ausführen (`php tests/run.php`), Fehler beheben
7. Commit & Push: `Fix #NR: Kurzbeschreibung`
8. Kommentar mit Zusammenfassung im Issue posten
9. Labels aktualisieren, Issue offen lassen
### Label-Ausgänge
| Ergebnis | `automate` | gesetztes Label |
|---|---|---|
| Erfolgreich umgesetzt | entfernt | `testing` |
| Unklar / Rückfrage offen | entfernt | *(keins)* |
| Zu riskant / abgelehnt | entfernt | `abgelehnt` |
### Manuell starten
```bash
/home/fds/projects/Steuerkram/.claude/automate-run.sh
```
---
## Ideenagent
Ein separater Agent sammelt und bewertet Ideen zur Weiterentwicklung. Er läuft ebenfalls per Cron.
```bash
/home/fds/projects/Steuerkram/.claude/ideenagent-run.sh
```
---
## Support
Issues können im [Codeberg-Repo](https://codeberg.org/fds2610/Steuerkram/issues) gemeldet werden.
- Mit dem Label **`automate`** werden sie automatisch verarbeitet (siehe oben).
- Ohne Label landen sie in der normalen Issue-Queue.