Scrum4Me

Van idee tot zichtbaar resultaat.

Scrum4Me zet productideeën om in een verifieerbare projectpipeline. Ideeën worden plannen, taken, agent-runs, tests, commits en pull requests, binnen de standaarden en richtlijnen die je per project vastlegt.

Demo-login: gebruikersnaam demo · wachtwoord demo1234

Gratis tijdens de beta · desktop-first (1024px+)

Beta-versie

Scrum4Me is nog in actieve ontwikkeling. Accounts en ingevoerde gegevens kunnen tijdens deze fase worden aangepast, gereset of verwijderd.

Van idee naar product binnen jouw projectstandaarden

Een korte, zichtbare pipeline: intentie wordt vastgelegd in Scrum4Me, aangescherpt tot gestructureerd werk, uitgevoerd door agents en geverifieerd voordat het productresultaat wordt.

1
Idee
DRAFT

Leg productintentie vast in een compact idee. Dit is de eerste traceerbare input.

2
Grill + Plan
PLAN_READY

Claude bevraagt het idee kritisch en schrijft een gestructureerd plan voor PBI, stories en taken.

3
Queue
QUEUED

Goedgekeurd werk wordt gematerialiseerd naar Scrum-data en in de jobqueue gezet.

4
Uitvoering
RUNNING

De Docker-runner claimt de job, start Claude Code en rapporteert voortgang terug.

5
Resultaat
DONE

Verificatie, commits, pull requests en statuslogs maken het resultaat inspecteerbaar.

State-machine: DRAFT -> GRILLING -> GRILLED -> PLANNING -> PLAN_READY -> PLANNED. Bij materialiseren ontstaat in één atomaire transactie precies één PBI met N stories en M taken uit het YAML-plan. Daarna neemt de delivery-flow over: queue, claim, worktree, verificatie, status-log en pull request blijven traceerbaar.

Ecosysteem - vijf repos, één delivery-flow

Scrum4Me is de planning-app, maar de execution-kant is bewust gesplitst: workers-beheer, MCP-tools, Docker-runtime en gedeelde schema/logica hebben elk een eigen grens. Postgres is de queue en signaleringslaag; je code blijft in git en in tijdelijke worktrees.

Scrum4Me-platform: Scrum4Me-web, scrum4me-workers, Neon Postgres, scrum4me-mcp, scrum4me-docker, Claude Code, Forgejo en scrum4me-shared.

Wat draait waar?

Scrum4Me

Planning-app voor producten, PBIs, stories, taken, sprints, ideas, product-docs en het vraagkanaal. Dit is waar het productwerk wordt voorbereid en gevolgd.

scrum4me-workers

Admin-only execution UI op scrum4me-workers.jp-visser.nl: jobs queue, worker registry, API-tokens, jobconfig en repo-access. Hier beheer je de uitvoeringslaag.

scrum4me-mcp

Tool- en claimlaag. MCP claimt jobs atomisch, levert context en prompts, ontvangt logs/statussen, stelt vragen aan de gebruiker en bewaakt verificatie.

scrum4me-docker

Headless Docker-runner op NAS, server of laptop. De daemon maakt worktrees, start precies één Claude Code invocation per job en bewaart runtime-logs.

scrum4me-shared

Gedeelde kernel via git-submodule: canonical Prisma schema, status-mappings, job-config en realtime payload types. Schemawijzigingen starten hier.

Forgejo / git-provider

Broncode, branches en pull requests blijven in je eigen git-omgeving. Scrum4Me bewaart metadata, logs, commit-hashes en PR-links, geen volledige source tree.

Workflow - van planning naar verifieerbare uitvoering

De knop "Voer uit" start geen verborgen magie. Het is een expliciete jobflow met een database-queue, lease/claim-logica, een geïsoleerde worktree en realtime statusupdates in beide UIs.

1

Planning schrijft een ClaudeJob

Scrum4Me-web zet werk vanuit een story, sprint of idea als QUEUED-job in Postgres en verstuurt een NOTIFY-event.

2

MCP claimt en levert context

scrum4me-mcp claimt de job atomisch, laadt product-docs, taskplan, repo-config, prompt en allowed tools.

3

