Praktisch AI-advies voor teams en leiders

Eerste stappen. Geavanceerde AI.

Gepubliceerde gidsBijgewerkt

Hoofdstuk 18 van 20Publiceren en onderhouden

Hoofdstukkenmenu20 hoofdstukken

Beoordeel de site en stel automatische controles in

Laat opnieuw beoordelen, herstel problemen en laat GitHub controles herhalen wanneer je code verandert.

Kooka, een vriendelijke kookaburra-docent met een bril en een blauw notitieboek.

Laten we het werk controleren voordat het de hoofdversie wordt.

Volg de afbeeldingen

Voorbeelden ter illustratie. Jouw app kan er anders uitzien. Tik op een afbeelding om deze te vergroten. De illustraties gebruiken Engelse voorbeeldlabels. De stappen en uitleg zijn vertaald.

  1. Vraag een nieuwe beoordeling

    Kopieer de beoordelingsprompt naar een nieuwe Codex-chat. Laat wijzigingen vergelijken met je projecteisen.

    Illustratie: open een nieuwe Codex-chat, verstuur de beoordelingsprompt en vergelijk het verslag met de projecteisen.
    Voorbeeld ter illustratie
    In Codex
    New chat → Beoordelingsprompt plakken → Verslag lezen
    Daarna
    Vergelijk eisen en gewijzigde bestanden.

    Let op: Een apart beoordelingsverslag met bevindingen die je kunt controleren.

    Meer hulp bij deze actie

    Gebruik een nieuw gesprek, zodat de beoordeling begint met het bekijken van het werk.

    Toon de beoordelingsstappen
    1. Open een nieuwe chat in hetzelfde Codex-project. Kopieer Vraag een nieuwe beoordeling uit de prompts en verstuur die met de branchnaam, je brief en het testverslag.
    2. Laat de beoordelaar gewijzigde bestanden bekijken en vermoedelijke problemen reproduceren. Vergelijk het resultaat met je acceptatiecriteria uit hoofdstuk 12.
    3. Een aparte AI-chat blijft een AI-beoordeling. Regel passende menselijke beoordeling voor werk dat je niet kunt beoordelen, vooral bij accounts, betalingen of persoonsgegevens.

    Dit zou je nu moeten zien: Een verslag dat bevestigde fouten, vragen en beperkingen onderscheidt. De beoordelaar wijzigt geen bestanden en voegt de branch niet samen.

  2. Herstel en controleer opnieuw

    Herstel bevestigde problemen en herhaal betrokken bezoekerscontroles. Houd resterende bevindingen in je beoordelingsnotitie.

    Illustratie: een gemeld probleem leidt tot een kleine herstelling en herhaling van betrokken bezoekerstests.
    Voorbeeld ter illustratie
    Werkcyclus
    Probleem bevestigen → Herstellen → Betrokken controles herhalen

    Let op: Bevestigde fouten hebben herstellingen en nieuwe resultaten. Openstaande bevindingen blijven zichtbaar.

    Meer hulp bij deze actie

    Een bevinding is nuttig als je kunt laten zien wat misgaat en het herstel kunt controleren.

    Werk de bevindingen af
    1. Laat Codex elke gemelde fout reproduceren vóór het wijzigen. Herstel één duidelijk probleem tegelijk.
    2. Herhaal betrokken tests en belangrijke bezoekersroutes uit hoofdstuk 15. Noteer wat is gecontroleerd en het resultaat.
    3. Houd onbeantwoorde vragen in de publicatienotitie. Blijft een ernstig probleem open? Houd de publicatie als concept.

    Dit zou je nu moeten zien: Bevestigde fouten die publicatie blokkeren zijn hersteld met nieuw controlebewijs. Openstaande bevindingen blijven genoteerd.

  3. Bewaar de automatische controles

    Gebruik de workflowprompt voor automatische GitHub-controles. Gebruik commando’s die al op je computer werken.

    Illustratie: Codex maakt quality.yml met projectcommando’s die lokaal al werken.
    Voorbeeld ter illustratie
    In het project
    .github → workflows → quality.yml
    Vraag Codex
    Gebruik de gecontroleerde installatie-, codecontrole- en bouwcommando’s.

    Let op: Een workflowbestand dat echte projectcontroles herhaalt zonder de site te publiceren.

    Meer hulp bij deze actie

    Een workflow is een opgeslagen lijst commando’s die GitHub uitvoert.

    Maak werkende controles herhaalbaar
    1. Kopieer Maak de gecontroleerde tests herhaalbaar. Laat Codex package.json, de opgeslagen lockfile en de ondersteunde Node-versie bekijken.
    2. Vraag om .github/workflows/quality.yml voor pushes en pull requests. Gebruik npm ci en de echte controle- en bouwcommando’s die lokaal al zijn getest.
    3. Gebruik huidige officiële GitHub-actions en minimale leesrechten. Deze statische website heeft geen OpenAI API-sleutel in de workflow nodig. Voeg geen automatische publicatie toe.

    Dit zou je nu moeten zien: De bewaarde workflow gebruikt echte projectcommando’s, de bedoelde Node-versie en geen onnodige toegangsgegevens.

  4. Neem de browsertests op

    Neem Playwright-browsertests op en verslagen die fouten begrijpelijk maken.

    Illustratie: installeer testbrowsers, voer websitetests uit en bewaar een verslag bij een mislukte controle.
    Voorbeeld ter illustratie
    Workflow
    Browsers installeren → Testsite starten → Tests uitvoeren → Verslagen bewaren

    Let op: De workflow kan de bedoelde browsertests uitvoeren en bruikbaar foutbewijs bewaren.

    Meer hulp bij deze actie

    Browsertests hebben eigen browsers en een website om te bezoeken nodig.

    Bereid de browsertesttaak voor
    1. Volg Playwrights huidige CI-instructies om browsers en benodigde systeempakketten te installeren.
    2. Laat Codex de werkende projecttestinstellingen gebruiken om de lokale testsite te starten en de bedoelde browsercontroles uit te voeren.
    3. Bewaar foutverslagen, logboeken en bruikbare screenshots. Die helpen een mislukte controle onderzoeken zonder te gokken.

    Dit zou je nu moeten zien: Browsertests kunnen op GitHub draaien en bewaren bruikbaar bewijs bij een mislukte controle.

  5. Open een pull request

    Push je branch en open een pull request. Lees de Actions-uitvoering voor de nieuwste wijziging.

    Illustratie: maak een GitHub-pull request, open Actions en lees de logboeken voor de nieuwste commit.
    Voorbeeld ter illustratie
    Op GitHub
    Je branch → Compare & pull request → Create Pull Request
    Lees de controles
    Actions → Nieuwste uitvoering → Logboek van de taak

    Let op: Een pull request en afgeronde controle voor de nieuwste commit.

    Meer hulp bij deze actie

    Een pull request houdt voorgestelde wijzigingen samen ter beoordeling.

    Vind de pull request en resultaten
    1. Bewaar je branchwijzigingen als commits en push die branch naar je GitHub-repository.
    2. Kies op GitHub de branch en Compare & pull request. Controleer of base je hoofdbranch is en compare je werkbranch; kies daarna Create Pull Request.
    3. Open het Actions-tabblad van de repository en bekijk de nieuwste uitvoering. Lees het logboek van mislukte taken. Controleer of de uitvoering bij de nieuwste pull-requestcommit hoort en niet bij een oudere versie.

    Dit zou je nu moeten zien: De pull request toont afgeronde controleresultaten voor de wijziging die je werkelijk beoordeelt.

  6. Beoordeel vóór samenvoegen

    Bekijk Actions-gebruik en beoordeel resultaten. Voeg pas samen als relevante controles slagen en jij de wijziging goedkeurt.

    Illustratie: bekijk het beoordelingsverslag en controleresultaten voordat je kiest of je de wijziging samenvoegt.
    Voorbeeld ter illustratie
    Beslissing
    Bevindingen lezen → Nieuwste resultaten controleren → Goedkeuren of verderwerken

    Let op: Je keurt alleen een beoordeelde wijziging goed waarvan relevante controles slagen.

    Meer hulp bij deze actie

    Groene controles helpen je beslissing; ze beslissen niet voor je.

    Beslis of je samenvoegt
    1. Bekijk GitHub Actions-gebruik en eventuele accountkosten. Je hebt geen API-toegang nodig voor controles van deze statische site.
    2. Lees het aparte beoordelingsverslag en de nieuwste bouw- en browserresultaten. Los ernstige bevindingen op vóór goedkeuring.
    3. Voeg alleen samen als je het beoordeelde resultaat goedkeurt. In deze gids upload je later handmatig naar hosting; deze workflow publiceert de website niet. Voeg je later automatische hosting toe? Controleer vóór samenvoegen wat publicatie start.

    Dit zou je nu moeten zien: De hoofdversie bevat alleen de wijziging die je na geslaagde relevante controles goedkeurde.

