kader bestanden toegevoegd
This commit is contained in:
@@ -0,0 +1,74 @@
|
||||
# SAFE_FILES.md
|
||||
|
||||
Dit document definieert kritieke bestanden die AI-agents niet zelfstandig mogen wijzigen.
|
||||
|
||||
Doel:
|
||||
- kritieke infrastructuur beschermen
|
||||
- auth- en containerlogica stabiel houden
|
||||
- API contract beschermen
|
||||
|
||||
---
|
||||
|
||||
# Safe Files
|
||||
|
||||
De volgende bestanden mogen alleen worden aangepast na expliciete toestemming van de gebruiker:
|
||||
|
||||
- app/services/tvdb_auth_service.py
|
||||
- container/Containerfile
|
||||
- requirements.txt
|
||||
- AGENTS.md
|
||||
- CHANGE_POLICY.md
|
||||
- SAFE_FILES.md
|
||||
- contracts/API_GOLDEN.md
|
||||
- docs/ARCHITECTURE.md
|
||||
|
||||
---
|
||||
|
||||
# Waarom deze bestanden beschermd zijn
|
||||
|
||||
## app/services/tvdb_auth_service.py
|
||||
Bevat werkende TVDB auth, JWT exp parsing, renew-logica en token persistence.
|
||||
|
||||
## container/Containerfile
|
||||
Bevat de werkende runtime-basis voor het project.
|
||||
|
||||
## requirements.txt
|
||||
Kan runtime en dependency-gedrag ingrijpend veranderen.
|
||||
|
||||
## AGENTS.md
|
||||
Stuurt AI-gedrag aan en mag niet stilzwijgend gewijzigd worden.
|
||||
|
||||
## CHANGE_POLICY.md
|
||||
Bevat wijzigingsregels voor AI-agents.
|
||||
|
||||
## SAFE_FILES.md
|
||||
Bevat de lijst van beschermde bestanden zelf.
|
||||
|
||||
## contracts/API_GOLDEN.md
|
||||
Beschermt het bestaande API contract.
|
||||
|
||||
## docs/ARCHITECTURE.md
|
||||
Beschrijft architecturale invariants die niet ongemerkt mogen veranderen.
|
||||
|
||||
---
|
||||
|
||||
# Toegestane werkwijze bij Safe Files
|
||||
|
||||
Als een wijziging aan een safe file echt nodig is, moet de agent:
|
||||
|
||||
1. expliciet melden welk safe file gewijzigd moet worden
|
||||
2. uitleggen waarom dit nodig is
|
||||
3. wachten op toestemming van de gebruiker
|
||||
|
||||
Zonder expliciete toestemming mag een safe file niet gewijzigd worden.
|
||||
|
||||
---
|
||||
|
||||
# Niet-safe bestanden
|
||||
|
||||
Bestanden buiten deze lijst mogen aangepast worden, zolang:
|
||||
|
||||
- de wijziging binnen projectscope valt
|
||||
- de API contracten niet worden gebroken
|
||||
- regressietests slagen
|
||||
- de architectuurregels gerespecteerd blijven
|
||||
Reference in New Issue
Block a user