Docker-runner start Claude Code

scrum4me-docker maakt of hergebruikt een worktree en start een Claude Code invocation voor precies deze job.

4

Agent logt via MCP-tools

Claude schrijft implementatielogs, testresultaten, vragen en statusovergangen terug via de MCP-tooling.

5

Git en PR-flow blijven extern

De runner werkt in de git-provider met branches en PRs. Scrum4Me bewaart alleen de trace: status, logs, commit-hashes en links.

6

Realtime zicht in beide apps

Postgres LISTEN/NOTIFY voedt SSE, zodat Scrum4Me-web en scrum4me-workers dezelfde jobstatus zien zonder refresh.

Waar beheer je wat?

Product, backlog, sprint of idea aanpassenScrum4Me
Product-docs, grill- en plan-documenten bekijkenScrum4Me
Jobqueue bekijken of job cancellen/restartenscrum4me-workers
Worker online/offline status zienscrum4me-workers
API-token maken of intrekkenscrum4me-workers.jp-visser.nl/api-tokens
Runner starten op NAS/serverscrum4me-docker
MCP tools aanpassenscrum4me-mcp
Schema/status/job-config wijzigenscrum4me-shared eerst, daarna consumer bumps

Bekijk Scrum4Me in actie

Zes weergaven van de planning-kant, van inkomende ideeën tot persoonlijk Kanban-bord en voortgangs-inzichten. De execution-kant leeft in de workers-app; deze screenshots tonen waar het werk ontstaat en gevolgd wordt.

Ideas-dashboard met idee-kaarten in DRAFT/GRILLED/PLAN_READY-statussen
Ideas-dashboard

Persoonlijk overzicht van je ideeën met status (DRAFT -> GRILLED -> PLAN_READY -> PLANNED). Klik "Grill me" of "Make plan" om een lokale agent te starten; bij materialiseren ontstaat exact één PBI met stories en taken.

Producten-dashboard met overzicht van actieve projecten
Producten

Eén overzicht van alle producten waar je toegang toe hebt: eigen producten plus die waar je als developer bent toegevoegd. Vanaf hier spring je naar Backlog, Sprint of Solo.

Product Backlog met PBIs gegroepeerd op prioriteit en stories per PBI
Product Backlog

PBIs gegroepeerd op prioriteit (Kritiek -> Laag) in het linkerpaneel. Klik op een PBI om de stories rechts te zien, gerangschikt per urgentie en versleepbaar.

Sprint Board met drie panelen: Product Backlog, Sprint Backlog en Taken
Sprint Board

Drie panelen op één scherm: Product Backlog links, Sprint Backlog in het midden, taken van de geselecteerde story rechts. Stories slepen tussen panelen werkt via dnd-kit.

Solo Paneel, persoonlijk Kanban-bord met drie statuskolommen
Solo Paneel

Persoonlijk Kanban-bord per product. Toont alleen taken van stories die jij hebt geclaimd, in drie kolommen (To Do, Bezig, Klaar). Drag-and-drop tussen kolommen verandert de status.

Insights-dashboard met voortgangsmetrics en agent-throughput
Insights

Voortgang per product: doorlooptijden, agent-throughput en sprintresultaten in één blik. Helpt patronen herkennen: welke stories liepen vast, welke gingen vlot.

Wat is Scrum4Me?

Scrum4Me is een desktop-first webapplicatie die Scrum lichtgewicht maakt zonder de overhead van grote tools als Jira of Linear. Ontworpen voor developers die zelf de regie willen houden over planning en uitvoering.

Ideas - Grill & Plan

Leg een idee vast in twee zinnen. Claude grilt het met kritische vragen, schrijft een YAML-plan en zet het om in PBI + stories + tasks. Alles via een job-queue, asynchroon.

Sprint Board + Solo Paneel

Twee weergaven van dezelfde data: een team-bord (Product Backlog · Sprint Backlog · taken) en een persoonlijk Kanban met geclaimde stories.

Lokale Claude-agents

Een job-queue met "Voer uit"-knop. scrum4me-docker claimt via scrum4me-mcp, draait Claude Code in een worktree en rapporteert status terug. Meerdere workers parallel veilig.

