Kijk rond op deze website en schrijf in de notities wat je vindt: welk
systeem het is, waar de thema-bestanden staan, welke plugins ertoe doen en
wat ik hier nooit mag weggooien.
Een nieuw gesprek met de assistent begint leeg. Hij weet niet wat jullie vorige week deden en hij weet niet dat dat ene mapje met oude bestanden er met een reden staat. Daarom heeft elke website op je account een eigen set notities. Die leest hij aan het begin van elk gesprek, voordat hij aan je opdracht begint. Het is het verschil tussen een assistent die elke keer opnieuw moet zoeken en een assistent die je site al kent.
Waar de notities staan
De notities horen bij een website, niet bij een gesprek. Ze staan buiten de webroot van die site. Dat is een bewuste keuze met twee gevolgen die je wilt weten: bezoekers kunnen ze niet opvragen, en ze komen niet mee in je git-repository. Je kunt dus vrij opschrijven hoe de vork in de steel zit zonder dat het op internet belandt.
Je bekijkt en bewerkt ze in de assistent via het paneel Notities. Werk je liever in de terminal, dan hoef je niets extra te doen: een sessie die je via SSH of de terminal in het panel start, krijgt dezelfde notities mee. Gebruik je Codex in plaats van Claude, dan leest die hetzelfde bestand.
Naast de notities per website kent de assistent een aantal accountfeiten: welk pakket je hebt, welke websites op je account staan, waar de dingen op onze servers staan. Die zet het platform er zelf in. Daar hoef je niets aan te doen.
De eerste keer: laat hem rondkijken
Bij een website zonder notities biedt de assistent zelf aan om rond te kijken. Eén klik en hij loopt de site langs: welk systeem erop staat, hoe de mappen in elkaar zitten, welk thema actief is, welke plugins of pakketten meedoen. Dat resultaat zet hij in de notities.
Bij een leeg domein werkt het de andere kant op. Dan stelt hij een paar vragen over het bedrijf, het doel van de site en de pagina's die je wilt. Die antwoorden komen ook in de notities terecht, zodat de site die er daarna uitkomt niet in een volgend gesprek weer vreemd aandoet.
Dit is de stap die mensen overslaan. Doe hem één keer, aan het begin, en elk gesprek daarna is korter.
Wat je er zelf in zet
De beste notities zijn kort en gaan over besluiten, niet over techniek die hij zelf kan zien. Denk aan:
- Afspraken. "De huisstijlkleur is dit blauw, gebruik nooit een andere." "Titels altijd in de vorm vraag plus antwoord."
- Grenzen. "De map met oude facturen nooit weggooien, die is nog nodig." "Dit formulier niet aanraken, dat doet de boekhouder."
- Context die je nergens kunt aflezen. "Deze site is in augustus verhuisd." "De oude adressen staan nog in Google, dus doorverwijzingen moeten blijven."
- Wie wat beslist. "Nieuwe teksten eerst naar mij, niet live zetten."
En wat er niet in hoort: wachtwoorden, sleutels en tokens. Niet omdat het bestand slecht beveiligd is, maar omdat het een plek is die je opzettelijk makkelijk deelt en vaak kopieert. Voor inloggegevens gebruik je de plekken die daarvoor bedoeld zijn.
Hij schrijft zelf ook mee
De assistent mag de notities zelf bijwerken, zonder jou daar met een goedkeuringskaart voor lastig te vallen. Dat is prettig, want zo blijven ze actueel na een verbouwing. Het heeft ook een keerzijde: er kan onzin in belanden, bijvoorbeeld een aanname die hij deed en die jij nooit hebt bevestigd.
Daarom de gewoonte die wij aanraden: lees het paneel één keer per maand na, of na een grote klus. Staat er iets dat niet meer klopt, haal het weg. Een notitie die niet klopt is slechter dan geen notitie, want hij gaat er elk gesprek opnieuw van uit.
Elke taak begint opnieuw
Dit is het punt dat we zelf pas goed begrepen tijdens het bouwen van onze eigen demo-sites. Wij gaven de assistent vier opdrachten achter elkaar, elk in een nieuw gesprek. Alles wat hij in opdracht 1 had uitgezocht, was in opdracht 2 verdwenen, behalve wat in de notities stond.
Praktische les: sluit een grote opdracht af met "schrijf in de notities wat je hebt gedaan en wat er nog open staat". Dan is de volgende opdracht een vervolg in plaats van een herstart. Wil je echt verder in hetzelfde gesprek, dan kun je een eerder gesprek hervatten; dat is iets anders dan de notities en bewaart de hele draad.
Leegmaken is weggooien
In het paneel geldt: sla je de notities leeg op, dan verdwijnt het bestand. Dat is handig als je met een schone lei wilt beginnen, en het is een valkuil als je alleen even wilde opruimen. Kopieer de tekst eerst ergens heen als je hem nog wilt kunnen terugkijken.
Veelgemaakte fouten
"Hij vergeet alles wat we hebben afgesproken." Afspraken in de chat zijn afspraken voor dat gesprek. Zet ze in de notities, dan gelden ze morgen ook.
"Ik heb er drie kantjes in gezet en nu doet hij vreemd." Notities gaan elk gesprek mee als uitgangspunt. Hoe langer ze zijn, hoe meer tegenstrijdigheden erin kruipen en hoe minder gewicht elke regel heeft. Houd het bij de dingen die een vreemde niet kan raden.
"Er staat iets in dat ik nooit heb gezegd." Dat kan: hij werkt ze zelf bij. Haal het weg en zet er zo nodig het goede antwoord bij.
"Ik zocht de notities in mijn website-bestanden." Daar staan ze niet, met opzet. Ze staan buiten de webroot en je bereikt ze via het paneel in de assistent.
"Ik dacht dat de notities mijn vorige gesprek waren." Dat zijn twee verschillende dingen. De notities zijn een korte samenvatting van de website; een gesprek hervatten haalt de hele draad terug, inclusief wat er precies is gewijzigd. Zie ook Wat als de assistent stilvalt.