From 6beed4631142f207bca377a889f94bbc4e9deb8f Mon Sep 17 00:00:00 2001 From: Madhura68 Date: Sun, 3 May 2026 00:29:25 +0200 Subject: [PATCH] docs(front-matter): add YAML front-matter to patterns/ --- docs/patterns/claude-question-channel.md | 9 +++++++++ docs/patterns/dialog.md | 9 +++++++++ docs/patterns/iron-session.md | 9 +++++++++ docs/patterns/middleware.md | 9 +++++++++ docs/patterns/prisma-client.md | 9 +++++++++ docs/patterns/qr-login.md | 9 +++++++++ docs/patterns/route-handler.md | 9 +++++++++ docs/patterns/server-action.md | 9 +++++++++ docs/patterns/sort-order.md | 9 +++++++++ docs/patterns/zustand-optimistic.md | 9 +++++++++ 10 files changed, 90 insertions(+) diff --git a/docs/patterns/claude-question-channel.md b/docs/patterns/claude-question-channel.md index d451e41..c810928 100644 --- a/docs/patterns/claude-question-channel.md +++ b/docs/patterns/claude-question-channel.md @@ -1,3 +1,12 @@ +--- +title: "Bidirectionele async-comms MCP-agent ↔ user" +status: active +audience: [ai-agent, contributor] +language: nl +last_updated: 2026-05-03 +when_to_read: "When implementing or extending the claude-question channel for agent-user async communication." +--- + # Patroon: Bidirectionele async-comms tussen MCP-agent en interactieve user Het M11 vraag-antwoord-kanaal is herbruikbaar voor elke feature waarbij een diff --git a/docs/patterns/dialog.md b/docs/patterns/dialog.md index 9bf4682..db4a387 100644 --- a/docs/patterns/dialog.md +++ b/docs/patterns/dialog.md @@ -1,3 +1,12 @@ +--- +title: "Entity Dialog" +status: active +audience: [ai-agent, contributor] +language: nl +last_updated: 2026-05-03 +when_to_read: "Before building any create/edit/detail dialog component." +--- + # Pattern — Entity Dialog Deze pagina is **bindend** voor elke create/edit/detail-dialog in Scrum4Me, ongeacht het achterliggende dataobject (PBI, Story, Task, Todo, Sprint, Product, User, of toekomstige entiteiten). Een nieuwe dialog die hier niet aan voldoet, hoort niet gemerged te worden. diff --git a/docs/patterns/iron-session.md b/docs/patterns/iron-session.md index f979904..bb80e8f 100644 --- a/docs/patterns/iron-session.md +++ b/docs/patterns/iron-session.md @@ -1,3 +1,12 @@ +--- +title: "iron-session" +status: active +audience: [ai-agent, contributor] +language: nl +last_updated: 2026-05-03 +when_to_read: "When reading or writing session cookies or implementing auth checks." +--- + # Patroon: iron-session ## lib/session.ts diff --git a/docs/patterns/middleware.md b/docs/patterns/middleware.md index 91075e5..b6aa7bc 100644 --- a/docs/patterns/middleware.md +++ b/docs/patterns/middleware.md @@ -1,3 +1,12 @@ +--- +title: "Proxy (route protection)" +status: active +audience: [ai-agent, contributor] +language: nl +last_updated: 2026-05-03 +when_to_read: "When adding or modifying route-level access control in proxy.ts." +--- + # Patroon: Proxy (route protection) In Next.js 16 hernoemd van `middleware.ts` naar `proxy.ts`, functienaam van `middleware` naar `proxy`. diff --git a/docs/patterns/prisma-client.md b/docs/patterns/prisma-client.md index d1ef232..084cbc2 100644 --- a/docs/patterns/prisma-client.md +++ b/docs/patterns/prisma-client.md @@ -1,3 +1,12 @@ +--- +title: "Prisma Client singleton" +status: active +audience: [ai-agent, contributor] +language: nl +last_updated: 2026-05-03 +when_to_read: "When importing or initialising the Prisma client in server code." +--- + # Patroon: Prisma Client singleton ## lib/prisma.ts diff --git a/docs/patterns/qr-login.md b/docs/patterns/qr-login.md index 183c749..2253017 100644 --- a/docs/patterns/qr-login.md +++ b/docs/patterns/qr-login.md @@ -1,3 +1,12 @@ +--- +title: "QR-pairing via unauth-SSE + pre-auth cookie" +status: active +audience: [ai-agent, contributor] +language: nl +last_updated: 2026-05-03 +when_to_read: "When working on QR-code login flow or unauth SSE endpoints." +--- + # Patroon: QR-pairing via unauth-SSE + pre-auth cookie Het M10 QR-login-mechanisme is herbruikbaar voor elke feature die **realtime- diff --git a/docs/patterns/route-handler.md b/docs/patterns/route-handler.md index 1b33886..98cc371 100644 --- a/docs/patterns/route-handler.md +++ b/docs/patterns/route-handler.md @@ -1,3 +1,12 @@ +--- +title: "Route Handler (REST API)" +status: active +audience: [ai-agent, contributor] +language: nl +last_updated: 2026-05-03 +when_to_read: "When writing a new Next.js route handler (GET/POST/PATCH/DELETE)." +--- + # Patroon: Route Handler (REST API) Alle endpoints vereisen: `Authorization: Bearer ` diff --git a/docs/patterns/server-action.md b/docs/patterns/server-action.md index 3f350fe..09ea52d 100644 --- a/docs/patterns/server-action.md +++ b/docs/patterns/server-action.md @@ -1,3 +1,12 @@ +--- +title: "Server Action" +status: active +audience: [ai-agent, contributor] +language: nl +last_updated: 2026-05-03 +when_to_read: "When writing a new server action with auth and Zod validation." +--- + # Patroon: Server Action Altijd in `actions/[domein].ts`. Nooit inline in page.tsx. diff --git a/docs/patterns/sort-order.md b/docs/patterns/sort-order.md index bcd2658..2aa41b0 100644 --- a/docs/patterns/sort-order.md +++ b/docs/patterns/sort-order.md @@ -1,3 +1,12 @@ +--- +title: "Float sort_order (drag-and-drop volgorde)" +status: active +audience: [ai-agent, contributor] +language: nl +last_updated: 2026-05-03 +when_to_read: "When implementing drag-and-drop reordering or inserting between items." +--- + # Patroon: Float sort_order (drag-and-drop volgorde) ## Berekening bij tussenvoeging diff --git a/docs/patterns/zustand-optimistic.md b/docs/patterns/zustand-optimistic.md index 32e3ef7..0a75f95 100644 --- a/docs/patterns/zustand-optimistic.md +++ b/docs/patterns/zustand-optimistic.md @@ -1,3 +1,12 @@ +--- +title: "Zustand optimistische update + rollback" +status: active +audience: [ai-agent, contributor] +language: nl +last_updated: 2026-05-03 +when_to_read: "When adding client-side state mutations that need optimistic UI and rollback." +--- + # Patroon: Zustand optimistische update + rollback Gebruik dit patroon bij elke dnd-kit `onDragEnd` handler.