Realtime updates

SSE bovenop Postgres LISTEN/NOTIFY. Wijzigingen vanuit andere tabs, workers-app of runner verschijnen binnen 1-2 seconden in je Solo Paneel, geen refresh.

Async vraagkanaal

Loopt een agent vast op een keuze? Hij plaatst een vraag via het bel-icoon. Jij beantwoordt hem wanneer het uitkomt; de agent pakt automatisch de draad weer op. Tijdens een Grill stelt Claude vragen via hetzelfde kanaal.

Workers-app als execution console

Jobs, workers, API-tokens en repo-access horen bij scrum4me-workers.jp-visser.nl. Scrum4Me blijft de planning-UI; workers is de operationele cockpit.

Quickstart - runner of lokale MCP-dev

De normale route loopt via de headless Docker-runner. Voor lokaal ontwikkelwerk kun je de MCP-server rechtstreeks aan Claude Code koppelen.

Pad A - normale runner

  1. Maak een implementation-token in scrum4me-workers.jp-visser.nl/api-tokens.
  2. Zet token, Claude OAuth-token en git-credentials in de runner-env.
  3. Start scrum4me-docker op NAS, server of laptop.
  4. Controleer de heartbeat in scrum4me-workers.jp-visser.nl/workers.
  5. Klik in Scrum4Me op "Voer uit".

Pad B - lokale MCP-dev

git clone https://git.jp-visser.nl/janpeter/scrum4me-mcp.git
cd scrum4me-mcp && npm install

# Voeg toe aan Claude Code config
# en gebruik de Scrum4Me MCP-tools direct.

Handig voor toolontwikkeling, product-doc retrieval en lokale inspectie. De productie-runner blijft de aanbevolen route voor echte jobuitvoering.

Liever zonder MCP? Gebruik de REST API met een Bearer-token voor scripts, CI-pipelines en gecontroleerde integraties.

Scrum in Scrum4Me

Scrum4Me past een lichtgewicht versie van Scrum toe: de essentie zonder ceremony-overhead. Hieronder staat hoe de kernbegrippen zijn vertaald naar de app.

Hiërarchie

Idea
DRAFT - GRILLED - PLAN_READY
materialiseert naar
Product
Een softwareproject of codebase
PBI
Product Backlog Item, een feature of verbetering
Story
Concrete user story binnen een PBI
Taak
Implementatiestap binnen een story

Terminologie

Idea
Een voorstel of richting voordat het een PBI is. Heeft een grill-fase, waarin Claude het kritisch bevraagt, en een plan-fase, waarin Claude YAML schrijft met stories en tasks.
Grill / Plan
Twee asynchrone Claude-jobsoorten op een idea. Grill produceert grill_md. Plan produceert plan_md, een strikt geparseerd YAML-plan met PBI, stories en task-templates.
Product Backlog
Geordende lijst van alle PBIs per product, gesorteerd op prioriteit en positie.
Sprint
Actief tijdblok met een Sprint Goal. Per product is er maximaal één actieve Sprint tegelijk.
Sprint Backlog
De stories die voor deze Sprint zijn geselecteerd. Stories worden vanuit de Product Backlog gesleept.
Sprint Board
Drie-panelen scherm op één view: Product Backlog, Sprint Backlog en taken per geselecteerde story.
Solo Paneel
Persoonlijk Kanban-bord per product. Toont taken van geclaimde stories in To Do, Bezig en Klaar.
Story-claim
Een developer claimt een story uit de Sprint en wordt assignee. Pull-systeem, niet gepusht door een Scrum Master.
Story-status
OPEN -> IN_SPRINT -> DONE. Bepaalt zichtbaarheid in backlogs en Sprint-schermen.
Taakstatus
TO_DO -> IN_PROGRESS -> DONE. Wordt bijgehouden via UI of REST API door Claude Code.
Activiteitenlog
Per story worden implementatieplan, testresultaat en commit vastgelegd via de API of UI.
Sprint afronden
Bij afsluiting wordt per story gekozen: markeer als Done of zet terug naar de Product Backlog.

Rollen

