From 1b81f66fa6839d74cfa507d7e195910cf0fd8bc0 Mon Sep 17 00:00:00 2001 From: Madhura68 Date: Sun, 3 May 2026 00:33:07 +0200 Subject: [PATCH] docs(naming): lowercase API.md and MD3 filenames --- CLAUDE.md | 8 ++++---- docs/INDEX.md | 4 ++-- docs/agent-instruction-audit.md | 14 +++++++------- docs/{API.md => api.md} | 0 docs/backlog.md | 10 +++++----- ...Scheme_Documentation.md => md3-color-scheme.md} | 0 docs/patterns/claude-question-channel.md | 2 +- docs/patterns/qr-login.md | 2 +- docs/plans/M10-qr-pairing-login.md | 6 +++--- docs/plans/M11-claude-questions.md | 4 ++-- .../2026-04-27-claude-md-workflow-update.md | 4 ++-- docs/plans/archive/2026-04-27-m8-realtime-solo.md | 2 +- docs/plans/docs-restructure-ai-lookup.md | 14 +++++++------- docs/plans/docs-restructure-pbi-spec.md | 10 +++++----- 14 files changed, 40 insertions(+), 40 deletions(-) rename docs/{API.md => api.md} (100%) rename docs/{MD3_Color_Scheme_Documentation.md => md3-color-scheme.md} (100%) diff --git a/CLAUDE.md b/CLAUDE.md index 4bd92a2..af18729 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -29,7 +29,7 @@ Lees het relevante document voordat je aan een feature begint. Nooit gokken over | `docs/backlog.md` | Welke task bouwen, volgorde, "done when"-criteria | | `docs/personas.md` | Lars (primair), Dina, Remi — gebruik bij UI-beslissingen | | `docs/product-backlog.md` | Historische domein-backlog (referentie); seed wordt sinds ST-004 gegenereerd uit `backlog.md` via `prisma/seed-data/parse-backlog.ts` | -| `docs/API.md` | REST-API contract voor Claude Code — endpoints, status-enums, foutcodes, voorbeeld-curls | +| `docs/api.md` | REST-API contract voor Claude Code — endpoints, status-enums, foutcodes, voorbeeld-curls | | `docs/styling.md` | **Lees dit voor elk component** — MD3-kleuren, shadcn patronen | | `docs/agent-instruction-audit.md` | Waarom de agent-instructies zijn aangescherpt; checklist voor toekomstige wijzigingen | | `docs/plans/-*.md` | Implementatieplan per milestone — Bestanden, Stappen, Aandachtspunten, Verificatie. Lees vóór je aan een ST begint. Milestone-key matcht backlog-header (`M9`, `M3.5`, `PBI-9`, …). | @@ -152,7 +152,7 @@ Volledige Zod-schema in `lib/env.ts`. `.env.example` is de canonieke lijst voor - **Docs-sync:** elke gedrags-, dependency-, API- of deploymentwijziging werkt README, relevante docs en patterns bij in dezelfde change - **Entity codes:** gebruik product/PBI/story-codes in commit-titles wanneer aanwezig (`feat(ST-356.2): ...`); branchnaam blijft `feat/ST-XXX-slug` - **Status-enums op API:** lowercase (`todo|in_progress|review|done`, `open|in_sprint|done`); DB houdt UPPER_SNAKE; conversie uitsluitend via `lib/task-status.ts`-mappers — nooit ad-hoc `.toLowerCase()` elders -- **Foutcodes API:** `400` alleen voor malformed JSON-body (parse-fout via `request.json()`); `422` voor zod-validatie en well-formed-maar-niet-acceptabel; `403` voor demo-tokens. Documenteer per endpoint in `docs/API.md` +- **Foutcodes API:** `400` alleen voor malformed JSON-body (parse-fout via `request.json()`); `422` voor zod-validatie en well-formed-maar-niet-acceptabel; `403` voor demo-tokens. Documenteer per endpoint in `docs/api.md` - **Tests volgen contract:** bij een API-contract-wijziging (status, foutcode, response-shape) MOET in dezelfde commit ook `__tests__/api/` mee — een test die rood gaat omdat de oude waarde wordt verwacht is een onvolledige wijziging, niet een "kapotte test" - **Dev port:** `npm run dev` draait altijd op **3000**. Een `predev`-hook killt vooraf elk proces op 3000 (stale Next.js dev-server, vorige sessie) zodat sessies, cookies en MCP-config consistent op één poort werken. Wijk hier niet van af — geen `-p 3001` o.i.d. tenzij je expliciet twee dev-servers naast elkaar wil draaien @@ -328,7 +328,7 @@ Wekelijks (maandag 08:00 Amsterdam) draait de remote agent `trig_015FFUnxjz9WMuh - **Sharp** moet Linux-binaries hebben voor de Vercel-runtime: `npm i --include=optional sharp` of platform-specifieke deps configureren in `package.json` - **Externe image hostnames** in `next.config.js` `images.remotePatterns` configureren *vóór* `next/image` op die hosts wijst — anders 500 in productie -- **Vercel cron**: Hobby-plan staat alleen daily crons toe (max 1×/dag); Pro ondersteunt fijnmaziger. Bij wijziging van `vercel.json` `crons` ook `docs/API.md` + relevante pattern-docs updaten +- **Vercel cron**: Hobby-plan staat alleen daily crons toe (max 1×/dag); Pro ondersteunt fijnmaziger. Bij wijziging van `vercel.json` `crons` ook `docs/api.md` + relevante pattern-docs updaten - **`CRON_SECRET`** moet als env-var op de Vercel-project-omgeving staan vóór de eerste cron-run, anders 401 op `/api/cron/*`-endpoints - **Preflight** vóór deploy: `npm run lint && npm test && npm run build` — falende build laat een PR niet door (CI blokkeert merge per ST-610) @@ -340,7 +340,7 @@ M7 (MCP-server) is post-MVP en heeft eigen acceptatie in `docs/backlog.md`. - [ ] Alle 62 tasks (ST-001 t/m ST-612) afgerond - [ ] Volledige Lars-flow zonder fouten (ST-612) -- [ ] Alle gedocumenteerde API-endpoints werken via curl (zie `docs/API.md`) +- [ ] Alle gedocumenteerde API-endpoints werken via curl (zie `docs/api.md`) - [ ] Demo-gebruiker heeft geen schrijfrechten - [ ] App opzetbaar via README zonder extra hulp - [ ] CI/CD actief — falende build blokkeert merge diff --git a/docs/INDEX.md b/docs/INDEX.md index 0a4a44b..1fba50b 100644 --- a/docs/INDEX.md +++ b/docs/INDEX.md @@ -57,11 +57,11 @@ _No specs yet._ | Title | Path | Status | Updated | |---|---|---|---| | [Agent Instruction Audit](./agent-instruction-audit.md) | `agent-instruction-audit.md` | active | 2026-05-03 | -| [Scrum4Me REST API](./API.md) | `API.md` | active | 2026-05-03 | +| [Scrum4Me REST API](./api.md) | `api.md` | active | 2026-05-03 | | [Scrum4Me — Technische Architectuur](./architecture.md) | `architecture.md` | active | 2026-05-03 | | [Scrum4Me — Implementatie Backlog](./backlog.md) | `backlog.md` | active | 2026-05-03 | | [Scrum4Me — Functionele Specificatie](./functional.md) | `functional.md` | active | 2026-05-03 | -| [Material Design 3 Color Scheme Documentation](./MD3_Color_Scheme_Documentation.md) | `MD3_Color_Scheme_Documentation.md` | active | 2026-05-03 | +| [Material Design 3 Color Scheme Documentation](./md3-color-scheme.md) | `md3-color-scheme.md` | active | 2026-05-03 | | [Obsidian as Personal Authoring Layer](./obsidian-authoring.md) | `obsidian-authoring.md` | active | 2026-05-02 | | [PbiDialog Profiel](./pbi-dialog.md) | `pbi-dialog.md` | active | 2026-05-03 | | [DevPlanner — User Personas](./personas.md) | `personas.md` | active | 2026-05-03 | diff --git a/docs/agent-instruction-audit.md b/docs/agent-instruction-audit.md index c0bf687..556b373 100644 --- a/docs/agent-instruction-audit.md +++ b/docs/agent-instruction-audit.md @@ -108,7 +108,7 @@ Sinds ronde 1 (2026-04-25) is er substantieel werk geland dat de agent-workflow - **ST-509** Todo description (max 2000) - **ST-511** Entity codes voor Product/PBI/Story (auto-default + manual override + retry op race condition) - **ST-512** REST API uitgebreid met `code`, `description`, `implementation_plan` in alle endpoints -- **ST-513** API hardening voor Claude Code: `GET /api/health`, `GET /api/products/:id/claude-context`, lowercase status-enums op de API-grens, `StoryLog.metadata` JSONB, validatie-fouten van `400` → `422`, nieuwe `docs/API.md` +- **ST-513** API hardening voor Claude Code: `GET /api/health`, `GET /api/products/:id/claude-context`, lowercase status-enums op de API-grens, `StoryLog.metadata` JSONB, validatie-fouten van `400` → `422`, nieuwe `docs/api.md` - **PR #2 Codex-review-saga** — 8 testbestanden faalden bij de contract-flip; tests werden niet meebijgewerkt. Twee P2-issues van Codex: malformed JSON moet `400` blijven (P2.1), en `status: review` werd geaccepteerd terwijl de sprint-UI er niet mee om kan gaan (P2.2) - **M7: mcp** — aparte MCP-server repo (`madhura68/mcp`) met 9 tools en 1 prompt voor Claude Code, schema gedeeld via git submodule - **lib/code.ts vs lib/code-server.ts** — gesplitst om client-bundle vrij te houden van `pg` (gaf eerst `Module not found: 'dns'` build-error) @@ -118,12 +118,12 @@ Sinds ronde 1 (2026-04-25) is er substantieel werk geland dat de agent-workflow | Wijziging | Code-locatie | Documentatie bijgewerkt | |---|---|---| -| Lowercase status-enums op REST-grens, mappers naar DB-enum | `lib/task-status.ts`, `app/api/tasks/[id]/route.ts`, `app/api/sprints/[id]/tasks/route.ts`, `app/api/products/[id]/next-story/route.ts` | `docs/API.md`, `CLAUDE.md` | -| 400 (malformed JSON) gescheiden van 422 (zod-validatie) | `app/api/tasks/[id]/route.ts`, `app/api/stories/[id]/tasks/reorder/route.ts`, `app/api/todos/route.ts`, `app/api/stories/[id]/log/route.ts` | `docs/API.md`, `CLAUDE.md` | -| `status: review` geweigerd door PATCH `/api/tasks/:id` zolang sprint-UI geen REVIEW rendert | `app/api/tasks/[id]/route.ts` | `docs/API.md` | +| Lowercase status-enums op REST-grens, mappers naar DB-enum | `lib/task-status.ts`, `app/api/tasks/[id]/route.ts`, `app/api/sprints/[id]/tasks/route.ts`, `app/api/products/[id]/next-story/route.ts` | `docs/api.md`, `CLAUDE.md` | +| 400 (malformed JSON) gescheiden van 422 (zod-validatie) | `app/api/tasks/[id]/route.ts`, `app/api/stories/[id]/tasks/reorder/route.ts`, `app/api/todos/route.ts`, `app/api/stories/[id]/log/route.ts` | `docs/api.md`, `CLAUDE.md` | +| `status: review` geweigerd door PATCH `/api/tasks/:id` zolang sprint-UI geen REVIEW rendert | `app/api/tasks/[id]/route.ts` | `docs/api.md` | | Entity codes (Product/PBI/Story) met auto-default + retry-on-P2002 | `actions/products.ts`, `actions/pbis.ts`, `actions/stories.ts`, `lib/code.ts`, `lib/code-server.ts` | `docs/backlog.md` (ST-511) | -| `StoryLog.metadata` JSONB | `prisma/schema.prisma`, `prisma/migrations/20260426214905_add_story_log_metadata/`, `app/api/stories/[id]/log/route.ts` | `docs/API.md` | -| Health- en bundled-context endpoints voor Claude Code | `app/api/health/route.ts`, `app/api/products/[id]/claude-context/route.ts` | `docs/API.md`, `CLAUDE.md` | +| `StoryLog.metadata` JSONB | `prisma/schema.prisma`, `prisma/migrations/20260426214905_add_story_log_metadata/`, `app/api/stories/[id]/log/route.ts` | `docs/api.md` | +| Health- en bundled-context endpoints voor Claude Code | `app/api/health/route.ts`, `app/api/products/[id]/claude-context/route.ts` | `docs/api.md`, `CLAUDE.md` | | MCP-server gepubliceerd als aparte repo | `madhura68/mcp` (extern) | `CLAUDE.md` (sectie MCP-integratie), `docs/backlog.md` (M7) | ## Nieuwe preventieve regels @@ -148,7 +148,7 @@ API exposeert lowercase, DB houdt UPPER_SNAKE. Conversie uitsluitend via `lib/ta - `400`: parse-fout op `request.json()` — wikkel altijd in `try/catch` - `422`: zod-validatie of well-formed-maar-niet-acceptabel (bv. `task_id` van andere story) - `403`: demo-token op write -- Documenteer per endpoint in `docs/API.md` +- Documenteer per endpoint in `docs/api.md` ### Client/server module-boundary diff --git a/docs/API.md b/docs/api.md similarity index 100% rename from docs/API.md rename to docs/api.md diff --git a/docs/backlog.md b/docs/backlog.md index 6b1bdda..9667972 100644 --- a/docs/backlog.md +++ b/docs/backlog.md @@ -417,8 +417,8 @@ De MVP is klaar wanneer Lars — de primaire persona — de volledige cyclus kan - **`PATCH /api/tasks/:id`:** accepteert lowercase `status` via mapper; retourneert lowercase - **Story-log metadata:** nieuwe optionele `metadata Json?` kolom op `StoryLog`; `POST /api/stories/:id/log` accepteert per type een optioneel `metadata`-veld (bv. `{ branch: 'feat/x' }`); bestaande velden ongewijzigd → backwards-compatible - **Foutcodes:** Zod-validatie geeft `422` (was `400`); `400` blijft voor malformed body; `401`/`403`/`404`/`500` ongewijzigd - - **API-documentatie:** nieuwe `docs/API.md` met endpoints, request/response, foutcodes, status-enums en curl-voorbeelden; `CLAUDE.md` verwijst ernaar - - Done when: `curl /api/health` werkt zonder auth; `curl /api/products/:id/claude-context` retourneert bundled JSON; PATCH/PUT routes accepteren lowercase status en geven 422 bij ongeldige body; story-log POST bewaart `metadata`; `docs/API.md` is gepubliceerd + - **API-documentatie:** nieuwe `docs/api.md` met endpoints, request/response, foutcodes, status-enums en curl-voorbeelden; `CLAUDE.md` verwijst ernaar + - Done when: `curl /api/health` werkt zonder auth; `curl /api/products/:id/claude-context` retourneert bundled JSON; PATCH/PUT routes accepteren lowercase status en geven 422 bij ongeldige body; story-log POST bewaart `metadata`; `docs/api.md` is gepubliceerd - **`GET /api/products`:** voeg `code` toe (naast `id`, `name`, `repo_url`); optioneel `description` en `definition_of_done` - **`GET /api/products/:id/next-story`:** voeg `code` toe op story; voeg per task `code` (derived `${story.code}.${index_in_story}`) en `implementation_plan` toe - **`GET /api/sprints/:id/tasks`:** voeg `description`, `implementation_plan` en `story_code` toe per task; voeg een derived `code`-veld per task toe (`${story.code}.${index_in_story}`) @@ -555,7 +555,7 @@ Filtering server-side: alleen events binnen de actieve sprint van een product wa - Done when: twee tabs van Solo Paneel — mutatie in tab A komt binnen 1–2s in tab B zonder refresh - [x] **ST-806** Documentatie + acceptatietest - - Sectie "Realtime updates" in `docs/architecture.md` met diagram en filtering-regels; vermelding in `CLAUDE.md`; korte note over `/api/realtime/solo` in `docs/API.md`; handmatig E2E-scenario's gedraaid (zelfde gebruiker twee tabs, MCP-write, REST-write, story-claim, network-flap) + - Sectie "Realtime updates" in `docs/architecture.md` met diagram en filtering-regels; vermelding in `CLAUDE.md`; korte note over `/api/realtime/solo` in `docs/api.md`; handmatig E2E-scenario's gedraaid (zelfde gebruiker twee tabs, MCP-write, REST-write, story-claim, network-flap) - Done when: alle scenario's lopen door zonder onverwachte gedragingen Volledig plan in `.Plans/2026-04-27-m8-realtime-solo.md` (lokaal, niet gecommit). @@ -654,7 +654,7 @@ Volledige flow + threat-model: `docs/patterns/qr-login.md` (op te leveren in ST- - Done when: end-to-end happy path werkt op localhost (twee browsers): A toont QR → B scant + bevestigt → A redirect naar `/dashboard` met `session.paired === true`; QR vernieuwt na expiry; geen secret zichtbaar in DevTools Network-tab onder URL-kolommen - [ ] **ST-1008** Documentatie + acceptatietest - - **`docs/API.md`:** drie nieuwe endpoints (start/stream/claim) met request/response, cookie-mechaniek, foutcodes (400/401/403/404/410/422/429), curl-voorbeelden inclusief `--cookie-jar` + - **`docs/api.md`:** drie nieuwe endpoints (start/stream/claim) met request/response, cookie-mechaniek, foutcodes (400/401/403/404/410/422/429), curl-voorbeelden inclusief `--cookie-jar` - **`docs/architecture.md`:** sectie "QR-pairing flow" met sequence-diagram + threat-model; expliciete subsectie *"Waarom geen secret in URL"* — fragments worden niet naar server gestuurd; SSE/claim authenticeren via HttpOnly cookie zodat secret-materiaal niet in access logs / reverse-proxy logs / observability-tools / browsergeschiedenis kan belanden - **`docs/patterns/qr-login.md`:** nieuw pattern-doc voor toekomstige features die hetzelfde unauth-SSE-via-pre-auth-cookie-patroon willen hergebruiken - **`CLAUDE.md`:** verwijzing naar het nieuwe pattern-doc in de patterns-tabel @@ -721,7 +721,7 @@ Persistent vraag-antwoord-kanaal tussen Claude Code (via MCP) en de actieve Scru - Done when: handmatige `curl -X POST` met secret expireert oude rijen; Vercel-dashboard toont cron-config na deploy; onbevoegde call → 401 - [ ] **ST-1108** Documentatie + acceptatietest - - **`docs/API.md`:** secties "SSE — Notifications" + "Cron — Expire questions" met curl-voorbeelden + - **`docs/api.md`:** secties "SSE — Notifications" + "Cron — Expire questions" met curl-voorbeelden - **`docs/architecture.md`:** sectie "Vraag-antwoord-kanaal Claude ↔ user" met Mermaid sequence-diagram + threat-model + "Waarom hergebruik scrum4me_changes-kanaal" - **`docs/patterns/claude-question-channel.md`:** nieuw herbruikbaar pattern-doc voor toekomstige bidirectionele async-communicatie tussen MCP-agents en interactieve users - **`CLAUDE.md`:** rij in Implementatiepatronen-tabel voor het nieuwe pattern diff --git a/docs/MD3_Color_Scheme_Documentation.md b/docs/md3-color-scheme.md similarity index 100% rename from docs/MD3_Color_Scheme_Documentation.md rename to docs/md3-color-scheme.md diff --git a/docs/patterns/claude-question-channel.md b/docs/patterns/claude-question-channel.md index e2dd9bf..63f97ea 100644 --- a/docs/patterns/claude-question-channel.md +++ b/docs/patterns/claude-question-channel.md @@ -148,7 +148,7 @@ Specifiek voor M11. Kopieer en pas aan: - Volledige flow + threat-model: `docs/architecture.md` § Vraag- antwoord-kanaal Claude ↔ user -- Endpoint-contract: `docs/API.md` § Notifications + Cron +- Endpoint-contract: `docs/api.md` § Notifications + Cron - LISTEN/NOTIFY-pattern: `app/api/realtime/solo/route.ts` (M8 ST-802) — zelfde ReadableStream + heartbeat + hard-close + abort-cleanup - M10 vs M11 keuze tussen eigen/gedeeld kanaal: zie threat-model-tabel diff --git a/docs/patterns/qr-login.md b/docs/patterns/qr-login.md index 21160f0..2fb91f4 100644 --- a/docs/patterns/qr-login.md +++ b/docs/patterns/qr-login.md @@ -99,6 +99,6 @@ Drie tijden in escalerende volgorde, alle korter dan de reguliere sessie: ## Referenties - Volledige flow + threat-model: `docs/architecture.md` § QR-pairing flow -- Endpoint-contract: `docs/API.md` § Auth — QR-pairing +- Endpoint-contract: `docs/api.md` § Auth — QR-pairing - LISTEN/NOTIFY-pattern: `app/api/realtime/solo/route.ts` (M8 ST-802) — zelfde ReadableStream + heartbeat + hard-close + abort-cleanup, alleen ander channel diff --git a/docs/plans/M10-qr-pairing-login.md b/docs/plans/M10-qr-pairing-login.md index 000bad7..f56981c 100644 --- a/docs/plans/M10-qr-pairing-login.md +++ b/docs/plans/M10-qr-pairing-login.md @@ -797,7 +797,7 @@ ST-1006 staat bij de API-laag (niet bij UI) omdat het een Route Handler is; ST-1 ## ST-1008 — Documentatie + acceptatietest **Bestanden** -- `docs/API.md` — drie nieuwe endpoints +- `docs/api.md` — drie nieuwe endpoints - `docs/architecture.md` — sectie "QR-pairing flow" + threat-model - `docs/patterns/qr-login.md` — nieuw pattern-doc - `CLAUDE.md` — verwijzing naar het pattern-doc in de patterns-tabel @@ -805,7 +805,7 @@ ST-1006 staat bij de API-laag (niet bij UI) omdat het een Route Handler is; ST-1 **Stappen** -1. **`docs/API.md`** — drie endpoints documenteren met request/response, foutcodes (400/401/403/404/410/422/429), curl-voorbeelden inclusief `--cookie-jar`. Voeg een sectie *"Cookie-mechaniek"* toe die uitlegt dat `s4m_pair` een tijdelijke pre-auth cookie is, anders dan de iron-session cookie. +1. **`docs/api.md`** — drie endpoints documenteren met request/response, foutcodes (400/401/403/404/410/422/429), curl-voorbeelden inclusief `--cookie-jar`. Voeg een sectie *"Cookie-mechaniek"* toe die uitlegt dat `s4m_pair` een tijdelijke pre-auth cookie is, anders dan de iron-session cookie. 2. **`docs/architecture.md`** — sectie *"QR-pairing flow"* met: - Sequence-diagram (mermaid of ASCII analoog aan M8) @@ -866,7 +866,7 @@ feat(ST-1005): add mobile pair confirmation page with hash-fragment client islan feat(ST-1006): add /api/auth/pair/claim with atomic consume chore(ST-1007): add qrcode.react dependency feat(ST-1007): add QR login button on /login with SSE listener -docs(ST-1008): document QR-pairing endpoints in API.md +docs(ST-1008): document QR-pairing endpoints in api.md docs(ST-1008): add QR-pairing flow and threat-model to architecture docs(ST-1008): add qr-login pattern doc ``` diff --git a/docs/plans/M11-claude-questions.md b/docs/plans/M11-claude-questions.md index 35fa267..72c54ce 100644 --- a/docs/plans/M11-claude-questions.md +++ b/docs/plans/M11-claude-questions.md @@ -378,7 +378,7 @@ Backlog-entries: zie [backlog.md § M11](../backlog.md#m11-claude-vraagt-gebruik ## ST-1108 — Documentatie + acceptatietest **Bestanden** -- `docs/API.md` — secties "SSE — Notifications" + "Cron — Expire questions" +- `docs/api.md` — secties "SSE — Notifications" + "Cron — Expire questions" - `docs/architecture.md` — sectie "Vraag-antwoord-kanaal" met sequence-diagram - `docs/patterns/claude-question-channel.md` — herbruikbaar pattern-doc - `docs/backlog.md` — M11-tabel-rij + M11-sectie @@ -439,7 +439,7 @@ feat(ST-1105): add NotificationsBell + Sheet + AnswerModal chore(ST-1107): add CRON_SECRET to env schema feat(ST-1107): add /api/cron/expire-questions handler feat(ST-1107): wire vercel.ts cron entry -docs(ST-1108): document notifications SSE + cron in API.md +docs(ST-1108): document notifications SSE + cron in api.md docs(ST-1108): add vraag-antwoord-kanaal flow to architecture docs(ST-1108): add claude-question-channel pattern doc chore(ST-1108): backlog M11 + parser ACTIVE-flip diff --git a/docs/plans/archive/2026-04-27-claude-md-workflow-update.md b/docs/plans/archive/2026-04-27-claude-md-workflow-update.md index a5306c1..a164577 100644 --- a/docs/plans/archive/2026-04-27-claude-md-workflow-update.md +++ b/docs/plans/archive/2026-04-27-claude-md-workflow-update.md @@ -47,7 +47,7 @@ Voeg toe onder de bestaande tabel: |---|---| | `https://github.com/madhura68/mcp` | MCP-server repo: tools, prompts, schema-sync workflow | -(`docs/API.md` staat er al — laten staan.) +(`docs/api.md` staat er al — laten staan.) ### 2. Sectie "Waar te beginnen" — herschrijven @@ -83,7 +83,7 @@ Voeg toe aan de bestaande lijst: - **Entity codes**: gebruik product/PBI/story-codes in commit-titles wanneer aanwezig (`feat(ST-356.2): ...`); branchnaam blijft `feat/ST-XXX-slug` - **Status-enums op API**: lowercase (`todo|in_progress|review|done`, `open|in_sprint|done`); DB houdt UPPER_SNAKE; conversie via `lib/task-status.ts`-mappers — nooit ad-hoc lowercase elders -- **Foutcodes API**: `400` alleen voor malformed JSON-body (parse-fout); `422` voor zod-validatie en well-formed-maar-niet-acceptabel; `403` voor demo-tokens. Documenteren in `docs/API.md` +- **Foutcodes API**: `400` alleen voor malformed JSON-body (parse-fout); `422` voor zod-validatie en well-formed-maar-niet-acceptabel; `403` voor demo-tokens. Documenteren in `docs/api.md` - **Tests volgen contract**: bij API-contract-wijziging (status, foutcode, response-shape) MOET in dezelfde commit ook `__tests__/api/` bijgewerkt worden — een falende test op review betekent niet dat de tests "stuk zijn" maar dat de wijziging onvolledig is ### 5. Nieuwe sectie "MCP-integratie" — toevoegen vóór "Definition of Done" diff --git a/docs/plans/archive/2026-04-27-m8-realtime-solo.md b/docs/plans/archive/2026-04-27-m8-realtime-solo.md index 11ef2fc..a104099 100644 --- a/docs/plans/archive/2026-04-27-m8-realtime-solo.md +++ b/docs/plans/archive/2026-04-27-m8-realtime-solo.md @@ -134,7 +134,7 @@ Strategie: combineer (a) trigger zet `product_id` en `assignee_id` in de payload ### ST-806 Documentatie + acceptatietest - Update `docs/architecture.md`: nieuwe sectie "Realtime updates" met diagram en filtering-regels - Update `CLAUDE.md`: vermelding dat Solo Paneel realtime is + dat MCP-writes vanzelf doorkomen -- Update `docs/API.md`: korte note over `/api/realtime/solo` (Bearer auth, SSE format) +- Update `docs/api.md`: korte note over `/api/realtime/solo` (Bearer auth, SSE format) - E2E-acceptatie: lijst van scenario's (zelfde gebruiker twee tabs, MCP-write, REST-write, story-claim, network-flap) handmatig getest - Done when: scenario's lopen door zonder onverwachte gedragingen diff --git a/docs/plans/docs-restructure-ai-lookup.md b/docs/plans/docs-restructure-ai-lookup.md index 81f1560..e2f675c 100644 --- a/docs/plans/docs-restructure-ai-lookup.md +++ b/docs/plans/docs-restructure-ai-lookup.md @@ -66,19 +66,19 @@ Bij elke turn die met `CLAUDE.md` start, wordt minimaal 340 regels orientation i | `product-backlog.md` | 454 | `docs/backlog/product-historical.md` (referentie, zie noot in CLAUDE.md) | | `personas.md` | 138 | `docs/specs/personas.md` | | `styling.md` | 670 | `docs/design/styling.md` | -| `MD3_Color_Scheme_Documentation.md` | 941 | `docs/design/md3-color-scheme.md` (overlapt deels met `styling.md` — kandidaat voor merge) | +| `md3-color-scheme.md` | 941 | `docs/design/md3-color-scheme.md` (overlapt deels met `styling.md` — kandidaat voor merge) | | `test-plan.md` | 454 | `docs/qa/api-test-plan.md` | | `pbi-dialog.md` | 120 | `docs/specs/dialogs/pbi.md` | | `story-dialog.md` | 163 | `docs/specs/dialogs/story.md` | | `task-dialog.md` | 127 | `docs/specs/dialogs/task.md` | | `solo-paneel-spec.md` | 771 | `docs/specs/solo-panel.md` | -| `API.md` | 520 | `docs/api/rest-contract.md` | +| `api.md` | 520 | `docs/api/rest-contract.md` | | `agent-instruction-audit.md` | 173 | `docs/decisions/agent-instructions.md` (ADR-stijl) | | `erd.svg`, `icons.html` | — | `docs/assets/` | **Patroon dat opvalt:** alles met prefix `` — dat prefix is overbodig, je staat al in `docs/` van de Scrum4Me-repo. Verwijderen scheelt visuele ruis bij `ls`. -**Inconsistente capitalization:** één bestand `MD3_Color_Scheme_Documentation.md` (snake + UpperCamel), de rest kebab. Eén bestand `API.md` (UPPER), de rest lowercase. +**Inconsistente capitalization:** één bestand `md3-color-scheme.md` (snake + UpperCamel), de rest kebab. Eén bestand `api.md` (UPPER), de rest lowercase. ### 2.3 `docs/patterns/` @@ -161,7 +161,7 @@ In volgorde van belangrijkheid: │ │ └── color-tokens.md (alleen het token-overzicht) │ │ │ ├── api/ -│ │ ├── rest-contract.md (huidige API.md) +│ │ ├── rest-contract.md (huidige api.md) │ │ └── error-codes.md (afgesplitst — vandaag verspreid) │ │ │ ├── patterns/ (RULES — kort en bindend) @@ -220,7 +220,7 @@ In volgorde van belangrijkheid: ``` **Prefix `` overal weg.** Je staat in de Scrum4Me-repo. -**Alle bestandsnamen kebab-case, lowercase.** Geen `API.md`, geen `MD3_…`. +**Alle bestandsnamen kebab-case, lowercase.** Geen `api.md`, geen `MD3_…`. --- @@ -345,8 +345,8 @@ Elke fase is een eigen branch + PR. Geen big-bang. Volgorde gekozen zodat agents ### Fase 2 — Naamgeving normaliseren - `` prefix overal weg via `git mv` (1 commit per groep — backlog/specs/personas/styling/dialogs). -- `API.md` → `api/rest-contract.md`. -- `MD3_Color_Scheme_Documentation.md` → `design/md3-color-scheme.md`. +- `api.md` → `api/rest-contract.md`. +- `md3-color-scheme.md` → `design/md3-color-scheme.md`. - `Tweede Claude Agent — Planning Agent.md` → `plans/tweede-claude-agent-planning.md`. - `middleware.md` → `proxy.md` (volgt Next.js 16 hernoeming). - Per `git mv`: in dezelfde commit zoek-en-vervang alle interne links + CLAUDE.md doc-index. diff --git a/docs/plans/docs-restructure-pbi-spec.md b/docs/plans/docs-restructure-pbi-spec.md index 9b6e231..19b0944 100644 --- a/docs/plans/docs-restructure-pbi-spec.md +++ b/docs/plans/docs-restructure-pbi-spec.md @@ -283,15 +283,15 @@ pbi: commit: docs(naming): drop prefix from doc filenames priority: 2 - - title: "Lowercase API.md and MD3 file" + - title: "Lowercase api.md and MD3 file" description: "Two files use non-kebab capitalization." implementation_plan: | - git mv docs/API.md docs/api.md - git mv docs/MD3_Color_Scheme_Documentation.md docs/md3-color-scheme.md + git mv docs/api.md docs/api.md + git mv docs/md3-color-scheme.md docs/md3-color-scheme.md grep -rln "API\.md\|MD3_Color_Scheme" docs/ CLAUDE.md AGENTS.md README.md \ - | xargs sed -i '' 's|API\.md|api.md|g; s|MD3_Color_Scheme_Documentation|md3-color-scheme|g' + | xargs sed -i '' 's|API\.md|api.md|g; s|md3-color-scheme|md3-color-scheme|g' npm run docs:index - commit: docs(naming): lowercase API.md and MD3 filenames + commit: docs(naming): lowercase api.md and MD3 filenames priority: 2 - title: "Rename plan file with spaces + em-dash"