# 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:

```text
Kurzbeschreibung der Aenderung

closes #42
```

Beispiel mit mehreren Issues:

```text
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.