De kwaliteit van AI-gegenereerde code hangt bijna volledig af van wat je vraagt en hoe je het vraagt. Deze gids behandelt de patronen die consequent betere resultaten opleveren met Claude Code.
Van taakafbakening tot systeem prompts, van iteratieve verfijning tot rol-specifieke instructies. Praktische technieken die je kunt toepassen in je volgende codeersessie.
Wanneer je een menselijke ontwikkelaar vraagt om 'een inlogpagina te bouwen', stellen ze verduidelijkende vragen: welke auth provider? Welke velden? Moet het OAuth afhandelen? Foutmeldingen? Laadstatussen?
AI codeeragents zullen proberen al die vragen zelf te beantwoorden. Soms raden ze goed. Vaak raden ze iets redelijks maar niet wat je wilde. De kloof tussen 'redelijk' en 'precies goed' is wat prompt engineering overbrugt.
Goede prompts hoeven niet lang te zijn. Ze moeten specifiek zijn over de zaken die ertoe doen en stil over de zaken die dat niet doen. Die balans is waar deze gids over gaat.
Patronen die de resultaten verbeteren ongeacht de taak.
In plaats van 'maak een React component, voeg dan state toe, voeg dan styling toe', beschrijf het eindresultaat: 'Bouw een inklapbare zijbalk die projectnamen toont, drag-to-reorder ondersteunt en ons bestaande Tailwind thema gebruikt.' Laat de agent beslissen hoe daar te komen.
Avoid
Maak een component. Voeg useState toe. Voeg een toggle-knop toe. Style het met Tailwind.
Better
Bouw een inklapbare zijbalkcomponent die projecten op naam lijst. Het moet drag-to-reorder ondersteunen en overeenkomen met ons donkere thema (bg-[#111318], border-[#262b38]). Ingeklapte staat moet behouden blijven bij paginavernieuwing.
Agents werken het beste wanneer ze de grenzen kennen. Specificeer welke bestanden te bewerken (of te vermijden), welke patronen te volgen, en hoe 'klaar' eruitziet. Onbegrensde taken leiden tot uitgestrekte veranderingen die moeilijk te beoordelen zijn.
Avoid
Refactor het authenticatiesysteem.
Better
Refactor de login handler in src/api/auth/login.ts om bcrypt te gebruiken in plaats van sha256 voor wachtwoord hashing. Verander de JWT-logica of de sessie cookie-afhandeling niet. Update de gerelateerde tests in tests/auth/.
Claude Code kan je projectbestanden lezen, maar niet je gedachten. Als er een conventie is die je volgt, een bibliotheek die je verkiest, of een patroon dat je al hebt vastgesteld, zeg het dan. Dit bespaart herwerk.
Avoid
Voeg formulier validatie toe.
Better
Voeg formulier validatie toe aan het aanmeldformulier met behulp van zod (we gebruiken het al voor het instellingenformulier in src/forms/settings.ts). Toon inline foutmeldingen onder elk veld. Volg dezelfde foutstyling als het inlogformulier.
Samengestelde prompts ('bouw de API, schrijf tests, update de docs en implementeer') dwingen de agent om te veel doelen tegelijk vast te houden. Breek complex werk op in opeenvolgende, gerichte taken. Elk bouwt voort op het vorige resultaat.
Avoid
Bouw de gebruikersprofielpagina, schrijf API-eindpunten, voeg tests toe, update de README en repareer de navigatiebalk terwijl je bezig bent.
Better
Bouw de GET /api/user/profile eindpunt. Retourneer id, naam, e-mail en plan velden. Gebruik de bestaande auth middleware voor authenticatie.
Als het eerste resultaat niet juist is, verfijn dan de prompt in plaats van opnieuw te beginnen. Claude behoudt de volledige gesprekscontext. Zeg wat er mis is, wat er moet veranderen en wat moet blijven. Iteratie is sneller dan heruitvinding.
Avoid
Dat is fout. Begin opnieuw en bouw het component anders op.
Better
De lay-out is goed, maar het mobiele breekpunt is verkeerd. Onder 768px stapel je de kaarten verticaal in plaats van een raster te gebruiken. Houd de rest hetzelfde.
Systeem prompts stellen het basisgedrag in voor een agent voordat je iets zegt. Ze zijn het meest onderbenutte hulpmiddel in AI-codering.
Een systeem prompt vertelt de agent wie het is, waarop het zich moet concentreren en wat het moet vermijden. Het geldt voor elk bericht in de sessie. Zie het als de functiebeschrijving van de agent.
AgentsRoom wordt geleverd met 14 rol-specifieke systeem prompts: één voor elk type agent. De prompt van de Frontend agent vertelt het zich te concentreren op componenten, toegankelijkheid en responsief ontwerp. De prompt van de QA agent vertelt het om na te denken over randgevallen en uitgebreide tests te schrijven. Je kunt deze aanpassen of je eigen schrijven.
Je bent een senior frontend ontwikkelaar. Focus op React componenten, CSS/Tailwind styling, toegankelijkheid (WCAG AA) en responsief ontwerp. Gebruik de bestaande componentenbibliotheek van het project voordat je nieuwe componenten maakt. Geef de voorkeur aan compositie boven overerving. Schrijf semantische HTML. Wijzig nooit backend bestanden.
De meest effectieve prompt wordt niet in een chat getypt. Het leeft in je repository.
CLAUDE.md is een markdown-bestand in de root van je project dat Claude Code automatisch leest. Het bevat projectstructuur, conventies, stackdetails en richtlijnen die van toepassing zijn op elke agent sessie in het project.
In plaats van 'we gebruiken Tailwind CSS 4, Prisma ORM en Next.js 16' in elk gesprek te herhalen, schrijf je het een keer in CLAUDE.md. Elke agent erft deze context. AgentsRoom bevat een ingebouwde editor voor CLAUDE.md zodat je het kunt bijwerken zonder de app te verlaten.
Een goed geschreven CLAUDE.md is meer waard dan tientallen zorgvuldig samengestelde individuele prompts. Het stapelt op: elke sessie profiteert ervan.
Stop met het herschrijven van dezelfde instructies. Bewaar wat werkt en hergebruik het.
Als je merkt dat je hetzelfde soort verzoek typt in verschillende projecten ('schrijf unittests voor dit bestand', 'refactor dit om het repository patroon te gebruiken', 'voeg foutafhandeling toe aan alle API-routes'), sla het dan op als een herbruikbare prompt.
AgentsRoom bevat een prompt bibliotheekfunctie met twee niveaus: project-specifieke prompts voor project-specifieke taken, en globale prompts (cloud-gesynchroniseerd) voor patronen die je overal gebruikt.
Goede kandidaten voor bibliotheek prompts: code review checklists, testschrijfsjablonen, migratiescripts, component scaffolding instructies, beveiligingsaudit stappen. Alles wat je in een teamwiki zou zetten als standaardprocedure.
Schrijf unittests voor [bestand]. Gebruik vitest. Dek het happy path, randgevallen (lege invoer, null, ongeldige types) en foutafhandeling. Mock externe afhankelijkheden. Streef naar >90% branch dekking.
Beoordeel de wijzigingen in de huidige git diff. Controleer op: ongebruikte imports, ontbrekende foutafhandeling, typeveiligheidsproblemen, potentiële racecondities en naamgevingsinconsistenties. Stel oplossingen voor voor elk gevonden probleem.
Maak een REST-eindpunt voor [resource]. Voeg invoervalidatie toe met zod, juiste foutreacties (400, 401, 404, 500), TypeScript-typen voor verzoek/antwoord en een JSDoc-commentaar dat het eindpunt beschrijft. Volg het bestaande patroon in src/api/.
Technieken voor complexe taken die verder gaan dan enkele prompts.
Breek een grote taak op in geordende stappen. Start de eerste agent met stap één, wacht op voltooiing en start dan de volgende agent met stap twee (verwijzend naar de output van stap één). Elke stap is kleiner en meer gefocust. Voorbeeld: Agent 1 ontwerpt het databaseschema, Agent 2 schrijft de API met dat schema, Agent 3 schrijft tests tegen de API.
Nadat een agent klaar is, wijs een andere agent op de output. 'Beoordeel de wijzigingen die de frontend-agent zojuist heeft gemaakt in src/components/. Controleer op toegankelijkheidsproblemen en ontbrekende foutstatussen.' Een frisse agent met een andere rol ziet dingen die de oorspronkelijke agent heeft gemist.
Begin met een losse prompt om te zien hoe de agent het probleem benadert. Voeg vervolgens beperkingen toe in vervolgberichten: 'Goede structuur, maar gebruik servercomponenten in plaats van clientcomponenten.' 'Behoud de hook, maar verwijder de useEffect en gebruik een React Query-mutatie in plaats daarvan.' Elke iteratie leidt naar de oplossing die je wilt.
Wijs de agent op bestaande code: 'Bouw een instellingenpagina volgens hetzelfde patroon als src/pages/profile.tsx. Zelfde lay-outstructuur, zelfde formulierafhandeling, zelfde foutweergave.' Dit is vaak effectiever dan het patroon in woorden beschrijven.
Patronen die consequent slechtere resultaten opleveren.
De agent precies vertellen welke functies te schrijven, welke variabelen te benoemen en in welke volgorde dingen te implementeren. Deze micromanagement neemt de mogelijkheid van de agent weg om een betere aanpak te vinden. Beschrijf het resultaat, niet de procedure.
Een agent vragen om 'de codebase te verbeteren' zonder beperkingen. Zonder grenzen kan de agent bestanden refactoren die je niet wilde aanraken, APIs wijzigen waar andere code van afhankelijk is, of tokens besteden aan verbeteringen met lage prioriteit.
Niet vermelden dat een patroon, hulpprogramma of component al in het project bestaat. De agent zal een nieuwe maken. Een eenvoudig 'we hebben al een useAuth hook in src/hooks/' bespaart aanzienlijk herwerk.
Vijf taken in één bericht proppen. De agent zal proberen ze allemaal uit te voeren, maar de kwaliteit daalt naarmate het concurrerende doelen moet jongleren. Splits ze op in opeenvolgende, gerichte verzoeken.
AgentsRoom biedt je systeemprompts, een promptbibliotheek en CLAUDE.md bewerken ingebouwd. Minder tijd aan het maken van prompts, meer tijd aan bouwen.
Companion-app: houd je agents onderweg in de gaten
Breng je eigen: Claude, Codex, Antigravity CLI of andere AI-provider.
Stuur bugs en verzoeken direct naar je openbare backlog.
Een glimp van AgentsRoom in actie.