Product Owner
Bepaalt prioriteit van PBIs en beheert de Product Backlog.
Scrum Master
Bewaakt het Scrum-proces en verwijdert obstakels.
Developer
Voert stories en taken uit via UI of Claude Code.

In v1 is één account gelijk aan één gebruiker met alle rollen. Teamgebruik met rolscheiding volgt in v2.

Gebruikershandleiding

Volg deze stappen om van een leeg account naar een volledig ingeplande Sprint te gaan.

1
Account aanmaken
Ga naar Registreren en kies een gebruikersnaam en wachtwoord. Na registratie word je direct doorgestuurd naar het dashboard. Liever passwordless? Paar je telefoon één keer en log voortaan in via QR. Of test eerst met de demo-account.
2
Product aanmaken
Klik op "Nieuw product" op het dashboard. Vul naam, optionele beschrijving, repo-URL en je Definition of Done in. Het product wordt zichtbaar op het dashboard.
3
Een idee vastleggenIdea-route
Open /ideas, klik "Nieuw idee", vul titel + één-alinea beschrijving in. Status: DRAFT.
4
Laat Claude grillenIdea-route
Klik "Grill me". Een lokale agent stelt kritische vragen via het belicoon. Beantwoord ze; Claude schrijft een gestructureerde grill_md. Status: GRILLED.
5
Maak het plan + materialiseerIdea-route
Klik "Make plan". Claude genereert een YAML-plan (PBI + stories + tasks). Klik "Materialiseer" om het atomair om te zetten naar je product-backlog. Status: PLANNED.
6
Product Backlog finetunen
Optioneel: herorden PBIs en stories handmatig via drag-and-drop. Het meeste werk heeft materialise al gedaan; dit is alleen voor bijsturen of toevoegen van werk dat niet uit een idee komt.
7
Sprint starten
Klik op "Sprint starten" op de productpagina en voer een Sprint Goal in. Per product is er maximaal één actieve Sprint tegelijk. Het Sprint-scherm wordt zichtbaar via de navigatie.
8
Sprint Board - stories slepen en taken aanmaken
Open het Sprint-scherm. Drie panelen verschijnen op één view: Product Backlog links, Sprint Backlog in het midden, taken rechts. Sleep stories naar de Sprint Backlog en selecteer een story om taken te zien.
9
Solo Paneel - claim stories en werk persoonlijk
Open Solo via de navigatie. Claim openstaande stories uit de actieve Sprint en werk je taken af in drie statuskolommen. Klik op een taak voor detail en implementatieplan.
10
Uitvoeringsruntime koppelen
Maak een implementation-token aan in scrum4me-workers.jp-visser.nl/api-tokens en zet die in de runner-env. De workers-app beheert jobs, workers, tokens en repo-access; Scrum4Me blijft de planning-UI.
11
Voer uit + Sync-tab volgen
Klik op "Voer uit" bij een story in het Solo Paneel. Er ontstaat een ClaudeJob; scrum4me-docker claimt via MCP, werkt in een worktree en schrijft status/logs terug. Volg voortgang in de Sync-tab en scrum4me-workers.jp-visser.nl/jobs.
12
Sprint afronden
Klik op "Sprint afronden" op het Sprint Board. Voor elke story kies je: markeer als Done of zet terug naar de Product Backlog. Daarna is een nieuwe Sprint aanmaakbaar.

REST API voor gecontroleerde integraties

Alle API-endpoints vereisen een Authorization: Bearer <token> header. Implementation-tokens beheer je in scrum4me-workers.jp-visser.nl/api-tokens.

# Volgende story uit de actieve Sprint ophalen
curl -H "Authorization: Bearer $TOKEN" \
  https://<your-instance>/api/products/<product-id>/next-story
GET/api/productsLijst van actieve producten
GET/api/products/:id/next-storyHoogst geprioriteerde open story van de actieve Sprint
GET/api/sprints/:id/tasks?limit=10Eerste N taken van de Sprint op volgorde
PATCH/api/stories/:id/tasks/reorderTaakvolgorde aanpassen (body: { task_ids: string[] })
POST/api/stories/:id/logActiviteit vastleggen: implementatieplan, testresultaat of commit
PATCH/api/tasks/:idTaakstatus of implementatieplan bijwerken