Waarom deze stap belangrijk is

Een pull request vergelijkt een voorgestelde wijziging met de bewaarde hoofdversie. Je beoordeelt die voordat je de versies samenvoegt.

GitHub Actions voert afgesproken controles automatisch uit. Een geslaagde uitvoering is nuttig bewijs, maar jij beslist of de site klaar is.

De basis uitgelegd

Diff

Een vergelijking die laat zien wat tussen twee bestandsversies is toegevoegd, gewijzigd en verwijderd.

CI

Continuous integration: afgesproken controles automatisch uitvoeren bij codewijzigingen, zodat fouten vóór publicatie worden ontdekt.

Lockfile

Een bestand met pakketversies. npm ci gebruikt het voor dezelfde installatie en stopt als het niet overeenkomt met package.json.

Workflow

Een opgeslagen reeks taken en commando’s die start bij gebeurtenissen zoals een push of pull request.

Vraag het je agent

PromptVraag een nieuwe beoordeling

Kopieer naar Codex en pas de tekst aan je project aan.

Beoordeel de wijzigingen op de Fieldnotes Studio-branch tegenover onze brief en acceptatiecriteria. Bekijk zelfstandig functionaliteit, toegankelijkheid, geheimen, pakketten en testdekking. Reproduceer vermoedelijke fouten en noem betrokken bestanden. Onderscheid bevestigde problemen van vragen en beperkingen. Meld bevindingen zonder bestanden te wijzigen of de branch samen te voegen.
PromptMaak de gecontroleerde tests herhaalbaar

