35 lines
3.7 KiB
Markdown
35 lines
3.7 KiB
Markdown
# 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.
|