Skip to content

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:

  1. 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.
  2. Bij status:awaiting-ivar: beantwoord de keuze met een reactie in het intake-issue; de assistent werkt het voorstel bij.
  3. Bij status:proposed: akkoord → /ready in het intake-issue (of status:ready zelf 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 je ready zet, anders vraagt de bouwende agent het alsnog.
  4. Severity correctie: Eefje gebruikt vooral nice-to-have en important. Override naar blocker of minor als haar inschatting niet matcht met productimpact.
  5. Reporter label: blijft reporter:eefje voor haar issues. Intern werk (dependabot, refactors, infra) gaat niet via de feedback-repo maar via .planning/todos/pending/<slug>.md met status: 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:opened en 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 naar workflow_run van 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 alleen status:in-progress.