From ee05e4775e34285968e4fa28ff866ed88c7e278d Mon Sep 17 00:00:00 2001 From: Scrum4Me Agent <30029041+madhura68@users.noreply.github.com> Date: Sun, 3 May 2026 00:12:04 +0200 Subject: [PATCH] docs(naming): polish CLAUDE.md doc-index after renames Fix doubled scrum4me-scrum4me-mcp repo references (cascade from prior sed) in CLAUDE.md, docs/architecture.md, backlog.md, agent-instruction-audit.md, and plans/ST-1109. Update 'Middleware' label to 'Proxy middleware' in patterns table. --- CLAUDE.md | 6 +++--- docs/agent-instruction-audit.md | 6 +++--- docs/architecture.md | 2 +- docs/backlog.md | 2 +- docs/plans/ST-1109-pbi-status.md | 2 +- 5 files changed, 9 insertions(+), 9 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 7ecdb30..b129147 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -25,7 +25,7 @@ Lees het relevante document voordat je aan een feature begint. Nooit gokken over | `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`, …). | -| [`madhura68/scrum4me-scrum4me-mcp`](https://github.com/madhura68/scrum4me-scrum4me-mcp) | MCP-server repo: native tools voor Claude Code, schema-sync via git submodule | +| [`madhura68/scrum4me-mcp`](https://github.com/madhura68/scrum4me-mcp) | MCP-server repo: native tools voor Claude Code, schema-sync via git submodule | --- @@ -108,7 +108,7 @@ Lees het relevante patroon vóór je begint. Nooit uit het hoofd schrijven. | Route Handler (REST API) | `docs/patterns/route-handler.md` | | Zustand optimistische update + rollback | `docs/patterns/zustand-optimistic.md` | | Float sort_order drag-and-drop | `docs/patterns/sort-order.md` | -| Middleware (route protection) | `docs/patterns/proxy.md` | +| Proxy middleware (route protection) | `docs/patterns/proxy.md` | | QR-pairing (unauth-SSE + pre-auth cookie) | `docs/patterns/qr-login.md` | | Bidirectionele async-comms MCP-agent ↔ user | `docs/patterns/claude-question-channel.md` | | **Entity Dialog (verplicht voor élke create/edit/detail-dialog)** | `docs/patterns/dialog.md` — bron-of-truth; per entiteit één profile-doc (bv. `docs/task-dialog.md`) | @@ -293,7 +293,7 @@ docs(ST-XXX): document profile feature ## MCP-integratie -Scrum4Me heeft een eigen MCP-server in repo [`madhura68/scrum4me-scrum4me-mcp`](https://github.com/madhura68/scrum4me-scrum4me-mcp) die de REST-API als native tools voor Claude Code aanbiedt. Schema's worden gedeeld via een git submodule (`vendor/scrum4me`), niet gedupliceerd. +Scrum4Me heeft een eigen MCP-server in repo [`madhura68/scrum4me-mcp`](https://github.com/madhura68/scrum4me-mcp) die de REST-API als native tools voor Claude Code aanbiedt. Schema's worden gedeeld via een git submodule (`vendor/scrum4me`), niet gedupliceerd. ### Tools beschikbaar in Claude Code (18) diff --git a/docs/agent-instruction-audit.md b/docs/agent-instruction-audit.md index df396ff..bc5d1a9 100644 --- a/docs/agent-instruction-audit.md +++ b/docs/agent-instruction-audit.md @@ -102,7 +102,7 @@ Sinds ronde 1 (2026-04-25) is er substantieel werk geland dat de agent-workflow - **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` - **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: scrum4me-mcp** — aparte MCP-server repo (`madhura68/scrum4me-scrum4me-mcp`) met 9 tools en 1 prompt voor Claude Code, schema gedeeld via git submodule +- **M7: scrum4me-mcp** — aparte MCP-server repo (`madhura68/scrum4me-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) - **Wekelijkse schema-drift cron** (`trig_015FFUnxjz9WMuhhWNGBQKFD`) — remote agent die ma 08:00 Amsterdam de MCP-submodule syncet en typecheckt @@ -116,7 +116,7 @@ Sinds ronde 1 (2026-04-25) is er substantieel werk geland dat de agent-workflow | 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` | -| MCP-server gepubliceerd als aparte repo | `madhura68/scrum4me-scrum4me-mcp` (extern) | `CLAUDE.md` (sectie MCP-integratie), `docs/backlog.md` (M7) | +| MCP-server gepubliceerd als aparte repo | `madhura68/scrum4me-mcp` (extern) | `CLAUDE.md` (sectie MCP-integratie), `docs/backlog.md` (M7) | ## Nieuwe preventieve regels @@ -161,7 +161,7 @@ De wekelijkse cron doet dit automatisch, maar ad-hoc checken is nog steeds verst `CLAUDE.md` is uitgebreid met: -- Specificatiedocumenten-rij voor `madhura68/scrum4me-scrum4me-mcp` +- Specificatiedocumenten-rij voor `madhura68/scrum4me-mcp` - Dual-track workflow (Track A: MCP-prompt; Track B: manueel) - Twee patroon-rijen: `lib/task-status.ts` en client/server module-boundary - Vier nieuwe conventies: entity codes in commits, lowercase API-status, error-code split, test-pariteit diff --git a/docs/architecture.md b/docs/architecture.md index fd53acc..be21af7 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -1186,7 +1186,7 @@ De bestaande `notify_task_change`-trigger op `tasks` vuurt automatisch de pg_not ### Hybride-ready -De huidige implementatie verwacht een lokale Claude Code-sessie die `wait_for_job` aanroept vanuit `madhura68/scrum4me-scrum4me-mcp`. Toekomstige uitbreiding naar Vercel Sandbox (serverless agent) vereist alleen een nieuw claim-endpoint — het datamodel en SSE-flow zijn ongewijzigd. +De huidige implementatie verwacht een lokale Claude Code-sessie die `wait_for_job` aanroept vanuit `madhura68/scrum4me-mcp`. Toekomstige uitbreiding naar Vercel Sandbox (serverless agent) vereist alleen een nieuw claim-endpoint — het datamodel en SSE-flow zijn ongewijzigd. ## Environment variables diff --git a/docs/backlog.md b/docs/backlog.md index d983f47..8424cc0 100644 --- a/docs/backlog.md +++ b/docs/backlog.md @@ -473,7 +473,7 @@ De MVP is klaar wanneer Lars — de primaire persona — de volledige cyclus kan ### M7: MCP-server voor Claude Code -Aparte repo: [`madhura68/scrum4me-scrum4me-mcp`](https://github.com/madhura68/scrum4me-scrum4me-mcp). Native Prisma-toegang (geen REST-tussenlaag), stdio-transport, Scrum4Me-schema gevendord als git submodule. Tokens hergebruikt uit `api_tokens`. v1 is alleen dev-flow tools — geen PBI/sprint-creatie of profielbeheer. +Aparte repo: [`madhura68/scrum4me-mcp`](https://github.com/madhura68/scrum4me-mcp). Native Prisma-toegang (geen REST-tussenlaag), stdio-transport, Scrum4Me-schema gevendord als git submodule. Tokens hergebruikt uit `api_tokens`. v1 is alleen dev-flow tools — geen PBI/sprint-creatie of profielbeheer. - [x] **ST-701** Repo-skeleton scrum4me-mcp - npm init, tsconfig strict, .gitignore, MCP SDK 1.29, Prisma 7, zod, tsx; lege `src/index.ts` die op stdio start diff --git a/docs/plans/ST-1109-pbi-status.md b/docs/plans/ST-1109-pbi-status.md index e7820a8..f2ecb1d 100644 --- a/docs/plans/ST-1109-pbi-status.md +++ b/docs/plans/ST-1109-pbi-status.md @@ -65,7 +65,7 @@ const pbiIdsToMarkDone = candidatePbis ## Opvolgactie buiten deze repo -[`madhura68/scrum4me-scrum4me-mcp`](https://github.com/madhura68/scrum4me-scrum4me-mcp): de `create_pbi` tool kan straks optioneel `status` accepteren. Submodule (`vendor/scrum4me`) moet gesynced worden na merge zodat de drift-bewaking maandag groen blijft. +[`madhura68/scrum4me-mcp`](https://github.com/madhura68/scrum4me-mcp): de `create_pbi` tool kan straks optioneel `status` accepteren. Submodule (`vendor/scrum4me`) moet gesynced worden na merge zodat de drift-bewaking maandag groen blijft. ## Verificatie (end-to-end)