AGENTS contribution workflow
Dieses Repository verwendet einen implementierungsorientierten Workflow für alle Feature-Arbeiten.
Erforderliche Reihenfolge für jedes Feature
- Design zuerst
- Beschreibe Problem, Ziele, Nicht-Ziele, API/CLI-UX und Randbedingungen.
- Füge Design-Dokumente in
docs/hinzu oder aktualisiere sie.
- Verhalten dokumentieren
- Aktualisiere benutzerorientierte Dokumente (
README.md,docs/index.md), wenn sich Befehle oder Fähigkeiten ändern.
- Aktualisiere benutzerorientierte Dokumente (
- Tests schreiben
- Füge gezielte Unit-Tests für neue Logik hinzu, bevor/bei der Implementierung.
- Code implementieren
- Halte Änderungen chirurgisch und konsistent mit dem bestehenden Projektstil.
- Skills aktualisieren
- Aktualisiere
skills/climate.mdundskills/climate-generator/SKILL.md, wenn sich der Befehlssatz oder die Workflows ändern.
- Aktualisiere
- Lokal validieren
- Ausführen:
go build ./...go test ./...
- Führe während der Entwicklung gezielte Tests für schnelleres Feedback aus.
- Ausführen:
- CI-Status validieren
- Stelle sicher, dass PR-Checks vor dem Merge grün sind.
- Commit-Disziplin
- Kleine, sinnvolle Commits mit klaren Nachrichten.
- Push- und PR-Hygiene
- Pushe Branch-Updates, halte PR-Beschreibung/Checkliste aktuell und beantworte Review-Kommentare mit dem Commit-Hash, der die jeweilige Anforderung adressiert.
Qualitätsregeln
- Entferne oder schwäche keine nicht zusammenhängenden Tests.
- Führe keine brechenden CLI-Änderungen ohne Dokumentation und Migrationshinweise ein.
- Bevorzuge deterministisches Verhalten (sortierte Ausgabe, stabile Iteration).
- Halte generiertes/manifestiertes Verhalten nach Möglichkeit rückwärtskompatibel.
Feature-Checkliste-Vorlage
- Design-Dokument hinzugefügt/aktualisiert
- README/Dokumente aktualisiert
- Skills aktualisiert
- Tests hinzugefügt/aktualisiert
-
go build ./...erfolgreich -
go test ./...erfolgreich - CI-Checks grün