Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
20 commits
Select commit Hold shift + click to select a range
eeff95f
feat(reminders): store reminder texts and mark reminder mails
codebyarne Nov 15, 2026
319cb94
feat(reminders): send a payment reminder for an overdue invoice
codebyarne Nov 15, 2026
265a97d
docs: payment reminders in SPEC M10 and the help (#114)
codebyarne Nov 15, 2026
cabae19
refactor(reminders): one rule for when an invoice gets a reminder
codebyarne Nov 15, 2026
d354c0c
fix(updates): the Mac app keeps its version when a new one needs a ne…
codebyarne Nov 13, 2026
afbd094
refactor(updates): one label helper, NeedsNewerMacOS, explicit check …
codebyarne Nov 13, 2026
5e5a266
feat(workflow): /regie, one session that steers several milestones
codebyarne Nov 15, 2026
99f29bd
feat(expenses): on a phone a new expense starts with the camera (#188)
codebyarne Nov 15, 2026
53c28fc
docs(hulp): an expense with the camera on your phone (#188)
codebyarne Nov 15, 2026
0db0e0e
fix(expenses): Opnieuw only replaces a phone photo, never in the desk…
codebyarne Nov 15, 2026
9440a88
style(expenses): a smaller photo, so the amount shows above the bar (…
codebyarne Nov 15, 2026
4ee51de
fix(expenses): a refused photo keeps its reason on the ordinary form …
codebyarne Nov 15, 2026
dc4a5e0
fix(expenses): the receipt on a new expense is no longer called optional
codebyarne Nov 15, 2026
879f9ef
chore(i18n): the camera's texts in English (#188)
codebyarne Nov 15, 2026
27ad9ad
feat(numbering): set the next sequence number by hand until Huismus i…
codebyarne Nov 15, 2026
d86200e
feat(settings): the next invoice and quote number on Facturen en numm…
codebyarne Nov 15, 2026
5a3c594
docs: the next number by hand in SPEC and the help (#141)
codebyarne Nov 15, 2026
8f45b86
refactor(numbering): say why unchanged is skipped and what source mea…
codebyarne Nov 15, 2026
7a5ecd7
merge: bring huisstijl up to date with main (payment reminders, camer…
codebyarne Nov 15, 2026
895455a
fix(documents): an overdue invoice says how late it is once, in its pill
codebyarne Nov 15, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 26 additions & 1 deletion .claude/skills/mijlpaal/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,31 @@ Eén onderwerp, van plan tot release. Je werkt door tot het af is of tot
iets op de **escalatielijst** (`CLAUDE.md`, "Autonoom werken") staat. Een
productvraag of een design gaat naar de `product-owner`-agent, niet naar de eigenaar.

## Onder regie

Staat in je opdracht de regel `Regie: ja`, dan heeft `/regie` je gestart
(`.claude/skills/regie/`). Er lopen dan andere mijlpalen naast je, en de
eigenaar praat met de regie, niet met jou. Alles hieronder blijft gelden, met
deze verschillen:

- **Rapport.** Houd je stand bij in
`"$(git rev-parse --path-format=absolute --git-common-dir)/regie/<issue>.md"`,
met de eerste regel en de standen die `/regie` beschrijft (`BEZIG`, `VRAAG`,
`FLOW`, `KLAAR`, `VAST`). Werk het bij als je stand verandert, en zet die eerste
regel ook bovenaan je laatste bericht van elke beurt. Screenshots voor de
eigenaar kopieer je naar `regie/<issue>/` ernaast.
- **Vragen aan de eigenaar (stap 9 en "Flow voorleggen")**: geen AskUserQuestion
en geen SendUserFile. Zet de vraag of de flow in je rapport, stand `VRAAG` of
`FLOW`, ga door met wat er niet van afhangt, en rond je beurt af. Het antwoord
komt via de regie, als bericht in deze sessie.
- **Geen release (stap 7).** Mergen wel, zoals altijd. De release doet de regie.
- **Melden (stap 8)**: geen pushmelding aan de eigenaar. Stand `KLAAR` in je
rapport, met wat de gebruiker merkt en de PO-besluiten. De regel in
`huismus-intern/STATUS.md` blijft.
- **Geen opvolger (stap 10).** De regie kiest het volgende werk.
- **Botsing.** Merk je dat een andere lopende mijlpaal hetzelfde scherm of een
migratie raakt: stand `VAST`, met welk issue en waarom.

## 1. Begin

- Eigen worktree en branch vanaf de nieuwste `origin/main` (`CLAUDE.md`,
Expand Down Expand Up @@ -150,7 +175,7 @@ sessie, maar geef het door aan een nieuwe:
later nog een keer wakker wordt.

Zonder `create_session` (een lokale sessie): noem het volgende onderwerp in
je melding en start niets.
je melding en start niets. Onder regie sla je deze stap over (zie "Onder regie").

Wacht je onderwerp op de eigenaar (stap 9) en hangt het volgende er niet van af, dan
mag je de opvolger al starten: geef je issue eerst het label `wacht`, zodat de
Expand Down
161 changes: 161 additions & 0 deletions .claude/skills/regie/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,161 @@
---
name: regie
description: Stuurt een paar mijlpalen van Huismus tegelijk aan vanuit één gesprek met de eigenaar. Start per issue uit de wachtrij een lokale sessie met /mijlpaal, ontvangt hun rapporten en bundelt status, vragen en screenshots voor de eigenaar. Gebruik als de eigenaar zegt "/regie", "regie", "werk de wachtrij af" of "doe meerdere dingen tegelijk".
---

# /regie [aantal]

Jij bent de regie. De eigenaar praat alleen met jou, vaak vanaf de telefoon
(Remote Control). Jij bouwt zelf niets: elke mijlpaal draait in een eigen lokale
sessie met `/mijlpaal`, in een eigen worktree. Jij houdt het overzicht, geeft
vragen door en start het volgende werk.

`aantal` is hoeveel mijlpalen er tegelijk lopen. Standaard 3. Meer geeft vooral
botsingen (vertaalbestanden, migratienummers, hetzelfde scherm).

Houd je eigen gesprek dun: lees geen code, geen diffs en geen lange logs. Alles
wat je nodig hebt, staat in de rapporten, op het bord en in de PR-status. Een
volle regie wordt traag, en dan stuurt niemand meer.

## Het rapport van een mijlpaal

Elke sessie die jij start, schrijft haar stand in één bestand per issue:

```
"$(git rev-parse --path-format=absolute --git-common-dir)/regie/<issue>.md"
```

Dat is de map `.git/regie/` van de hoofdmap, die alle worktrees delen. Git volgt
hem nooit, dus er komt niets van in een commit. Screenshots staan ernaast, in
`regie/<issue>/`. Het bestand begint met één regel:

```
#<issue> <STAND>: <één zin in producttaal>
```

`STAND` is een van:

- `BEZIG`: loopt, niets nodig.
- `VRAAG`: wacht op de eigenaar. Daaronder de vraag, het advies en wat de
sessie intussen doet.
- `FLOW`: een grote wijziging met UI wacht op goedkeuring (`CLAUDE.md`, "Flow
voorleggen"). Daaronder de stappen, elk met één zin en de paden van de
screenshots (telefoon en desktop).
- `KLAAR`: gemerged naar `main`. Daaronder wat de gebruiker merkt en de
besluiten van de PO-agent.
- `VAST`: komt niet verder zonder hulp (poort blijft rood, conflict, iets
buiten de code). Daaronder wat er mis is.

Dezelfde eerste regel staat bovenaan het laatste bericht van die sessie, zodat
hij ook in de korte melding past die jij van de app krijgt (die wordt na
400 tekens afgekapt). Het bestand is de bron; de melding is de wekker.

## 1. Begin

1. Zet Remote Control voor jezelf aan (`set_remote_control`, `self`), als hij
nog niet aanstaat.
2. Lees wat er al loopt:
- de map `.git/regie/` (rapporten van eerdere rondes, ook van een vorige
regie);
- je gekoppelde sessies (`list_sessions` met `linked: true`);
- de open PR's (`gh pr list`);
- het bord: wat op `In Progress` staat.
Een issue met een rapport dat niet `KLAAR` is, telt als lopend. Hoort het bij
een sessie die niet aan jou gekoppeld is (een vorige regie), dan meldt die
niet aan jou. Lees zijn rapport dan zelf bij elke ronde.
3. Stop zonder iets te starten als er een open issue met het label `pauze` is
(`CLAUDE.md`, "Backlog: GitHub Issues"). Meld wat er nog loopt.

## 2. Kiezen

Neem van boven naar beneden van het bord, tot er `aantal` lopen:

```
gh project item-list 1 --owner codebyarne --limit 500 --format json --jq '[.items[] | select(.content.type == "Issue" and .status == "Todo" and ((.labels // []) | any(. == "wacht" or . == "idee" or . == "pauze") | not))][0:10][] | "#\(.content.number) \(.title)"'
```

Sla een issue over (het blijft staan, voor de volgende ronde) als het:

- hetzelfde scherm, dezelfde template of view raakt als iets wat al loopt;
- een migratie nodig heeft terwijl een andere lopende mijlpaal er ook een maakt;
- afhangt van een issue dat nog loopt.

Twijfel je, laat het dan wachten. Na elkaar is trager, maar botsen kost meer.
Een release-PR (`chore(release)`) telt niet als mijlpaal en loopt nooit naast
een andere release.

## 3. Starten

Per gekozen issue één sessie met `start_session`:

- `initiation` `user_asked` (de eigenaar vroeg om `/regie`), `context` `fresh`,
`use_worktree` true, `target` `local`;
- `name` `m-<issue>`, `title` `Mijlpaal #<issue>: <titel>`;
- `permission_mode` gelijk aan die van jou (laat weg om te erven);
- `prompt`, precies zo:

```
/mijlpaal #<issue> <titel>
Regie: ja
```

- `background`: dat deze sessie door de regie is gestart, dat er andere
mijlpalen naast lopen (noem hun issues en schermen), en dat ze rapporteert
zoals `/mijlpaal` onder "Onder regie" zegt.

Kijk daarna met `get_session` of de nieuwe sessie Remote Control heeft
(`remoteControlState`). Staat hij uit, zet hem dan aan met `set_remote_control`,
zodat de eigenaar er ook vanaf de telefoon in kan.

## 4. Elke ronde

Je wordt wakker als een sessie een beurt afrondt (een `<side-sessions-event>`)
of als de eigenaar iets zegt. Lees dan de rapporten die veranderd zijn en doe
per stand:

- `BEZIG`: niets. Niet melden, niet porren.
- `VRAAG`: geef de vraag door aan de eigenaar, met het advies van de sessie
als eerste optie. Bundel vragen die tegelijk binnenkomen in één bericht,
maar elke vraag apart en met het issue erbij. Antwoordt de eigenaar, stuur
het antwoord dan met `SendMessage` naar die sessie (`to` is haar
`local_…`-id), met de woorden van de eigenaar letterlijk erbij.
- `FLOW`: stuur de screenshots op volgorde met `SendUserFile`, elk met de zin
uit het rapport, en vraag of het zo live mag. Goedgekeurd of niet: geef het
letterlijk door aan de sessie.
- `KLAAR`: controleer met `gh pr view` dat de PR echt gemerged is. Zo ja: meld
het in één zin en vul de vrije plek met het volgende issue (stap 2 en 3).
Een rapport is een bewering, geen bewijs.
- `VAST`: meld het in producttaal, met wat de sessie probeerde en jouw advies.
Los het niet zelf op in de code.

Sluit elke ronde af met een kort overzicht, één regel per mijlpaal:

```
#201 Bon bij uitgave · BEZIG · bouwt de browsertest
#204 Btw-rapport per kwartaal · VRAAG · zie hierboven
#207 Importeren uit e-Boekhouden · KLAAR · staat op main
```

Een vraag die alleen de PO-agent hoeft te beantwoorden, komt niet bij jou: die
handelt de sessie zelf af. Krijg je er toch een, stuur hem terug met "vraag de
`product-owner`-agent".

## 5. Releases

Mijlpalen onder regie maken geen release. Dat doet de regie, volgens `CLAUDE.md`,
"Releases": op woensdag, als er die week iets anders dan documentatie op `main`
kwam en CI op `main` groen is. Start daarvoor één sessie (`name` `release`,
`prompt` met de release-stappen uit `docs/desktop.md`, "Een release maken"), op
een moment dat geen andere sessie aan het mergen is. Meld de eigenaar welke
versie klaarstaat en wat erin zit, in gewone taal.

## 6. Stoppen en overdragen

- Een `pauze`-issue of een lege wachtrij: start niets nieuws, laat lopende
mijlpalen afmaken, en meld wanneer de laatste klaar is.
- Na een stuk of tien mijlpalen, of als je merkt dat je traag wordt: zeg tegen
de eigenaar dat een verse `/regie` kan beginnen. De rapporten in
`.git/regie/` nemen het over. Sessies van jou blijven aan jou melden, dus de
nieuwe regie leest hun rapport zelf (stap 1).
- Een `KLAAR`-sessie mag weg. Vraag de eigenaar of je ze mag archiveren
(`archive_session`), en doe het pas na een ja.
9 changes: 9 additions & 0 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -353,6 +353,15 @@ een sessie traag. Na het melden start `/mijlpaal` zelf een nieuwe cloudsessie
voor het volgende issue uit de wachtrij (zie "Backlog"; stap 10 van de skill).
Een open issue met het label `pauze` of een lege wachtrij stopt de keten.

**Meer tegelijk: `/regie`.** Wil de eigenaar meerdere mijlpalen tegelijk en één
gesprek voor het overzicht, dan begint die met `/regie` (`.claude/skills/regie/`) in een
lokale sessie. De regie start per issue uit de wachtrij een lokale sessie met
`/mijlpaal` (standaard drie tegelijk, nooit twee op hetzelfde scherm), krijgt hun
rapporten, en bundelt status, vragen en screenshots voor de eigenaar. Mijlpalen
onder regie starten geen opvolger en maken geen release; dat doet de regie.
Lokaal, omdat cloudsessies niet terugmelden. Nieuwe sessies op de Mac van de
eigenaar staan standaard op Remote Control, zodat het ook vanaf de telefoon gaat.

**Escalatielijst.** Alleen dit vraag je aan de eigenaar zelf, in producttaal en met
een advies:

Expand Down
Loading
Loading