Sprint 4

• User Story

  Als technisch auteur bij Phoenix Contact wil ik een screenshot met één sneltoets in mijn werkinstructie plakken met een vaste, beschrijvende bestandsnaam, zodat ik geen bestanden meer hoef te hernoemen als ik een stap invoeg of verplaats.

  Acceptatiecriteria

  1. 1Het sjabloon bevat lightbox: true, de gekozen plakfunctie en de shortcode {{< details naam >}}. Een geplakte screenshot geeft direct een werkende afbeelding.
  2. 2Bestandsnamen volgen de afspraak onderwerp-actie.png, zonder stapnummer. Dat staat vastgelegd in de auteursrichtlijn.
  3. 3Een bestaande oefening is opnieuw opgebouwd. De tijd per screenshot en per ingevoegde stap is gemeten, oud tegenover nieuw.

  Kwaliteitscriteria

  1. 1Meting: de gemeten tijden zijn vergeleken met de KLM-voorspelling uit mijn onderzoek (68 → 18 seconden per screenshot), en de afwijking staat erbij.
  2. 2Harde eis E3: zonder extensie blijft de instructie leesbaar en bewerkbaar.
  3. 3De Quarto-versie staat vast in de GitLab CI-pipeline.
• User Story

  Als reviewer van werkinstructies wil ik dat de GitLab-pipeline een instructie afkeurt bij ontbrekende of ongebruikte afbeeldingen, lege alt-teksten, placeholders en afwijkende schrijfwijzen, zodat deze fouten niet meer gepubliceerd worden.

  Acceptatiecriteria

  1. 1De build faalt met een duidelijke melding: het bestand, de regel en de fout.
  2. 2In een testoefening met alle vier de fouttypen vindt het script ze allemaal.
  3. 3De lijst met schrijfwijzen staat in één configuratiebestand.

  Kwaliteitscriteria

  1. 1WCAG 2.2 succescriterium 1.1.1 (Non-text Content) voor alt-teksten.
  2. 2Elk fouttype heeft een geautomatiseerde test.
• User Story

  Als technisch auteur wil ik een oefening zien als een lijst van stapkaarten, waarin ik stappen kan slepen en een screenshot op een stap kan plakken, zodat het invoegen en verplaatsen van stappen geen handwerk meer kost.

  Acceptatiecriteria

  1. 1De editor leest een bestaande .qmd in als stapkaarten, met een stap per lege #-kop.
  2. 2Stappen toevoegen, verwijderen en verplaatsen kan door te slepen. Na het opslaan is het resultaat gewone .qmd die de pipeline zonder aanpassing bouwt.
  3. 3Een geplakte of gesleepte screenshot krijgt automatisch een naam volgens de afspraak uit optie 1 en komt in de juiste map.
  4. 4Er is een onderbouwde keuze gemaakt tussen een VS Code-extensie en een lokale web-app.

  Kwaliteitscriteria

  1. 1Verliesvrij: een .qmd openen en zonder wijzigingen opslaan geeft een leeg git diff. Dit is getest op minimaal 3 bestaande oefeningen.
  2. 2KLM-scenario B (stap invoegen na stap 2) kost maximaal 5 seconden extra, wat score 5 is op criterium C2 uit je onderzoek.
  3. 3Code: TypeScript in strict-modus, ESLint zonder fouten, en geautomatiseerde tests voor het inlezen en wegschrijven.
  4. 4AI-ondersteund bouwen: de opbouw met Claude Code is terug te zien in kleine commits en een promptlog.
• Research Story

  Als student wil ik weten welke risico’s ontstaan als ik met Claude Code software bouw voor Phoenix Contact, zodat ik kan bepalen onder welke voorwaarden AI-ondersteund ontwikkelen verantwoord is.

  Acceptatiecriteria

  1. 1Er is een analyse van minimaal 5 risico’s, elk met kans, impact en een maatregel. Denk aan bedrijfscode en screenshots die naar de aanbieder gaan, kwetsbare of verzonnen packages, licenties van gegenereerde code en eigenaarschap van die code.
  2. 2De gegenereerde code van de editor is getoetst op deze risico’s. De bevindingen zijn verwerkt.
  3. 3Er is een korte werkafspraak van één A4 voor AI-ondersteund ontwikkelen binnen dit project, besproken met je contactpersoon.

  Kwaliteitscriteria

  1. 1OWASP Top 10 for LLM Applications 2025, met name LLM02 en LLM03 (supply chain), en OWASP Top 10 voor de editor zelf.
  2. 2Wet bescherming bedrijfsgeheimen en de voorwaarden van Anthropic (training, bewaartermijn), geraadpleegd op een vaste peildatum.
  3. 3Bronnen getoetst met de CRAAP-test. Het ethiekcollege van 2/3 november gebruik je als input.

Nog geen feedback ontvangen.

Nog geen reflectie.