kodi
3.4 KiB
CHANGE_POLICY.md
Dit document bepaalt welke wijzigingen AI-agents zelfstandig mogen uitvoeren en welke wijzigingen expliciete toestemming vereisen.
Doel:
- ongewenste refactors voorkomen
- contractbreuk voorkomen
- stabiliteit bewaken
Algemene regel
AI-agents mogen alleen kleine, lokale, testbare wijzigingen uitvoeren.
AI-agents mogen geen brede of structurele wijzigingen uitvoeren zonder expliciete toestemming van de gebruiker.
Wijzigingen die ZONDER expliciete toestemming mogen
De volgende wijzigingen mogen zelfstandig worden gedaan, mits regressietests slagen:
- kleine bugfixes
- toevoegen van nieuwe, lokale helperfuncties
- toevoegen van logging zonder secrets
- uitbreiden van bestaande responses met extra velden, zolang bestaande velden intact blijven
- toevoegen van nieuwe endpoints, zolang bestaande endpoints niet wijzigen
- uitbreiden van tests
- verbeteren van foutafhandeling
- verbeteren van type hints
- kleine frontend-aanpassingen zonder wijziging van workflow
- documentatie bijwerken
Wijzigingen die ALLEEN met expliciete toestemming mogen
De volgende wijzigingen zijn verboden zonder expliciete toestemming:
- wijzigen van bestaande endpointnamen
- wijzigen van bestaande response-structuren
- verwijderen van velden uit API responses
- wijzigen van token lifecycle logica
- wijzigen van rename template
- wijzigen van mount paths of allowed media roots
- wijzigen van container runtime model
- wijzigen van projectstructuur
- wijzigen van SAFE FILES
- vervangen van libraries of frameworkkeuzes
- brede refactors over meerdere modules
- wijzigen van securityregels rond file access
Verboden wijzigingen
De volgende wijzigingen zijn altijd verboden zonder expliciete opdracht:
- code buiten deze repository aanpassen
- andere containers aanpassen
- system config wijzigen
- firewall wijzigen
- systemd global wijzigen
- prune, cleanup of delete acties uitvoeren buiten deze projectscope
- secrets hardcoden
- API keys of tokens loggen
Refactor Policy
Geen silent refactors.
Elke refactor moet:
- vooraf benoemd worden
- beperkt blijven in scope
- regressietests behouden
- geen API contract breken
Als een wijziging niet strikt nodig is voor het gevraagde doel, moet de agent die wijziging niet doen.
Test Policy
Na iedere wijziging moeten minimaal drie regressietests worden uitgevoerd:
- curl 127.0.0.1:8085/api/health
- curl 127.0.0.1:8085/api/tvdb/auth-status
- curl "127.0.0.1:8085/api/tvdb/search?q=elsbeth"
Daarnaast moeten minimaal drie tests worden uitgevoerd voor de nieuwe of gewijzigde functionaliteit.
Nieuwe feature tests moeten:
- het gevraagde gedrag verifiëren
- geen bestaande functionaliteit breken
- waar mogelijk mechanisch herhaalbaar zijn
Escalated Execution Policy
Escalated execution is toegestaan binnen deze projectscope voor:
- podman build
- podman run
- curl tests
- bestanden aanmaken en aanpassen
- dependency install binnen het project
- lokale build- en testacties
Escalated execution is niet toegestaan voor:
- systeembrede wijzigingen
- andere repositories
- andere stacks of containers
- destructieve cleanup acties
Output Policy
Bij elke wijziging moet de agent kort rapporteren:
- welke bestanden zijn aangepast
- waarom die wijziging nodig was
- welke regressietests zijn uitgevoerd
- welke feature tests zijn uitgevoerd
- welke risico’s of aandachtspunten er nog zijn