nfr design plan vragen aangemaakt (en beantwoord) voor unit 0

2026-06-18 23:50:29 +02:00
parent 53a307cdbd
commit b5357f213a
2 changed files with 76 additions and 0 deletions
@@ -0,0 +1,42 @@
+# NFR Design Plan — Unit 0: Backend Prerequisites
+
+Welkom bij de NFR Design fase voor Unit 0. In deze fase vertalen we de NFR-eisen naar een concreet technisch ontwerp.
+
+Beantwoord de onderstaande vragen om het plan te valideren:
+
+## Vraag 1: CORS Implementation Details
+A) Custom `CorsPolicy`
+B) `ServiceCollectionExtensions` configuratie (Aanbevolen)
+X) Anders (beschrijf na de [Answer]: tag hieronder)
+
+[Answer]: B
+
+## Vraag 2: Rate Limiting
+A) `RateLimiterAttribute` op de controllers
+B) Globale `RateLimiter` pipeline in de middleware (Aanbevolen)
+X) Anders (beschrijf na de [Answer]: tag hieronder)
+
+[Answer]: B
+
+## Vraag 3: Cookie Security
+A) Strict (`HttpOnly`, `Secure`, `SameSite.Strict`) (Aanbevolen)
+B) Aangepaste instellingen
+X) Anders (beschrijf na de [Answer]: tag hieronder)
+
+[Answer]: A
+
+## Vraag 4: Error Handling
+A) `GlobalExceptionHandler` uitbreiden (Aanbevolen)
+B) Custom middleware voor `ProblemDetails`
+X) Anders (beschrijf na de [Answer]: tag hieronder)
+
+[Answer]: A
+
+## Vraag 5: Configuration
+A) `appsettings.json` (conform `dotnet-appsettings` skill, Aanbevolen)
+B) Anders
+X) Anders (beschrijf na de [Answer]: tag hieronder)
+
+[Answer]: A
+
+Laat me weten als je klaar bent met de antwoorden door "Klaar" of iets dergelijks in de chat te typen.
@@ -0,0 +1,34 @@
+# Gedetailleerd Gap-rapport: Inconsistente Vraagstelling en Interactie-formaat (Gap-003)
+
+## 1. Context en Incidentbeschrijving
+Tijdens de uitvoering van de `aidlc-workflow` voor de feature `cms-frontend`, specifiek in de fase **Construction > Unit 0 > NFR Design**, is een inconsistentie opgetreden in de manier waarop de agent vragen stelde aan de gebruiker. In plaats van het voorgeschreven **Multiple Choice** formaat te gebruiken in het `unit-0-nfr-design-plan.md` bestand, presenteerde de agent open-einde vragen.
+
+De gebruiker moest de agent corrigeren en expliciet om meerkeuzevragen vragen, wat leidde tot onnodige cognitieve belasting en een breuk in de efficiënte workflow-ervaring.
+
+## 2. Analyse van de Oorzaak (Root Cause Analysis)
+Een diepere analyse van de `aidlc-workflow` skill onthult de volgende oorzaken:
+
+*   **Zwakke Koppeling tussen Globale Regels en Fase-specifieke Instructies**: Hoewel `common/question-format-guide.md` expliciet het Multiple Choice formaat (met een verplichte "Other" optie) voorschrijft, ontbreekt in veel fase-specifieke bestanden (zoals `construction/nfr-design.md`) een expliciete verwijzing naar dit gids-bestand.
+*   **Prioritering van Inhoud boven Formaat**: In `nfr-design.md` ligt de nadruk zwaar op de *inhoud* van de vragen (Resilience, Scalability, etc.) via "CRITICAL" en "DIRECTIVE" secties. De agent wordt aangespoord om "proactief" te zijn, maar wordt niet herinnerd aan de *vormvereisten* van de interactie op dat specifieke moment.
+*   **Laksheid in Zelf-validatie**: De agent (LLM) neigt naar het genereren van de meest directe (vaak open-einde) vragen als de instructies op dat specifieke punt niet dwingend genoeg zijn, ondanks globale "MANDATORY" regels in de `SKILL.md`.
+
+## 3. Impact
+*   **Gebruikerservaring**: Verhoogde cognitieve belasting; de gebruiker moet zelf antwoorden structureren in plaats van te kunnen kiezen.
+*   **Efficiëntie**: De workflow wordt onderbroken voor handmatige correcties.
+*   **Betrouwbaarheid**: Het "voorspelbare" karakter van de workflow komt in het gedrang.
+
+## 4. Bewijslast (Evidence)
+*   **Artifact**: `aidlc-docs\features\cms-frontend\construction\plans\unit-0-nfr-design-plan.md` (initiële versie bevatte geen opties).
+*   **Interactie**: User prompt: *"skill-creator, waarom krijg ik niet gewoon multiple choice vragen? Waarom moet ik de vragen ineens in een open format gaan beantwoorden?"*
+
+## 5. Aanbevelingen voor de Skill-agent
+Om dit structureel op te lossen in de `aidlc-workflow` skill, moeten de volgende wijzigingen worden doorgevoerd:
+
+1.  **Versterk Stage-specifieke Instructies**: Voeg aan ELK fase-bestand waarin vragen worden gegenereerd (Requirements, User Stories, Functional Design, NFR Design, etc.) een expliciete herinnering toe:
+    *   *“MANDATORY: Follow formatting rules in `common/question-format-guide.md`. All content questions MUST be Multiple Choice with an 'Other' option.”*
+2.  **Update SKILL.md**: Voeg een sectie toe onder "Key Principles" of "MANDATORY Rules" genaamd **Interaction Pattern Consistency**. Hierin moet staan dat afwijken van het `question-format-guide.md` formaat een kritieke fout is.
+3.  **Template Handhaving**: Zorg dat alle voorbeeld-prompts of templates in de skill-details standaard de Multiple Choice structuur tonen.
+4.  **Self-Correction Loop**: Instrueer de agent om vóór het wegschrijven van een plan-bestand met vragen, te valideren of ELKE vraag voldoet aan het `[Answer]:` formaat EN voorzien is van opties A, B, C, etc.
+
+## 6. Overdracht aan Skill-agent
+Dit rapport dient als input voor een reparatie-taak aan de `aidlc-workflow` skill. De focus moet liggen op het expliciet maken van de koppeling tussen *wat* gevraagd moet worden en *hoe* het gevraagd moet worden, over alle fasen van de workflow heen.