Eefje Feedback Intake¶
Sinds 2026-05-06 melden bugs en feature-wensen via een aparte private repo:
Voorman/freezedesign-feedback.
Deze runbook beschrijft het volledige intake-proces vanuit Ivar's perspectief.
Architectuur¶
flowchart TD
A[Eefje → Issue Form<br/>NL, dropdowns, screenshot] -->|auto-labels: type:bug/feature,<br/>status:needs-triage, reporter:eefje| B[freezedesign-feedback#N]
B -->|notify-discord workflow| C[#eefje-feedback channel]
B --> T[Intake-assistent zoekt het uit:<br/>vraag aan Eefje, keuze voor Ivar,<br/>of voorstel → status:proposed]
T --> IV[Intake-issue in webshop_freeze_design<br/>label intake, 'Intake feedback #N: …'<br/>met het deel voor Ivar]
IV -->|Ivar reageert '/ready' →<br/>intake-ready.yml| D[status:ready gezet door Voorman,<br/>intake-issue dicht]
D -->|agent of Ivar leest:<br/>gh issue list -l status:ready| E[PR in webshop_freeze_design<br/>met 'Feedback: Voorman/freezedesign-feedback#N']
E -->|PR merge → staging →<br/>groene CI-run incl. deploy-job| F[feedback-retest-comment workflow<br/>triggert op workflow_run van 'CI',<br/>branch staging, push, success —<br/>dus pas ná de geslaagde staging-deploy]
F --> G[Comment op issue met gedeployde<br/>staging-sha + link naar de PR<br/>+ label → status:retest-pending]
G -->|Eefje retest| H{OK?}
H -->|OK| I[Eefje sluit issue zelf]
H -->|Niet OK| J[Eefje comment 'still broken'<br/>→ vervolg-PR]
Triage werkwijze (sinds 2026-10-10: goedkeuren eerst)¶
In de feedback-repo draait een intake-assistent (.github/intake-agent/AGENT.md
daar). Bij elke melding en elke reactie van Eefje zoekt hij de bug of wens uit in de code
en doet dan één van drie dingen; hij bouwt zelf niets:
| Hij zet | Wie is aan zet |
|---|---|
status:awaiting-eefje |
Eefje beantwoordt zijn vragen in de issue |
status:awaiting-ivar |
Ivar maakt een technische keuze |
status:proposed |
Ivar beslist of het voorstel opgepakt wordt |
Het deel voor Ivar staat niet in Eefjes melding (sinds #843, todo
intake-ivar-deel-apart). De assistent schrijft zijn voorstel, de technische keuzes en een
"Open punt voor Ivar" in een intake-issue in deze repo: label intake, titel
Intake feedback #<N>: …. Eefje ziet dat issue niet. Bij oudere meldingen staat het
voorstel nog in de melding zelf, als reactie die eindigt op "🤖 Automatische assistent van
Freeze Design". In Eefjes melding schrijft niemand iets voor Ivar of voor agents: geen
@Voorman, geen /ready, geen techniek.
gh issue list -R Voorman/webshop_freeze_design -l intake --state all \
--search "in:title \"Intake feedback #<N>:\"" --json number,url
Ivar zegt "ja" door status:ready te zetten. Dat kan met de hand in de feedback-repo, of
met een reactie /ready in het intake-issue: de workflow intake-ready.yml
(scripts/intake-ready.sh) zet dan status:ready op melding #N met FEEDBACK_REPO_TOKEN
(Ivars token, dus op naam van Voorman), haalt de andere status:*-labels weg en sluit het
intake-issue. Dat werkt alleen als de melding open is en op status:proposed staat. Een
andere reactie van Ivar in het intake-issue terwijl de melding op status:awaiting-ivar
staat, is zijn antwoord op de technische keuze: de workflow start de intake-assistent in de
feedback-repo opnieuw (workflow_dispatch), en die leest het antwoord uit het intake-issue.
Pas na status:ready mag een agent bouwen, en alleen als de laatste keer dat het label erop
kwam Voorman het zette (Eefje heeft ook schrijfrechten). Een agent controleert dat zo:
gh api repos/Voorman/freezedesign-feedback/issues/<N>/timeline --paginate \
--jq '.[] | select(.event == "labeled" and .label.name == "status:ready")
| .actor.login' | tail -n 1 # → moet "Voorman" zijn
Wat Ivar zelf doet bij een melding in #eefje-feedback:
- Lees de hele issue body en de reacties van de assistent. Ga niet direct fixen — Eefje's beschrijving bevat soms detail dat in agent-context verloren gaat.
- Bij
status:awaiting-ivar: beantwoord de keuze met een reactie in het intake-issue; de assistent werkt het voorstel bij. - Bij
status:proposed: akkoord →/readyin het intake-issue (ofstatus:readyzelf zetten). Niet akkoord → reageer in het intake-issue met wat anders moet; de assistent past het voorstel aan. Een "Open punt voor Ivar" in het voorstel beantwoord je vóór jereadyzet, anders vraagt de bouwende agent het alsnog. - Severity correctie: Eefje gebruikt vooral
nice-to-haveenimportant. Override naarblockerofminorals haar inschatting niet matcht met productimpact. - Reporter label: blijft
reporter:eefjevoor haar issues. Intern werk (dependabot, refactors, infra) gaat niet via de feedback-repo maar via.planning/todos/pending/<slug>.mdmetstatus: ready.
De oudere labels status:needs-clarification, status:awaiting-decision,
status:blocked-on-content en status:needs-scoping komen nog voor op oude issues en
betekenen hetzelfde: niet bouwen.
Werken op een issue (handmatig)¶
# Pak een ready issue:
gh issue list -R Voorman/freezedesign-feedback -l status:ready \
--json number,title,labels
# Bekijk volledige inhoud + comments:
gh issue view <N> -R Voorman/freezedesign-feedback --comments
# Markeer als in-progress en haal álle andere status:*-labels weg
# (vaak staat status:proposed nog naast status:ready):
weg=$(gh issue view <N> -R Voorman/freezedesign-feedback --json labels \
--jq '[.labels[].name | select(startswith("status:") and . != "status:in-progress")] | join(",")')
gh issue edit <N> -R Voorman/freezedesign-feedback \
--add-label "status:in-progress" ${weg:+--remove-label "$weg"}
# Branch aanmaken:
git checkout staging && git pull
git checkout -b fix/feedback-<N>-<korte-slug>
# ... werk ...
# PR aanmaken (PR-template heeft het Feedback:-veld al):
gh pr create --base staging --title "fix(<area>): <korte beschrijving>" \
--body "Feedback: Voorman/freezedesign-feedback#<N>
## Verify on staging
- [ ] <stap 1>
- [ ] <stap 2>"
Na merge naar staging wacht feedback-retest-comment.yml op de succesvolle
CI-run van die push (sinds 2026-06-10 zit de staging-deploy als deploy-job
ín de CI-run) en plaatst dan automatisch een retest-comment met de
gedeployde SHA op de issue.
Werken op een issue (via agent)¶
CLAUDE.md beschrijft dit. Korte versie:
"Pak issue #<N> op uit Voorman/freezedesign-feedback. Lees de form-velden,
zet status:in-progress, branch fix/feedback-<N>-<slug>, PR tegen staging
met de juiste Feedback-referentie en Verify-on-staging checklist."
De agent doet de rest. Bij PR-review check je dat:
- Branch-naam matcht met issue.
- Body bevat exact Feedback: Voorman/freezedesign-feedback#<N>.
- Verify-checklist is concreet en uitvoerbaar door Eefje (niet "test alle CRUD").
Discord notifications¶
#eefje-feedback channel toont:
- 📥 Nieuwe issue (blauw)
- 💬 Nieuwe comment (paars) — incl. retest-comments van de bot
- 🔄 Heropende issue (rood) — als Eefje "still broken" comment voorzien van reopen, of bij vervolg-PR
- ✅ Gesloten issue (groen) — Eefje retest succesvol
Webhook secret: DISCORD_WEBHOOK_EEFJE_FEEDBACK in zowel
Voorman/freezedesign-feedback (voor de notify workflow) als
Voorman/webshop_freeze_design (legacy — kan weg na verificatie dat hier
niets meer mee gebeurt).
Cross-repo PAT¶
FEEDBACK_REPO_TOKEN in Voorman/webshop_freeze_design is een fine-grained
PAT met:
- Resource owner: Voorman
- Repository access: alleen Voorman/freezedesign-feedback
- Permissions: Issues read & write, en Actions read & write (intake-ready.yml start er de
intake-assistent mee opnieuw)
Gebruikt door feedback-retest-comment.yml (retest-comment en label) en intake-ready.yml
(/ready). Vervaldatum: jaarlijks rollen. Set reminder.
Migratie van oude todos¶
Pre-2026-05-06 todos in .planning/todos/pending/ blijven daar tot Eefje ze
opnieuw meldt of Ivar ze handmatig migreert. Niet automatisch syncen —
veel daarvan zijn al achterhaald.
.planning/todos/ blijft bestaan voor intern Ivar/agent-werk dat niet voor
Eefje zichtbaar hoeft te zijn (dependabot triage, refactors, infra-werk).
End-to-end testing¶
Geverifieerd op 2026-05-06 via test-issue #2:
- Issue Form auto-labels werken (
status:needs-triage,type:bug,reporter:ivar). - Notify-Discord workflow triggert op
issues:openeden plaatst embed in#eefje-feedback. - Cross-repo retest-comment workflow triggert op PR-merge naar staging,
parset
Feedback:-regel, comment + label switch op gelinkte issue. (Trigger is sindsdien tweemaal verplaatst: eerst naar deploy-success, sinds 2026-06-10 naarworkflow_runvan de CI-run op staging — de deploy is nu een job binnen CI. Functioneel gedrag ongewijzigd.) - Label-cleanup edge case (issue #3, PR #74): bij retest-pending switch
worden alle bestaande
status:*labels gestript, niet alleenstatus:in-progress.