docs(taxonomy): move agent-instruction-audit into decisions/
This commit is contained in:
parent
90ee122641
commit
bdc52a4066
7 changed files with 17 additions and 17 deletions
|
|
@ -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/<milestone-key>-*.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`.
|
||||
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -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)
|
||||
|
|
|
|||
|
|
@ -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 |
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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)
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue