Applying SHAPR in AI-Assisted Research Software Development: Lessons Learnt from Building a Share Trading System

Stel je voor dat je een heel complexe machine bouwt, zoals een robot die aandelen op de beurs koopt en verkoopt. Vroeger deed je dit alleen, met pen en papier en veel geduld. Vandaag de dag heb je een superkrachtige assistent: Generatieve AI. Deze assistent kan code schrijven, ideeën bedenken en fouten vinden.

Maar hier zit een addertje onder het gras: als je te snel gaat met je AI-assistent, raak je de draad kwijt. Je weet later niet meer waarom je iets zo hebt gedaan, de namen van je onderdelen veranderen willekeurig, en je project wordt een rommelige berg papierwerk waar niemand meer doorheen komt.

Dit artikel vertelt het verhaal van een onderzoeker die een oplossing bedacht, genaamd SHAPR. Laten we SHAPR uitleggen met een paar creatieve vergelijkingen.

1. Wat is SHAPR? (De Regisseur en de Acteur)

SHAPR staat voor Solo, Human-centred, AI-assisted PRactice.
Stel je voor dat je een film draait.

• De AI is de acteur. Hij is briljant, kan snel tekst leren, en speelt elke rol. Maar hij weet niet wat het einddoel is en hij vergeet soms de regie.
• Jij (de onderzoeker) bent de regisseur. Jij bepaalt het verhaal, houdt de visie vast en zorgt dat de acteur niet uit zijn rol valt.

SHAPR is de manier waarop je als regisseur werkt met je acteur. Het zorgt ervoor dat je de controle behoudt, terwijl je de snelheid van de AI gebruikt.

2. Het Probleem: De "Witte Lijst" vs. De "Zwarte Doos"

Zonder SHAPR werkt het zo: Je praat met de AI, die code schrijft. Je kopieert die code. Je praat weer met de AI. Je kopieert weer.
Na een tijdje heb je een "zwarte doos" van code, maar je weet niet meer welke versie de juiste is, of waarom je een bepaalde knop blauw hebt gemaakt in plaats van rood. Het is alsof je een huis bouwt zonder blauwdrukken; de muren staan er, maar je weet niet of ze veilig zijn.

3. De Oplossing: De "Drie Kamers" Methode

De onderzoeker in dit artikel bouwde zijn aandelenrobot niet in één grote rommelige kamer. Hij gebruikte drie specifieke "kamers" (software-tools) die perfect samenwerkten:

• Kamer 1: De Studio (ChatGPT)
  Hier praat je met de AI. Het is een levendige, chaotische plek waar ideeën worden geboren. Je vraagt: "Hoe lossen we dit probleem op?" en de AI geeft tien antwoorden.

  • Vergelijking: Dit is je brainstormsessie met een team van genieën.

• Kamer 2: De Werkplaats (PyCharm)
  Hier wordt de daadwerkelijke code geschreven en getest. Het is de plek waar de robot fysiek wordt gebouwd.

  • Vergelijking: Dit is de fabrieksvloer waar de schroeven worden vastgedraaid.

• Kamer 3: Het Dagboek (Obsidian)
  Dit is het belangrijkste geheim. Hier schrijf je direct op wat er gebeurt. Niet aan het einde van de dag, maar terwijl je werkt.

  • Vergelijking: Dit is je dagboek of logboek. Als je in de studio een briljant idee hebt, schrijf je het direct in het dagboek. Als je in de werkplaats een fout maakt, noteer je dat ook.

4. De Magische Technieken (De "Quick Captures")

Het grootste geheim van SHAPR is iets dat ze "Quick Captures" noemen.
Stel je voor dat je een vis vangt. Als je wacht tot je thuis bent om de vis te beschrijven, is hij misschien al dood of verrot.

• Quick Capture: Je schrijft direct op: "Vis gevangen, groot, zilverkleurig." (Dit kost maar 10 seconden).
• AI-Refinement: Later, als je rustig zit, laat je de AI dit korte zinnetje omzetten in een mooi, gestructureerd verslag: "Vandaag hebben we een grote zilveren vis gevangen in de Noordzee. Dit suggereert dat..."

Zo houd je alle informatie levend, zonder dat het je werk vertraagt.

5. De Vijf Grote Lerenlessen

Uit het bouwen van deze aandelenrobot trokken ze vijf belangrijke lessen, die je ook kunt toepassen op elk project:

1. De Regelsboek (Contracts):
   Voor je begint, schrijf je de regels op: "Dit onderdeel heet altijd zo, en doet altijd dit." Dit voorkomt dat de AI later dingen verandert die je niet wilt.

   • Vergelijking: Het is als de bouwvergunning voor je huis. Zonder die vergunning bouwt de aannemer een raam waar een deur moet komen.

2. De Waarheidslayer (Source-of-Truth):
   Er moet altijd één document zijn dat de "waarheid" vertelt over hoe het project er nu uitziet. Als je dit niet hebt, werk je met oude informatie.

   • Vergelijking: Het is de GPS in je auto. Als je de verkeerde kaart gebruikt, kom je nergens.

3. De Foto's op de Grens (Snapshots):
   Aan het einde van elke bouw-fase (bijvoorbeeld: "De motor is klaar"), maak je een foto van de hele situatie.

   • Vergelijking: Het is alsof je elke avond je kamer op de foto zet. Als je de volgende dag door de rommel loopt, weet je precies hoe het gisteren was en wat je moet opruimen.

4. Samen Groeien:
   De code en het dagboek groeien samen. Je schrijft niet pas aan het einde; je schrijft terwijl je bouwt.

   • Vergelijking: Het is als een boom. De wortels (code) en de bladeren (documentatie) groeien tegelijkertijd. Als je alleen de wortels plant en pas later de bladeren tekent, ziet de boom er raar uit.

5. De Omgeving is Leerrijk:
   Het opzetten van je werkomgeving (de drie kamers) is al een leerproces op zich.

   • Vergelijking: Het is alsof je een keuken inricht. Het proces van kiezen waar de koelkast en het fornuis staan, leert je al hoe je het beste gaat koken.

Conclusie

Dit artikel zegt eigenlijk: Gebruik AI als een krachtige hulpmiddel, maar blijf de baas.

Gebruik SHAPR om je project niet in een rommelige berg papier te laten verdwijnen. Door direct te noteren, regels te stellen en je werk in fases te verdelen, bouw je niet alleen een goede software, maar ook een duidelijk verhaal over hoe je er gekomen bent. Zo kun je later, of zelfs iemand anders, precies uitleggen hoe de magie werkte.

Kortom: Laat de AI rennen, maar houd jij de teugels vast in je dagboek.