Changelog Generatie voor Git Commits¶
Gebruik een AI-assistent om automatisch een Changelog-omschrijving te genereren voor een Git commit description. Deze aanpak werkt zonder PhpStorm en is inzetbaar in elke omgeving met toegang tot een AI-assistent (bijv. Claude Code).
De Flooris Prompt¶
Gebruik de volgende prompt in een AI-assistent terwijl de relevante wijzigingen in de context staan (bijv. via git diff of geselecteerde bestanden):
Schrijf een Changelog omschrijving voor een Git commit description van de relevante aanpassingen in de huidige context.
Hanteer de standaarden vanuit https://keepachangelog.com/en/1.1.0/
Wat doet deze prompt?
- Changelog standaard: Volgt de Keep a Changelog conventies voor consistente en leesbare commit descriptions
- Contextbewust: De AI analyseert de aanwezige diff of bestanden en beschrijft alleen de relevante wijzigingen
- Gestructureerd: Output wordt opgedeeld in categorieën zoals
Added,Changed,Fixed,Removed
Gebruik in Claude Code¶
Bij gebruik van Claude Code kun je de prompt direct in de chat invoeren terwijl de gewijzigde bestanden of de diff in de context staan.
Stappen¶
- Zorg dat de relevante wijzigingen zichtbaar zijn (bijv. open bestanden of voer eerst
git diffuit) - Plak de bovenstaande prompt in de Claude Code chat
- Kopieer de gegenereerde tekst als commit description
Tip: branch naam meegeven
Als je project een taaksleutel in de branchnaam gebruikt (bijv. feature/BR-1234-...), voeg dan de branchnaam toe aan de prompt zodat de AI de taaksleutel kan opnemen:
Schrijf een Changelog omschrijving voor een Git commit description van de relevante aanpassingen in de huidige context.
Hanteer de standaarden vanuit https://keepachangelog.com/en/1.1.0/
De huidige branch is: feature/BR-1234-nieuwe-feature
Keep a Changelog categorieën¶
De gegenereerde output volgt deze standaard categorieën:
| Categorie | Gebruik voor |
|---|---|
Added |
Nieuwe functionaliteit |
Changed |
Wijzigingen aan bestaande functionaliteit |
Deprecated |
Functionaliteit die binnenkort verwijderd wordt |
Removed |
Verwijderde functionaliteit |
Fixed |
Bugfixes |
Security |
Beveiligingspatches |
Voorbeeld output
Voor wijzigingen waarbij een inlogformulier is toegevoegd en een validatiebug is opgelost:
BR-1234 Add user authentication form
Added:
- Login form with email and password fields
- Remember me checkbox
Fixed:
- Validation error not shown on empty password submission