bd7478861b
* docs(PBI-58): add developer manual chapters under docs/manual/ Adds a 7-file English-language manual targeted at new human contributors: index, overview, statuses & transitions (with mermaid state diagrams), git workflow, MCP integration, docker, and troubleshooting. The manual is the *map* — it cross-references existing runbooks/ADRs/architecture docs rather than duplicating their content. Regenerates docs/INDEX.md and validates with check-doc-links.mjs. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * chore(PBI-58): add markdown rendering deps + manual:build script Adds mermaid, rehype-slug, rehype-autolink-headings for the in-app /manual page. Wires manual:build into prebuild so production builds always regenerate the chapter TOC. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * feat(PBI-58): codegen script for in-app manual TOC scripts/build-manual.mjs walks docs/manual/, parses YAML front-matter, strips it from the body, and emits lib/manual.generated.ts with a typed ManualEntry[] containing slug, title, description, filePath, and the embedded markdown body. Pure Node 20, mirrors generate-docs-index.mjs. Inlining the markdown at build time keeps runtime serverless functions free of filesystem reads, which avoids whole-project NFT tracing. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * feat(PBI-58): /manual route renders developer manual chapters in-app Catch-all route at app/(app)/manual/[[...slug]]/page.tsx with generateStaticParams covering every TOC entry. Server-side MarkdownView uses react-markdown with remark-gfm, rehype-slug, and rehype-autolink-headings; mermaid code blocks are routed to a client-only MermaidBlock that dynamic-imports mermaid on mount. ManualSidebar (client) reads the typed TOC and highlights the active chapter via usePathname. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * feat(PBI-58): add Manual link to main nav bar Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
11 KiB
11 KiB
Documentation Index
Auto-generated on 2026-05-07 from front-matter and headings.
Architecture Decision Records
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
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 |
| 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-03 |
| 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-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 |