Scrum4Me/docs/INDEX.md
Janpeter Visser d292e445d9
Sprint: Verbeteren debug mode (#179)
* feat(PBI-49): add debugProps helper + Vitest test

Adds lib/debug.ts with debugProps(id, component, file) that returns
data-debug-id and data-debug-label attrs in dev mode, empty object in
production. Adds __tests__/lib/debug.test.ts covering both modes.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* docs(PBI-49): add debug-id pattern doc + CLAUDE.md reference

Adds docs/patterns/debug-id.md documenting the named-component boundary
rule (6 punten), helper-voorbeeld, skip-criteria en motivatie voor
handmatige pad-argumenten. Voegt verwijzing toe aan CLAUDE.md
patterns-tabel.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* refactor(PBI-49): migrate 17 shared/ components to debugProps helper

Replace hardcoded data-debug-id + data-debug-label attribute pairs with
{...debugProps(id, component, file)} spread in all 17 components/shared/
files. Existing debug-ids preserved unchanged.

* feat(PBI-49): add debugProps to backlog/, sprint/, solo/ components

* feat(PBI-49): add debugProps to jobs/ + ideas/ components

* feat(PBI-49): add debugProps to products/ + settings/ + notifications/ components

* feat(PBI-49): add debugProps to admin/ + dashboard/ + dialogs/ + mobile/ + split-pane/

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* fix(PBI-49): use attr(data-debug-id) for debug tooltip in globals.css

* refactor(PBI-49): remove data-debug-label from debugProps helper + test

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* refactor(PBI-49): strip unused component/file args from debugProps in shared/

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(PBI-49): add BEM sub-element data-debug-id to StatusBar, NavBar, PanelNavBar

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(PBI-49): add BEM sub-element data-debug-id to components/sprint/*

- new-sprint-dialog: __submit on submit button
- sprint-backlog: __list on SprintBacklogLeft + SprintBacklogRight scroll areas
- sprint-board-client: root wrapper div (display:contents) + __drag-overlay
- sprint-header: __title on goal button, __dates on dates button, __actions on action cluster
- sprint-run-controls: root on controls div, __start/__cancel on action buttons; __blockers-dialog on dialog content
- start-sprint-button: root on trigger button, __dialog on dialog content, __submit on submit button
- sync-active-sprint-cookie: no debug-id (returns null, side-effect only), comment added

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(PBI-49): add BEM sub-element data-debug-id to components/backlog/*

* feat(PBI-49): add BEM sub-element data-debug-id to components/ideas/*

* feat(PBI-49): add BEM sub-element data-debug-id to components/dashboard/* + components/markdown.tsx

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(PBI-49): add BEM sub-element data-debug-id to new-product-button

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(PBI-49): add BEM sub-element data-debug-id to components/solo/*

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(PBI-49): add BEM sub-elements to nav-status-indicators

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(PBI-49): add BEM sub-element data-debug-id to components/jobs/*

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(PBI-49): add BEM sub-element data-debug-id to components/products/*

* feat(PBI-49): add BEM sub-element data-debug-id to components/notifications/*

- answer-modal: __content (scroll area), __submit (footer)
- notifications-bridge: skip comment (bridge, non-rendering wrapper)
- notifications-realtime-mount: skip comment (returns null)
- notifications-sheet: __header, __items (questions list)
- push-toggle: __switch (button), __label (button text) on subscribed/unsubscribed states

* feat(PBI-49): add BEM sub-element data-debug-id to components/settings/*

- leave-product-button: root only (single-button component)
- min-quota-editor: __input (number input), __save (save button)
- profile-editor: __username (bio/short-description input), __save (submit)
- role-manager: __roles (checkbox list), __add (save button)
- token-manager: __tokens (active tokens list), __generate (create button)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(PBI-49): add BEM sub-element data-debug-id to admin, auth, dialogs, entity-dialog, mobile, split-pane

* docs(PBI-49): add debug-labels BEM pattern doc + CLAUDE.md entry

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-09 22:46:29 +02:00

11 KiB

Documentation Index

Auto-generated on 2026-05-09 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-08
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
Plan: model + mode-selectie per ClaudeJob-kind
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)
Queue-loop verplaatsen van Claude naar runner
Advies - SprintRun, PR en worktree lifecycle als state machines draft 2026-05-06
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
Plan: wekelijkse sync van model_prices (PBI-66 / ST-1296)
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
Debug-id op component-root active 2026-05-09
Debug-labels: BEM data-debug-id patroon active 2026-05-09
Entity Dialog active 2026-05-08
iron-session active 2026-05-03
Prisma Client singleton active 2026-05-03
Proxy (route protection) active 2026-05-08
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-08
Server Action active 2026-05-08
Float sort_order (drag-and-drop volgorde) active 2026-05-03
Story met UI-component active 2026-05-03
Web Push active 2026-05-07
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-08
Scrum4Me — Architecture Overview architecture/overview.md active 2026-05-08
Project Structure, Stores, Realtime & Job Queue architecture/project-structure.md active 2026-05-08
QR-pairing Login Flow architecture/qr-pairing.md active 2026-05-03
Sprint execution modes — PER_TASK vs SPRINT_BATCH architecture/sprint-execution-modes.md active 2026-05-07
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-08
Overview manual/01-overview.md active 2026-05-07
Statuses & Transitions manual/02-statuses-and-transitions.md active 2026-05-07
Git Workflow manual/03-git-workflow.md active 2026-05-07
MCP Integration manual/04-mcp-integration.md active 2026-05-07
Docker manual/05-docker.md active 2026-05-07
Troubleshooting manual/06-troubleshooting.md active 2026-05-07
Scrum4Me Developer Manual manual/index.md active 2026-05-07
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-07
Vercel Deployment runbooks/deploy-vercel.md active 2026-05-03
Job-model-selectie per ClaudeJob-kind runbooks/job-model-selection.md active 2026-05-09 (idea-kinds + PLAN_CHAT permission_mode → acceptEdits)
MCP Integration — Scrum4Me Tools runbooks/mcp-integration.md active 2026-05-08
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-09
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