diff --git a/CLAUDE.md b/CLAUDE.md index 11e4d78..a678a1f 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -31,7 +31,7 @@ Lees het relevante document voordat je aan een feature begint. Nooit gokken over | `docs/backlog/product-historical.md` | Historische domein-backlog (referentie); seed wordt sinds ST-004 gegenereerd uit `backlog.md` via `prisma/seed-data/parse-backlog.ts` | | `docs/api/rest-contract.md` | REST-API contract voor Claude Code — endpoints, status-enums, foutcodes, voorbeeld-curls | | `docs/design/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/decisions/agent-instructions-history.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-mcp`](https://github.com/madhura68/scrum4me-mcp) | MCP-server repo: native tools voor Claude Code, schema-sync via git submodule | @@ -192,7 +192,7 @@ Elke `git push` naar een feature-branch triggert een Vercel preview-deployment. ### Wanneer aanpassen -Zodra het Vercel-account naar Pro (of andere omgeving zonder per-build-kosten) gaat: vervang deze regel door "branch + PR per story" zoals oorspronkelijk in dit document stond. Werk deze sectie bij én documenteer de wijziging in `docs/agent-instruction-audit.md`. +Zodra het Vercel-account naar Pro (of andere omgeving zonder per-build-kosten) gaat: vervang deze regel door "branch + PR per story" zoals oorspronkelijk in dit document stond. Werk deze sectie bij én documenteer de wijziging in `docs/decisions/agent-instructions-history.md`. --- diff --git a/README.md b/README.md index 4419132..5806821 100644 --- a/README.md +++ b/README.md @@ -282,4 +282,4 @@ De productieomgeving is gericht op Vercel + Neon. - [Functionele specificatie](docs/specs/functional.md) - [Technische architectuur](docs/architecture.md) - [Backlog](docs/backlog/index.md) -- [Agent-instructie audit](docs/agent-instruction-audit.md) +- [Agent-instructie audit](docs/decisions/agent-instructions-history.md) diff --git a/docs/INDEX.md b/docs/INDEX.md index 2aabc98..e77092a 100644 --- a/docs/INDEX.md +++ b/docs/INDEX.md @@ -62,11 +62,11 @@ Auto-generated on 2026-05-02 from front-matter and headings. | Title | Path | Status | Updated | |---|---|---|---| -| [Agent Instruction Audit](./agent-instruction-audit.md) | `agent-instruction-audit.md` | active | 2026-05-03 | | [Scrum4Me REST API](./api/rest-contract.md) | `api/rest-contract.md` | active | 2026-05-03 | | [Scrum4Me — Technische Architectuur](./architecture.md) | `architecture.md` | active | 2026-05-03 | | [Scrum4Me — Implementatie Backlog](./backlog/index.md) | `backlog/index.md` | active | 2026-05-03 | | [DevPlanner — Product Backlog](./backlog/product-historical.md) | `backlog/product-historical.md` | active | 2026-05-03 | +| [Agent Instruction Audit](./decisions/agent-instructions-history.md) | `decisions/agent-instructions-history.md` | active | 2026-05-03 | | [Material Design 3 Color Scheme Documentation](./design/md3-color-scheme.md) | `design/md3-color-scheme.md` | active | 2026-05-03 | | [Scrum4Me — Styling & Design System](./design/styling.md) | `design/styling.md` | active | 2026-05-03 | | [Obsidian as Personal Authoring Layer](./obsidian-authoring.md) | `obsidian-authoring.md` | active | 2026-05-02 | diff --git a/docs/agent-instruction-audit.md b/docs/decisions/agent-instructions-history.md similarity index 100% rename from docs/agent-instruction-audit.md rename to docs/decisions/agent-instructions-history.md 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 32af0f8..c34d789 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 @@ -11,7 +11,7 @@ applies_to: [M7, ST-509, ST-511, ST-512, ST-513] ## Aanleiding -`CLAUDE.md` is voor het laatst groot bijgewerkt op 2026-04-25 (`docs/agent-instruction-audit.md`). Sindsdien is er substantieel werk geland dat de workflow raakt: +`CLAUDE.md` is voor het laatst groot bijgewerkt op 2026-04-25 (`docs/decisions/agent-instructions-history.md`). Sindsdien is er substantieel werk geland dat de workflow raakt: - **ST-511** entity codes (Product/PBI/Story) — branch- en commit-conventies hangen er nu aan vast - **ST-513** API hardening — `400` (malformed JSON) vs `422` (zod-validatie), lowercase status-enums op API-grens, `StoryLog.metadata` JSONB @@ -32,7 +32,7 @@ Doel: CLAUDE.md weerspiegelt de werkelijke 2026-04-27 workflow zonder dat het ee 5. Definition of Done — markeer expliciet als MVP-scope; M7 is post-MVP en heeft eigen acceptatie **Niet**: -- Geen changelog of historiek in CLAUDE.md zelf — dat hoort in `docs/agent-instruction-audit.md` (separate update) +- Geen changelog of historiek in CLAUDE.md zelf — dat hoort in `docs/decisions/agent-instructions-history.md` (separate update) - Geen volledige herschrijving — bestaande structuur blijft (Wat is Scrum4Me, Spec-tabel, Stack, Conventies, Commit Strategy, etc.) - Geen wijziging in `AGENTS.md` (Codex) — die heeft geen MCP, mag los blijven - Geen wijziging in functional-spec/architecture/styling docs — die zijn al actueel @@ -122,7 +122,7 @@ Wijzig `## Definition of Done` → `## Definition of Done (MVP)` en voeg eronder ## Bijwerken van auditdoc -Voeg een sectie aan `docs/agent-instruction-audit.md` toe (datum: 2026-04-27) met: +Voeg een sectie aan `docs/decisions/agent-instructions-history.md` toe (datum: 2026-04-27) met: - Aanleiding: ST-509/511/512/513 + M7 + PR #2 review-saga - Gecontroleerde wijzigingen: zelfde tabel-stijl als 2026-04-25 @@ -132,7 +132,7 @@ Voeg een sectie aan `docs/agent-instruction-audit.md` toe (datum: 2026-04-27) me ## Volgorde van uitvoering 1. **Edits in `CLAUDE.md`** — alle 6 secties hierboven, in volgorde -2. **Edits in `docs/agent-instruction-audit.md`** — nieuwe sectie 2026-04-27 +2. **Edits in `docs/decisions/agent-instructions-history.md`** — nieuwe sectie 2026-04-27 3. **`npm run lint`** — sanity check 4. **Commit als één logische change** — `docs(workflow): align CLAUDE.md with M7 and post-PR-#2 contract` 5. **PR openen** — review-bare scope, deploys triggeren maar zijn docs-only @@ -146,5 +146,5 @@ Voeg een sectie aan `docs/agent-instruction-audit.md` toe (datum: 2026-04-27) me ## Geschatte size - ~80 regels toegevoegd/gewijzigd in `CLAUDE.md` -- ~30 regels nieuw in `docs/agent-instruction-audit.md` +- ~30 regels nieuw in `docs/decisions/agent-instructions-history.md` - 1 commit, 1 PR diff --git a/docs/plans/docs-restructure-ai-lookup.md b/docs/plans/docs-restructure-ai-lookup.md index ab640c4..7e54ca8 100644 --- a/docs/plans/docs-restructure-ai-lookup.md +++ b/docs/plans/docs-restructure-ai-lookup.md @@ -8,7 +8,7 @@ related: - CLAUDE.md - AGENTS.md - README.md - - docs/agent-instruction-audit.md + - docs/decisions/agent-instructions-history.md --- # Plan — Docs-restructuur voor AI-lookup @@ -73,7 +73,7 @@ Bij elke turn die met `CLAUDE.md` start, wordt minimaal 340 regels orientation i | `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` | -| `agent-instruction-audit.md` | 173 | `docs/decisions/agent-instructions.md` (ADR-stijl) | +| `decisions/agent-instructions-history.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`. @@ -187,7 +187,7 @@ In volgorde van belangrijkheid: │ │ ├── 0002-float-sort-order.md │ │ ├── 0003-one-branch-per-milestone.md │ │ ├── 0004-status-enum-mapping.md -│ │ └── 0005-agent-instructions.md (was agent-instruction-audit.md) +│ │ └── 0005-agent-instructions.md (was decisions/agent-instructions-history.md) │ │ │ ├── backlog/ │ │ ├── index.md (huidige backlog.md) diff --git a/docs/plans/docs-restructure-pbi-spec.md b/docs/plans/docs-restructure-pbi-spec.md index 333ffc9..f3f8a9e 100644 --- a/docs/plans/docs-restructure-pbi-spec.md +++ b/docs/plans/docs-restructure-pbi-spec.md @@ -383,13 +383,13 @@ pbi: commit: docs(taxonomy): move design/api/qa/backlog/assets into folders priority: 2 - - title: "Move agent-instruction-audit → decisions/ as ADR seed" + - title: "Move decisions/agent-instructions-history → decisions/ as ADR seed" description: "Sets up Story 6 ADR-0008 (will replace this file with a real ADR)." implementation_plan: | - git mv docs/agent-instruction-audit.md docs/decisions/agent-instructions-history.md - grep -rln "agent-instruction-audit" docs/ CLAUDE.md AGENTS.md README.md \ - | xargs sed -i '' 's|agent-instruction-audit|decisions/agent-instructions-history|g' - commit: docs(taxonomy): move agent-instruction-audit into decisions/ + git mv docs/decisions/agent-instructions-history.md docs/decisions/agent-instructions-history.md + grep -rln "decisions/agent-instructions-history" docs/ CLAUDE.md AGENTS.md README.md \ + | xargs sed -i '' 's|decisions/agent-instructions-history|decisions/agent-instructions-history|g' + commit: docs(taxonomy): move decisions/agent-instructions-history into decisions/ priority: 3 - slug: split-monoliths