Van idee tot pull request — op je eigen hardware.

Leg een idee vast, laat Claude het kritisch bevragen, accepteer het plan en zet het door een lokale agent uit. Code, executie en agents draaien op je eigen machine; alleen metadata loopt via Vercel + Neon. Idee na idee, automatisch omgezet in commits en pull requests.

Account aanmaken Hoe het werkt

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 tot pull request

Vier stappen, één queue. Een idee groeit uit tot gemergde code zonder dat jij ertussen hoeft.

Idee

DRAFT

Leg een idee vast in twee zinnen. Status: DRAFT.

→

Grill

GRILLING

Claude stelt kritische vragen via het belicoon; je antwoorden vormen de grill_md.

→

Plan

PLAN_READY

Claude schrijft een YAML-plan. Materialiseer en je hebt PBI + stories + tasks.

→

Execute

DONE → PR

Lokale agent claimt de jobs, commit, pusht en opent automatisch een PR.

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. Op de laatste taak van de laatste story pusht de worker automatisch een branch en opent of mergt een pull request — geen handwerk meer tussen plan en deploy.

Architectuur — hoe Scrum4Me draait

Vier componenten in twee zones. De Scrum4Me-stack (Vercel + Neon) houdt alleen metadata bij. Jouw kant (lokale worker + GitHub) houdt de code en de uitvoering. Het enige verkeer over de zonegrens is de job-queue zelf — agents claimen werk en rapporteren status terug.

Wat draait waar?

Vercel

Alleen UI, Server Actions en cron-jobs. Geen sourcecode, geen build-artefacten van klanten — Vercel weet niet hoe jouw code eruit ziet.

Neon Postgres

Scrum-metadata: titels, statussen, plan-tekstvelden, logs en commit-hashes. Geen volledige diffs, geen broncodebestanden. Wat jij of de agent zelf in een plan of log schrijft, staat hier wel.

Lokale worker

Jouw machine — laptop, NAS of VM. Claude Code via stdio-MCP, claimt jobs atomisch (FOR UPDATE SKIP LOCKED), executeert lokaal, commit lokaal, push lokaal. Doet drie soorten jobs: bevragen van een idee (GRILL), plan-generatie (PLAN), taak-implementatie (IMPL) — allemaal op dezelfde machine. Meerdere workers parallel veilig.

GitHub

Jouw eigen repo. Scrum4Me kent alleen de repo_url-string en de commit-hashes uit het story-log. Code en historie blijven onder jouw account.

Bekijk Scrum4Me in actie

Zes weergaven van Scrum4Me — van inkomende ideeën tot persoonlijk Kanban-bord en voortgangs-inzichten. Elke weergave is desktop-first en gebouwd op MD3-tokens en shadcn-componenten.

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 hun planning.

Ideas — Grill & Plan

Leg een idee vast in twee zinnen. Claude grilt het met kritische vragen, schrijft een YAML-plan en zet ’t 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. Lokale Claude Code agents claimen werk atomisch, draaien het op jouw hardware en rapporteren status terug. Na de laatste task pusht de worker automatisch en opent een pull request via SQUASH-merge. Meerdere workers (laptop + NAS) parallel veilig.

Realtime updates

SSE bovenop Postgres LISTEN/NOTIFY. Wijzigingen vanuit andere tabs of een lokale agent verschijnen binnen 1–2 seconden in je Solo Paneel — geen refresh. De Sync-tab toont per idee de live status van story → push → PR-merge.

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 — antwoorden komen direct terug in de Idea-timeline.

Quickstart — lokale agent in 3 stappen

De aanbevolen route: installeer de MCP-server lokaal en laat Claude Code de Scrum4Me-tools native gebruiken.

# 1. Clone en installeer de MCP-server
git clone https://github.com/madhura68/scrum4me-mcp
cd scrum4me-mcp && npm install

# 2. Voeg toe aan Claude Code config (zie repo-README)
# 3. Start Claude Code en vraag:
#    "pak de volgende job uit de Scrum4Me-queue"

Liever in de UI beginnen? Open /ideas, druk op "Nieuw idee" en klik "Grill me" — de eerste vraag verschijnt binnen seconden in je belicoon.

Liever zonder MCP? Gebruik de REST API met een Bearer-token — werkt ook vanuit Codex, eigen scripts of CI-pipelines.

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 ’t een PBI is. Heeft een grill-fase (Claude bevraagt ’t kritisch) en een plan-fase (Claude schrijft een YAML-plan met stories en tasks). Na materialiseren ontstaat exact één PBI.

Grill / Plan

Twee asynchrone Claude-jobsoorten op een idea. Grill produceert grill_md (Q&A-transcript). Plan produceert plan_md (YAML met PBI/stories/tasks-templates) dat strikt geparseerd wordt.

Product Backlog

Geordende lijst van alle PBI's per product, gesorteerd op prioriteit (kritiek → laag) 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. Vervangt het oude losse Sprint Planning-scherm.

Solo Paneel

Persoonlijk Kanban-bord per product. Toont taken van geclaimde stories in drie kolommen (To Do, Bezig, Klaar) — drag-and-drop wijzigt de status.

Story-claim

Een developer claimt een story uit de Sprint en wordt assignee. Pull-systeem (zelf-organisatie) — niet pushed 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 Backlog.

Rollen

Product Owner

Bepaalt prioriteit van PBI's en beheert de Product Backlog.

Scrum Master

Bewaakt het Scrum-proces en verwijdert obstakels.

Developer

Voert stories en taken uit; werkt 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.

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 (alleen leesrechten).

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.

Een idee vastleggenIdea-route

Open /ideas, klik "Nieuw idee", vul titel + één-alinea beschrijving in. Status: DRAFT.

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.

Maak het plan + materialiseerIdea-route

Klik "Make plan". Claude genereert een YAML-plan (PBI + stories + tasks). Klik "Materialiseer" om ’t atomair om te zetten naar je product-backlog. Status: PLANNED.

Product Backlog finetunen

Optioneel: herorden PBI's 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.

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.

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 vanuit links naar het midden om ze in de Sprint te plaatsen. Selecteer een story in het middenpaneel om de taken rechts te tonen en aan te maken.

Solo Paneel — claim stories en werk persoonlijk

Open Solo via de navigatie. Claim openstaande stories uit de actieve Sprint (knop "Toon openstaande stories") en werk je taken af in drie statuskolommen via drag-and-drop. Klik op een taak voor het detail-dialoog met implementatieplan.

Claude Code koppelen

Maak een API-token aan in Instellingen → Tokens — hetzelfde token werkt voor MCP en REST. Aanbevolen: installeer de scrum4me-mcp-server (zie Quickstart hierboven) zodat Claude Code de tools native ziet. Alternatief: gebruik de REST API direct vanuit Codex, eigen scripts of CI-pipelines.

Voer uit + Sync-tab volgen

Klik op "Voer uit" bij een story in het Solo Paneel. De story komt in de job-queue. Een lokale agent claimt de jobs, werkt taken af, commit en — na de laatste task — pusht en mergt automatisch een PR via SQUASH. Volg de voortgang in de Sync-tab op het idea-detail.

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 Claude Code

Alle API-endpoints vereisen een Authorization: Bearer <token> header. Tokens beheer je via Instellingen → Tokens.

# Volgende story uit de actieve Sprint ophalen
curl -H "Authorization: Bearer $TOKEN" \
  https://<jouw-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