Scrum4Me/docs/INDEX.md
Janpeter Visser 3a61a8ddc1
Landing v3: van idee tot pull request + 6 nieuwe screenshots (#127)
* feat(landing): tour uitbreiden naar 6 screenshots incl. Ideas/Insights

Vervangt de oude 3 .jpg-screenshots door 6 nieuwe .png's met de huidige
visuele staat van de app. Volgorde toont de hele flow: ideeën binnen →
producten → backlog → sprint → solo → insights.

- Tour-array van 3 naar 6 figures, grid blijft lg:grid-cols-3 (2x2-rijen)
- Intro-tekst aangepast: "Zes weergaven van Scrum4Me — van inkomende
  ideeën tot persoonlijk Kanban-bord en voortgangs-inzichten"
- Bestandsnamen gehernoemd naar lowercase-dash-conventie:
  Sprint.png → sprint.png, Solo.png → solo.png, "Product Backlog.png" →
  product-backlog.png, Producten.png → producten.png, Insights.png →
  insights.png, Ideas-table.png → ideas-table.png,
  Ideas-detail.png → ideas-detail.png (alleen voorbereiding, nog niet in
  tour gebruikt)
- Oude .jpg-bestanden verwijderd

Niet onderdeel: hero/architectuur/handleiding-rewrite voor v3 — die staan
gepland onder ST-1224 en blijven open.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(landing): v3 — van idee tot pull request, met procesflow + Idea-laag

Verbreedt de landing-propositie van "executie lokaal" (v2) naar de
volledige cyclus idee → grill → plan → execute → PR. Eert M12 Ideas dat
sinds 2026-05-04 het kernconcept van het product is, plus auto-PR en
Sync-tab.

Hero:
- H1 "Van idee tot pull request — op je eigen hardware."
- Subhead benoemt grill→plan→materialise→agent→PR-cyclus en houdt het
  lokaal-anker uit v2 vast.

Nieuw §3 "Van idee tot pull request":
- 4 procesflow-kaarten (Idee/Grill/Plan/Execute) met status-chips
  (DRAFT/GRILLING/PLAN_READY/DONE→PR) en pijlen tussen kaarten op md+.
- Samenvattende paragraaf over state-machine, materializeIdeaPlanAction
  en auto-PR.

Architectuur:
- docs/diagrams/architecture.mmd Worker-label uitgebreid met
  "jobs: GRILL · PLAN · IMPL"; beide SVG's geregenereerd.
- Callout "Lokale worker" benoemt nu de drie jobsoorten expliciet.

Feature-grid (set D, 6 kaarten):
- Vervang "Hiërarchisch plannen" door "Ideas — Grill & Plan" op positie 1.
- Lokale Claude-agents: + auto-PR/SQUASH-merge zin.
- Realtime updates: + Sync-tab zin.
- Async vraagkanaal: + Grill-vragen zin.

Quickstart:
- Extra regel over UI-route (/ideas → Nieuw idee → Grill me) onder de
  bestaande MCP-installatie code-block.

Scrum-samenvatting:
- Hiërarchie wordt twee-rij-systeem: Idea (DRAFT → GRILLED → PLAN_READY)
  als bovenste rij, daaronder Product → PBI → Story → Taak met
  "materialiseert ↓"-pijl.
- Terminologie krijgt 2 nieuwe tegels (Idea, Grill/Plan).

Handleiding (10 → 12 stappen):
- Nieuwe stappen 3-5 voor Idea-route (vastleggen, grillen, plan + materialiseren),
  visueel gemarkeerd met tertiary-border en chip "Idea-route".
- Oude 7+8 (token + MCP-koppeling) samengevoegd tot stap 10.
- Stap 11 uitgebreid met Sync-tab-volgen.
- Stap 6 hernoemd "opbouwen" → "finetunen".

Plan-doc + grilling-context vastgelegd in docs/plans/landing-v3-idea-flow.md.

Tracked: ST-1224 onder PBI Marketing & Landingspagina.

Verified: lint 0 errors / 7 warnings (alle pre-existing), 564/564 tests,
productie-build slaagt.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-06 09:05:22 +02:00

9.7 KiB

Documentation Index

Auto-generated on 2026-05-06 from front-matter and headings.

Architecture Decision Records

# Title Status
0000 ADR-0000: Record architecture decisions accepted
0001 ADR-0001: Use @base-ui/react instead of Radix UI accepted
0002 ADR-0002: Use float sort_order for drag-and-drop ordering accepted
0003 ADR-0003: One branch per milestone, push only after user test accepted
0004 ADR-0004: DB enums UPPER_SNAKE, API enums lowercase, mapped exclusively via lib/task-status.ts accepted
0005 ADR-0005: Use iron-session for authentication instead of NextAuth/Clerk/Supabase Auth accepted
0006 ADR-0006: Demo-user write protection enforced in three layers accepted
0007 ADR-0007: Agent ↔ user question channel via persistent table + LISTEN/NOTIFY accepted
0008 ADR-0008: Agent instructions in CLAUDE.md + topical runbooks accepted
0010 ADR-0010: Eén product = één repo; cross-product planning vereist (later) een Initiative-laag accepted

Specifications

Title Status Updated
AnswerModal Profiel active 2026-05-04
BatchEnqueueBlockerDialog Profiel active 2026-05-04
IdeaDialog Profiel active 2026-05-04
PbiDialog Profiel active 2026-05-04
ProductDialog Profiel active 2026-05-04
Sprint Dialogs Profiel active 2026-05-04
StoryDialog Profiel active 2026-05-04
TaskDetailDialog Profiel active 2026-05-04
TaskDialog Profiel active 2026-05-03
Scrum4Me — Functionele Specificatie active 2026-05-04
DevPlanner — User Personas active 2026-05-03

Plans

Title Status Updated
Plan — Auto-PR + selectieve deploy-controle + sync-zicht (end-to-end batch flow)
Docs-restructuur — geoptimaliseerd voor AI-lookup proposal 2026-05-02
PBI Bulk-Create Spec — Docs-Restructure for AI-Optimized Lookup done 2026-05-03
Landing v2 — lokaal & veilig + architectuurdiagram active 2026-05-03
Landing v3 — van idee tot pull request active 2026-05-04
M10 — Password-loze inlog via QR-pairing active 2026-05-03
M11 — Claude vraagt, gebruiker antwoordt active 2026-05-03
M12 — Idea entity + Grill/Plan Claude jobs planned
M9 — Actief Product Backlog active 2026-05-03
PBI-11 — Mobile-shell met landscape-lock (settings + backlog + solo)
ST-1109 — PBI krijgt een status (Ready / Blocked / Done) active 2026-05-03
ST-1110 — Demo gebruiker read-only active 2026-05-03
ST-1111 — Voer uit-knop met Claude Code job queue active 2026-05-03
ST-1114 — Copilot reviews op dashboard active 2026-05-03
Tweede Claude Agent — Planning Agent proposal 2026-05-03
Scrum4Me — v1.0 readiness active 2026-05-04

Archive

Title Updated
CLAUDE.md workflow-update na M7 + ST-509/511/512/513 2026-05-03
Herbruikbaar scripts/insert-milestone.ts 2026-05-03
Realtime updates voor Solo Paneel (M8) 2026-05-03

Patterns

Title Status Updated
Bidirectionele async-comms MCP-agent ↔ user active 2026-05-03
Entity Dialog active 2026-05-03
iron-session active 2026-05-03
Prisma Client singleton active 2026-05-03
Proxy (route protection) active 2026-05-03
QR-pairing via unauth-SSE + pre-auth cookie active 2026-05-03
Realtime NOTIFY payload — veldnaam-contract active 2026-05-03
Route Handler (REST API) active 2026-05-03
Server Action active 2026-05-03
Float sort_order (drag-and-drop volgorde) active 2026-05-03
Story met UI-component active 2026-05-03
Zustand optimistische update + rollback active 2026-05-03

Other Docs

Title Path Status Updated
Scrum4Me REST API api.md active 2026-05-03
Scrum4Me REST API api/rest-contract.md active 2026-05-03
Scrum4Me — Technische Architectuur (breadcrumb) architecture.md active 2026-05-03
Authentication, Sessions & Demo Policy architecture/auth-and-sessions.md active 2026-05-03
Claude ↔ User Question Channel architecture/claude-question-channel.md active 2026-05-03
Data Model & Prisma Schema architecture/data-model.md active 2026-05-03
Scrum4Me — Architecture Overview architecture/overview.md active 2026-05-03
Project Structure, Stores, Realtime & Job Queue architecture/project-structure.md active 2026-05-03
QR-pairing Login Flow architecture/qr-pairing.md active 2026-05-03
Scrum4Me — Implementatie Backlog backlog.md active 2026-05-03
Scrum4Me — Implementatie Backlog backlog/index.md active 2026-05-03
DevPlanner — Product Backlog backlog/product-historical.md active 2026-05-03
Agent Instruction Audit decisions/agent-instructions-history.md active 2026-05-03
Scrum4Me — Styling & Design System design/styling.md active 2026-05-03
Docker smoke test — task 1 docker-smoke/2-mei-task-1.md done 2026-05-03
Docker smoke test — task 2 docker-smoke/2-mei-task-2.md done 2026-05-03
Scrum4Me — Functionele Specificatie functional.md active 2026-05-03
Scrum4Me — Glossary glossary.md active 2026-05-03
Scrum4Me — Styling & Design System md3-color-scheme.md active 2026-05-03
Obsidian as Personal Authoring Layer obsidian-authoring.md active 2026-05-02
PbiDialog Profiel pbi-dialog.md active 2026-05-03
DevPlanner — User Personas personas.md active 2026-05-03
DevPlanner — Product Backlog product-backlog.md active 2026-05-03
Scrum4Me — API Test Plan qa/api-test-plan.md active 2026-05-03
Realtime smoke-checklist — PBI / Story / Task realtime-smoke.md active 2026-05-03
Agent-flow: open issues & decision log runbooks/agent-flow-pitfalls.md active 2026-05-03
Auto-PR flow: van story-DONE naar gemergde PR runbooks/auto-pr-flow.md active 2026-05-06
Branch, PR & Commit Strategy runbooks/branch-and-commit.md active 2026-05-03
Deploy-controle: triggers, labels, path-filter runbooks/deploy-control.md active 2026-05-05
Vercel Deployment runbooks/deploy-vercel.md active 2026-05-03
MCP Integration — Scrum4Me Tools runbooks/mcp-integration.md active 2026-05-03
v1.0 Smoke Test Checklist runbooks/v1-smoke-test.md active 2026-05-04
Worker idempotency & job-status protocol runbooks/worker-idempotency.md active 2026-05-05
StoryDialog Profiel story-dialog.md active 2026-05-03
TaskDialog Profiel task-dialog.md active 2026-05-03
Scrum4Me — API Test Plan test-plan.md active 2026-05-03