From dec5a0bcce0e2ed842a9b5aa24f2defbff12d089 Mon Sep 17 00:00:00 2001 From: fixclean Date: Mon, 23 Mar 2026 15:33:07 +0100 Subject: [PATCH] agents update --- AGENTS.md | 67 +++++++++++++++++++++++++++++------- docker-compose.yml | 2 +- init.sql => initdb.d/001.sql | 0 3 files changed, 55 insertions(+), 14 deletions(-) rename init.sql => initdb.d/001.sql (100%) diff --git a/AGENTS.md b/AGENTS.md index 7ab6e26..13dff63 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,26 +1,45 @@ # 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`). + +2. Skills dürfen 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 #` enthalten. + +4. Nur wenn ein Gitea-Issue konkret referenziert ist **und** durch die Änderung abgeschlossen wird, muss die Commit-Message `closes #` enthalten. + 5. Jede `closes`-Referenz steht in einer **eigenen Zeile**. -6. Kein `closes #`, wenn das Issue nicht tatsaechlich abgeschlossen ist. -7. `git push` nur auf explizite Aufforderung; standardmaessig nur committen. + +6. Kein `closes #`, wenn das Issue nicht tatsächlich abgeschlossen ist. + +7. `git push` nur auf explizite Aufforderung; standardmässig nur committen. + +8. Datenbank-Updates als neue SQL-Datei in `initdb.d` mit nächsthöherer Nummer ergänzen. Standard für Codex ist `.sql` (z. B. `00002.sql`, `00003.sql`), und nur die führende Nummer zählt; alles nach der Nummer sind persönliche Notizen. + +9. Sonderfall `-live.sql`: User darf `*-live.sql` anlegen, um bereits produktiv eingespielte Änderungen zu markieren. Codex legt **keine** neuen `*-live.sql` an und erzeugt **keine** zusätzliche gleichnummerige `.sql`, wenn bereits eine passende `*-live.sql` für dieselbe Änderung existiert. Bestehende Dateien in `initdb.d` für neue DB-Änderungen nicht überschreiben. ## 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 --state open --limit 100 --json` + +2. Optional Issues laden, wenn Kontext/Zuordnung nötig ist: + +   - `python C:/Users/s.titz/.codex/skills/gitea-issues/scripts/list_issues.py --state open --limit 100 --json` + +   - ignoriere Issues, die den Tag LATER haben, es sei den es wird explizit verlangt + 3. `NEXT.md` bei Bedarf aktualisieren (mit oder ohne `[#]`). + 4. Commit erstellen. + 5. Wenn Issue abgeschlossen wird, Commit-Message mit eigener `closes`-Zeile schreiben. ## Commit-Format bei Issue-Abschluss @@ -28,7 +47,9 @@ Ein Gitea-Issue ist optional. Beispiel mit einem Issue: ```text -Kurzbeschreibung der Aenderung +Kurzbeschreibung der Änderung + + closes #42 ``` @@ -36,23 +57,43 @@ closes #42 Beispiel mit mehreren Issues: ```text -Kurzbeschreibung der Aenderung +Kurzbeschreibung der Änderung + + closes #12 + closes #18 ``` -## Format fuer NEXT.md +## Format für NEXT.md - Offen ohne Issue: - - `- [ ] //TODO Backup-Runbook erstellen` + +  - `- [ ] //TODO Backup-Runbook erstellen` + - Offen mit Issue: - - `- [ ] [#42] //TODO Backup-Runbook erstellen` + +  - `- [ ] [#42] //TODO Backup-Runbook erstellen` + - Erledigt mit Issue: - - `- [x] [#42] Backup-Runbook erstellen` + +  - `- [x] [#42] Backup-Runbook erstellen` + - Erledigt ohne Issue: - - `- [x] Backup-Runbook erstellen` + +  - `- [x] Backup-Runbook erstellen` ## Annahme - Gitea ist so konfiguriert, dass `closes #` in Commit-Messages das Issue schliesst. + +## Encoding + +immer utf8 ohne BOM, es sei den es ist anders angegeben + +## Sprache und Rechtschreibung + +- In sichtbaren Nutzertexten immer korrekte deutsche Rechtschreibung verwenden: ä/ö/ü/Ä/Ö/Ü statt ae/oe/ue, und ß statt ss, wenn orthografisch korrekt. + +- Technische Bezeichner (z. B. Variablen, Tabellen, URLs, Query-Parameter wie gebaeude) bleiben unverändert. diff --git a/docker-compose.yml b/docker-compose.yml index dcce827..a646aa5 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -20,7 +20,7 @@ services: MARIADB_PASSWORD: netdoc volumes: - db_data:/var/lib/mysql - - ./init.sql:/docker-entrypoint-initdb.d/init.sql + - ./initdb.d:/docker-entrypoint-initdb.d restart: "no" phpmyadmin: diff --git a/init.sql b/initdb.d/001.sql similarity index 100% rename from init.sql rename to initdb.d/001.sql