netwatch/AGENTS.md

AGENTS.md

Ziel

Codex arbeitet pragmatisch bei Aufgaben aus NEXT.md und User-Requests. Ein Gitea-Issue ist optional.

Kernregeln

1. Ein Issue ist nicht erforderlich, um eine Aufgabe umzusetzen.
2. Skills duerfen jederzeit verwendet werden (z. B. gitea-issues).
3. Ein NEXT.md-Punkt darf erst auf erledigt ([x]) gesetzt werden, wenn die Umsetzung im Code erfolgt ist.
4. Nur wenn ein Gitea-Issue konkret referenziert ist und durch die Aenderung abgeschlossen wird, muss die Commit-Message closes #<id> enthalten.
5. Jede closes-Referenz steht in einer eigenen Zeile.
6. Kein closes #<id>, wenn das Issue nicht tatsaechlich abgeschlossen ist.
7. git push nur auf explizite Aufforderung; standardmaessig nur committen.

Verbindlicher Ablauf

1. Aufgabe umsetzen (aus NEXT.md oder User-Anfrage).
2. Optional Issues laden, wenn Kontext/Zuordnung noetig ist:
   • python C:/Users/s.titz/.codex/skills/gitea-issues/scripts/list_issues.py <owner> <repo> --state open --limit 100 --json
3. NEXT.md bei Bedarf aktualisieren (mit oder ohne [#<id>]).
4. Commit erstellen.
5. Wenn Issue abgeschlossen wird, Commit-Message mit eigener closes-Zeile schreiben.

Commit-Format bei Issue-Abschluss

Beispiel mit einem Issue:

Kurzbeschreibung der Aenderung

closes #42

Beispiel mit mehreren Issues:

Kurzbeschreibung der Aenderung

closes #12
closes #18

Format fuer NEXT.md

• Offen ohne Issue:
  • - [ ] //TODO Backup-Runbook erstellen
• Offen mit Issue:
  • - [ ] [#42] //TODO Backup-Runbook erstellen
• Erledigt mit Issue:
  • - [x] [#42] Backup-Runbook erstellen
• Erledigt ohne Issue:
  • - [x] Backup-Runbook erstellen

Annahme

• Gitea ist so konfiguriert, dass closes #<id> in Commit-Messages das Issue schliesst.