Kopieer naar Codex en pas de tekst aan je project aan.

Bekijk package.json, de lockfile, Node-eisen en onze werkende browsertestinstellingen. Maak .github/workflows/quality.yml voor push en pull_request met huidige officiële GitHub Actions, minimale leesrechten, npm ci en de echte gecontroleerde codecontrole-, bouw- en browsertestcommando’s. Stel benodigde Playwright-browserinstallatie en foutbestanden in. Deze statische site heeft geen OpenAI API-sleutel nodig. Leg elke taak uit en hoe ik de resultaten op GitHub bekijk. Voeg geen automatische websitepublicatie toe.
Controleer je werk

Vink elk punt aan nadat je het zelf hebt gecontroleerd. Je kunt het vinkje altijd verwijderen.

Als er iets misgaat
De workflow meldt dat een script ontbreekt.
Vergelijk het foutieve commando met package.json. Laat Codex de workflow herstellen of het bedoelde script expliciet lokaal instellen en controleren vóór opnieuw uitvoeren.
Tests werken lokaal maar mislukken op GitHub.
Lees het logboek van de mislukte taak en bewaard browserbewijs. Controleer Node-compatibiliteit, browserinstallatie, serverstart, hoofdlettergevoelige paden en overeenstemming met de lockfile.
Persoonlijke notities

