메뉴
Use when asked to cut, prepare, or ship a release of the invulhulpen app, to deploy to production, or to tag a CalVer version. Covers the changelog → tag → automated release/deploy flow and its guards.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Use when asked to run, start, spin up, or test the app locally (boekhouding frontend/backend, standalone form, full stack). Launches the containerized dev environment (postgres + keycloak + backend + frontend + standalone) via podman and verifies it.
Use when editing assessment YAML sources in sources/, asking about the assessment schema structure, adding tasks/fields to prescan.yaml, dpia.yaml or iama.yaml, or working with dependencies, calculations, or references in assessment definitions.
Use when editing sources/begrippenkader_dpia.yaml or sources/begrippenkader_iama.yaml, adding or modifying definitions, asking about the begrippenkader structure or schema, or working with term definitions and their metadata.
Use when answering questions about DPIA concepts, privacy terminology, prescan logic, "wat betekent...", "definitie van...", assessment evaluation rules, report output format, or the relationship between Pre-scan and DPIA assessments.
Use when writing Vue components, working with CSS/styling, button classes, design tokens, or the RVO component library in this project. Helps avoid common mistakes with Utrecht/RVO class naming.
| name | Release |
| description | Use when asked to cut, prepare, or ship a release of the invulhulpen app, to deploy to production, or to tag a CalVer version. Covers the changelog → tag → automated release/deploy flow and its guards. |
| version | 0.1.0 |
De app gebruikt Calendar Versioning: vYYYY.M.D, maand en dag zonder
voorloopnul (bijv. v2026.6.14). Meerdere releases op één dag krijgen een
micro-suffix: v2026.6.14.1. Productie wordt uitsluitend via zo'n tag
bijgewerkt; main werkt alleen acceptatie bij.
Changelog afronden. Verplaats in CHANGELOG.md de inhoud van
## [Unreleased] naar een nieuwe sectie met de versie en datum:
## [2026.6.14] - 2026-06-14
(versie zonder de v-prefix en zonder voorloopnullen). Laat een lege
## [Unreleased] achter. Breng dit via een PR naar main.
Zorg dat acceptatie groen is. De tag promoot het image dat voor de
main-commit is gebouwd; de Deploy acceptatie-run voor die commit moet
geslaagd zijn (anders bestaat het te promoten image niet).
Tag zetten en pushen op de juiste main-commit:
git tag v2026.6.14
git push origin v2026.6.14
release.yaml valideert het CalVer-formaat en de changelog-sectie, maakt
de GitHub-release met die sectie als notes, en start daarna pas
deploy-productie. In een aparte job bouwt het het standalone formulier en
hangt de offline single-file als release-asset aan (een hapering daarin
blokkeert de release of productie-deploy niet).deploy-productie.yaml (gestart door release.yaml, of handmatig via
Run workflow) valideert formaat + changelog, blokkeert een downgrade (de tag
moet de nieuwste CalVer zijn), controleert dat de tag op main staat, en
promoot de acceptatie-images (geen rebuild) naar de CalVer-tag →
ZAD-deployment productie. Mislukt de release-aanmaak, dan start dit niet.| Guard | Eis |
|---|---|
| CalVer-formaat | vYYYY.M.D[.MICRO], geen voorloopnullen |
| Changelog | Een niet-lege ## [versie]-sectie moet bestaan |
| Downgrade | De tag moet de hoogste CalVer-tag zijn — fix forward, deploy nooit een oudere tag |
| Tag op main | De getagde commit moet op main staan |
| Image bestaat | De Deploy acceptatie-run voor die commit moet geslaagd zijn |
| Dispatchbaar | deploy-productie.yaml moet op de default branch (main) staan, anders kan release.yaml het niet starten — zet de eerste CalVer-tag pas na de merge naar main |
De gedeelde checks staan in script/ci/ (validate-calver-tag.sh,
changelog-section.sh, assert-newest-calver-tag.sh) en worden door zowel
release.yaml als deploy-productie.yaml gebruikt; ze zijn gedekt door
script/tests/test_ci_release.py.
Een spoedfix gaat vooruit, niet terug: breng de fix aan op main en geef
'm een nieuwe, hogere CalVer-tag. Een oudere tag (her)taggen en deployen wordt
door de downgrade-guard geblokkeerd, omdat dat productie naar oude code zou
terugzetten.