docs(taxonomy): move agent-instruction-audit into decisions/

This commit is contained in:
Janpeter Visser 2026-05-03 00:56:23 +02:00
parent 90ee122641
commit bdc52a4066
7 changed files with 17 additions and 17 deletions

View file

@ -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

View file

@ -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)

View file

@ -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