Noteer vragen, besluiten of ideeën voor je website. Waar mogelijk opgeslagen in deze browser; exporteer je notities om een kopie te bewaren. Vul nooit geheimen in.

Downloads & opgeslagen voortgangGids, notities en persoonlijke controles

Download de volledige gids of exporteer je notities uit alle hoofdstukken. Instructies voor het laatst gecontroleerd: .

Download gids .md Ga naar startbestanden

Controles en notities blijven in deze browser, apart per taal. Exporteer je notities om ze te bewaren. Vul hier nooit API-sleutels of andere geheimen in.

StartbestandenWerkinstructies en vier skills

Deze sjablonen geven je agent een eerste set werkinstructies. Lees ze, pas ze aan je website aan en sla elk bestand op het getoonde pad op, gerekend vanaf je projectmap.

Een gedownloade skill is een instructiebestand. Het installeert geen testprogramma, voert geen beveiligingsscan uit en bewijst niet dat je site veilig is. De gids laat zien hoe je dat werk opzet en controleert.

Download de instructiebestanden in de taal van deze gids. Houd de technische bestandsnamen en paden gelijk aan de voorbeelden.

Download alle startbestanden .md-bundel
BestandAGENTS.md

Sla op het bovenstaande pad op.

Download bestand
# Werkafspraken voor de website

Dit project volgt de websitebrief en acceptatiecriteria die met de eigenaar zijn afgesproken. Gebruik de bestaande technische keuzes, tenzij een concrete eis om een wijziging vraagt.

## Werkwijze

- Leg bij een grote functie vóór de bouw de voorgestelde wijzigingen en het controleplan uit. Rond toegestaan lokaal werk af in kleine stappen die de eigenaar kan beoordelen.
- Lees de bestanden die bij de taak horen. Houd andere pagina’s en instellingen intact.
- Leg nieuwe technische termen in gewone taal uit wanneer je aan de eigenaar rapporteert.
- Gebruik de skills website-design, clean-code, website-testing en website-security uit de repository wanneer hun werkwijzen van toepassing zijn.
- Leg belangrijke beslissingen en ontbrekende inhoud vast in de projectnotities. Verzin geen bedrijfsfeiten, aanbevelingen of publicatierechten.

## Controle

- Bekijk package.json om de echte commando’s voor bouwen, typecontrole en tests te vinden. Verzin geen geslaagde controle en maak geen betekenisloze test alleen om een commando te laten slagen.
- Voer controles uit die bij de wijziging passen. Lokale tests gebruiken tijdelijke testgegevens en hebben geen toegang tot productie; voer ze uit en herstel fouten door de gevraagde wijziging zonder bij elke stap toestemming te vragen.
- Controleer bezoekersinteracties in een browser wanneer browserhulpmiddelen beschikbaar zijn. Meld controles die onbeschikbaar of onvolledig blijven.
- Toon de eigenaar een werkende lokale preview en vat veranderd gedrag, bewijs en resterende beperkingen samen.

## Toegangsgegevens en publicatie

- Houd API-sleutels en andere geheimen buiten browsercode, prompts, logboeken en Git. Bewaar lokale geheimen in genegeerde bestanden of de gekozen beveiligde opslag.
- Lokaal bouwen en testen is toegestaan. De site publiceren, een echt bericht versturen, een betaling verwerken of productiegegevens wijzigen vereist toestemming van de eigenaar voor die handeling.
- Bewaar vóór publicatie een herstelbare werkende versie. Beschrijf hoe je die terugzet.

Dit zijn basisafspraken voor een nieuw oefenproject. Pas ze aan de echte eisen en al gegeven toestemming van de eigenaar aan.
Bestand.agents/skills/website-design/SKILL.md

Sla op het bovenstaande pad op.

Download bestand
---
name: website-design
description: Ontwikkel of verfijn de visuele richting en responsive interface van een website vanuit de brief, inhoud en het bestaande ontwerp. Gebruik voor paginaontwerp of visuele bouw.
---

Lees de websitebrief en bestaande ontwerpnotities voor de gevraagde pagina. Werk binnen de merkkeuzes, inhoud en technische keuzes van de gebruiker.

Stel bij een nieuwe richting letterkeuzes, een klein kleurenpalet, vaste afstanden en een voorbeeldpagina voor. Leg uit hoe deze keuzes de doelgroep en de hoofdactie van bezoekers ondersteunen. Gebruik echte inhoud om de volgorde van aandacht en regellengtes te beoordelen.

Maak herbruikbare onderdelen voor navigatie, koppen, knoppen en herhaalde inhoud. Geef hoofdacties een duidelijke visuele nadruk. Behoud zichtbare toetsenbordfocus, leesbaar contrast en bruikbare labels. Ontwerp smalle schermen naast desktopschermen; controleer lange koppen, navigatie en aanraakvlakken in een browser.

Gebruik betekenisvolle HTML voordat je aangepaste interactie toevoegt. Maak beweging optioneel en respecteer de voorkeur voor minder beweging. Gebruik materiaal waarvoor publicatierechten bekend zijn en noteer de bronnen. Verzin geen klantbeoordelingen, prestaties of bedrijfsfeiten.

Toon vóór uitbreiding naar alle pagina’s de eerste complete pagina op desktop- en telefoonbreedte. Beschrijf de belangrijkste ontwerpkeuzes en ontbrekende inhoud. Is een browserhulpmiddel onbeschikbaar? Meld dan dat visuele controle nog moet gebeuren.
Bestand.agents/skills/clean-code/SKILL.md

Sla op het bovenstaande pad op.

Download bestand
---
name: clean-code
description: Bouw of herstructureer websitecode tot begrijpelijke onderdelen met de bestaande techniek en afspraken van het project. Gebruik voor websitebouw of onderhoudbaarheid.
---

Lees de relevante bestanden en pakketscripts voordat je een aanpak kiest. Behoud werkend gedrag buiten de gevraagde wijziging. Gebruik bij voorkeur de bestaande techniek en pakketten als die aan de behoefte voldoen.

Houd pagina-inhoud apart van herhaalde opmaak wanneer dat bewerken makkelijker maakt. Geef onderdelen, variabelen en functies namen die hun doel beschrijven. Gebruik gedeelde onderdelen voor herhaalde navigatie en pagina-elementen; maak geen abstractie voor één eenvoudig gebruik.

Verwerk lege, ongeldige, ladende en fouttoestanden bij interacties die dat nodig hebben. Gebruik standaard browserbediening en betekenisvolle HTML wanneer die de interactie ondersteunen. Vermijd nep-formulierverzending, nagebootste succesmeldingen en dode links.

Gebruik typecontrole en de opmaak- of lintregels van het project waar die zijn ingesteld. Leg bij een nieuw pakket het doel en nieuwe onderhouds- of gebruikseisen uit. Houd gegenereerde bouwbestanden, geïnstalleerde pakketten en lokale omgevingsbestanden buiten versiebeheer.

Voer bestaande controles uit die bij de wijziging passen, inclusief een productiebuild wanneer het resultaat kan veranderen. Vat veranderd gedrag, controleresultaten en resterende beperkingen samen. Leg de belangrijkste bestanden in gewone taal uit, zodat een beginner de inhoud kan vinden en aanpassen.
Bestand.agents/skills/website-testing/SKILL.md

Sla op het bovenstaande pad op.

Download bestand
---
name: website-testing
description: Controleer websitewijzigingen met bezoekersroutes, passende automatische tests en browsercontroles. Gebruik bij websitetests, onderzoek naar fouten of voorbereiding op publicatie.
---

Begin met de brief en zichtbare acceptatiecriteria. Bekijk bestaande test- en bouwcommando’s; neem niet aan dat een script bestaat. Kies controles op basis van veranderd gedrag en de gevolgen van een fout.

Doorloop de hoofdroute voor bezoekers en betrokken links, navigatie en formulieren. Neem ongeldige invoer en relevante fouttoestanden mee. Controleer bij een contactformulier echte bezorging op de afgesproken testbestemming voordat je meldt dat het werkt. Leg bij een e-maillink uit dat die het ingestelde mailprogramma van de bezoeker opent en niet automatisch een bericht verstuurt.

Controleer smalle en brede schermen in een browser. Neem toetsenbordnavigatie, zichtbare focus, toegankelijke namen, zoom en horizontaal overlopen mee. Automatische toegankelijkheidsresultaten vullen deze handmatige controles aan en bewijzen geen volledige toegankelijkheidsnaleving.

Voeg automatische tests toe voor belangrijk gedrag of aangetoonde terugkerende fouten. Test zichtbare resultaten en betekenisvolle foutgevallen; vermijd tests die alleen de geschreven code herhalen of toevallige formuleringen vergelijken. Gebruik tijdelijke testgegevens en lokale testbestanden. Verstuur nooit echte berichten, voer geen betalingen uit en wijzig geen productiegegevens zonder toestemming van de gebruiker.

Reproduceer een fout, herstel de oorzaak en voer betrokken controles opnieuw uit. Meld uitgevoerde commando’s, resultaten, browsercontroles en alles wat niet is gecontroleerd. Een geslaagde build toont dat de site kan worden gemaakt; controleer bezoekersgedrag apart. Meld nooit dat een controle geslaagd is als die is overgeslagen of onbeschikbaar was.
Bestand.agents/skills/website-security/SKILL.md

Sla op het bovenstaande pad op.

Download bestand
---
name: website-security
description: Controleer geheimen, pakketten, invoer, toegang en publicatie-instellingen van een website en herstel bevindingen binnen de afgesproken taak. Gebruik voor gevraagde beveiligingscontrole of voorbereiding op publicatie.
---

Breng de relevante onderdelen van de site in kaart: statische pagina’s, formulieren, backend-routes, aanmelding, scripts van derden en opgeslagen gegevens. Beperk de controle tot de echte technische opzet en de toegestane omgeving.

Houd toegangsgegevens buiten browsercode, logboeken, prompts en Git. Maak onderscheid tussen openbare instellingen tijdens de build en servergeheimen. Is een sleutel als commit opgeslagen of blootgesteld? Gebruik hem niet meer, leg uit dat het bestand verwijderen de sleutel niet intrekt en laat de eigenaar hem vóór verder gebruik intrekken of vervangen. Toon de toegangsgegevens niet in je verslag.

Bekijk relevante beveiligingswaarschuwingen voor pakketten en beoordeel of het betrokken pakket en het kwetsbare gedrag worden gebruikt. Herstel binnen compatibele versies en voer de betrokken controles opnieuw uit. Vermijd automatische geforceerde upgrades die de website kunnen breken.

Controleer bij backend-interacties de invoer op de server, geef uitvoer passend gecodeerd weer en controleer aanmelding en toegangsrechten afzonderlijk. Overweeg misbruikbeperking voor openbare formulieren of AI-toegangspunten. Een OpenAI API-sleutel hoort op de server; een statische site publiceren biedt geen geheime serveromgeving.

Controleer HTTPS en relevante beveiligingsheaders bij de echte hosting. Verzamel alleen gegevens die de functie nodig heeft en leg hun bestemming en bewaartermijn uit. Claim geen wettelijke naleving op basis van een codescan.

Meld elke bevinding met locatie, aannemelijke impact, herstel en controle. Beschrijf de reikwijdte, gebruikte hulpmiddelen, openstaande bevindingen en ontoegankelijke onderdelen. Een schone scan is bewijs binnen het bereik van die scan, geen garantie dat de website geen kwetsbaarheden heeft. Scan geen systemen van derden en publiceer geen wijzigingen buiten de toegestane taak.
Terug naar het begin van het hoofdstuk