Hoe je Claude Code organiseert voor productwerk

Mijn Claude Code-workspace voor mijn werk als productmanager is een map met bijna geen code. Hij bevat een contextmap met alles over het bedrijf: het product, de gebruikers, de concurrenten en hoe ik graag werk. Er is één map per project, waarbij de taken gescheiden zijn van de deliverables. Daarnaast is er een set 'skills' die elk één terugkerend stuk werk uitvoeren: de statusupdate, de PRD-review, de synthese van interviews. Wanneer ik eenmaal feedback geef, landt deze in een bestand met een notitie over het waarom, en ik hoef die feedback nooit meer te geven. Ik heb dit systeem niet zo ontworpen; ik ben er op uitgekomen, voornamelijk door eerst de fouten te maken.

Het maken van die fouten leerde me de les die centraal staat in dit artikel: voorbij de basis hangen je resultaten in Claude Code niet meer af van hoe goed je prompt, maar van hoe goed je archiveert (filing). Een goede prompt verbetert één sessie; een goed bestand verbetert elke sessie daarna. Het advies over prompt-tuning dat je waarschijnlijk al hebt gelezen, stopt met helpen op het exacte punt waar archiveren belangrijk wordt.

In plaats van mijn systeem alleen te beschrijven, heb ik het gebundeld. De starter workspace is openbaar op GitHub: de mappen, de context-templates en vijf PM-skills, gepersonaliseerd via één setup-interview. Je hoeft niet technisch te zijn om dit te volgen; elke stap is uitgeschreven, inclusief het installeren van de tools. Hoewel mijn voorbeeld een baan als productmanager is, past dezelfde architectuur bij elk contextrijk werk: de onderzoeksbibliotheek van een design lead, de metriekdefinities van een datateam of de 'alles-map' van een oprichter.

De routekaart

  • De overstap: Wat chatmodus en Cowork je niet kunnen geven, en waarom de terminal waardevol is voor een productmanager.
  • De starter workspace: Downloaden, de setup-skill draaien en een echte taak uitvoeren in zes stappen.
  • De praktijken: Zes acties die het systeem laten groeien, inclusief wat je precies moet doen en wat het resultaat is.
  • Het ritme: Hoe een normale werkdag eruitziet binnen dit systeem, van de eerste korte prompt tot de tweeminuten-archiveringsgewoonte.

---

Wat chatmodus je niet kan geven

Vandaag de dag voer je je productwerk waarschijnlijk uit via de chat van Claude: een browsertabblad of de desktop-app, eventueel Cowork voor agentische taken. Dat werkt, en dat is precies de valkuil. Elk gesprek begint bij nul. Het strategiedocument dat je vorige keer uploadde is weg, de context die je geduldig hebt uitgelegd leeft in een thread die je nooit meer zult vinden, en de output die je leuk vond zit gevangen in een gesprek in plaats van in een bestand. Chat is een geweldige plek om te denken, maar een verschrikkelijke plek om kennis te accumuleren. Voor incidentele vragen is dat prima, maar voor dagelijks productwerk betekent het dat je elke ochtend opnieuw de opstartkosten betaalt.

Claude Code is dezelfde Claude, maar met een ander thuis: een map op je machine die hij kan lezen, navigeren en beschrijven. Context leeft in bestanden die blijven bestaan. Terugkerend werk leeft in skills die op commando worden uitgevoerd. Outputs landen als documenten die je bewaart, niet als berichten waar je doorheen moet scrollen. In mijn dagelijkse gebruik werkt alles wat ik voorheen in chat of Cowork deed hier beter, omdat niets ooit twee keer hoeft te worden uitgelegd.

Wat mijn werk echt heeft veranderd, is de onderliggende terminal. Claude Code spreekt native met GitHub; hij kan een bedrijfsrepository ophalen en vragen beantwoorden over de code, en hij kan je eigen werk pushen. Voor een productmanager is dat een directe lijn naar de codebase en een manier om je hele systeem te delen, iets wat chat simpelweg niet heeft.

Wat men je echter niet geeft, is het archiveringssysteem dat dit alles laat renderen. De best-practices gids van Anthropic is geschreven voor engineers; zij krijgen hun structuur gratis omdat de codebase al georganiseerde context is. PM-gidsen vertellen je vaak wel om productdata en documentatie in lokale Markdown-bestanden op te slaan, maar niet hoe je dat organiseert. De starter workspace is het antwoord op die vraag.

---

Starten met de starter workspace

De starter workspace is de structuur waarop ik mijn eigen werk draai, omgezet in een template: mappen, contextbestanden met placeholders, een voorbeeldproject en vijf reeds geïnstalleerde skills. Het geheel is gratis en openbaar: claude-code-pm-starter.

Let op: Je hebt een betaald Claude-plan nodig voor Claude Code.

Stap 1: Installeer VS Code

Claude Code draait in een terminal, maar een terminal alleen is onhandig voor een productmanager omdat je je bestanden niet ziet. De oplossing is een IDE (Integrated Development Environment). Download VS Code (gratis). Je zult er geen code in schrijven, maar het gebruiken als zijpaneel om te zien hoe je workspace zich organiseert terwijl je werkt.

Stap 2: Download de workspace

Ga naar de repository-pagina op GitHub, klik op de groene Code-knop en kies Download ZIP. Pak het bestand uit en verplaats de map naar een plek waar je je werk bewaart (bijv. in je home-directory).

Stap 3: Openen in VS Code en terminal instellen

  1. Open VS Code → File → Open Folder → selecteer de uitgepakte map.
  2. Open de terminal via Terminal → New Terminal.
  3. De truc: Klik met de rechtermuisknop op de header van het terminalpaneel en kies Move Panel Right. Nu heb je je bestanden links en de AI-agent rechts, wat aanvoelt als een collega die naast je documenten zit.

Installeer Claude Code via de officiële gids (één commando in de terminal) en typ vervolgens claude en druk op Enter.

Stap 4: Begroeting en basiscommando's

Typ eerst hello en vraag Claude wat hij in deze map ziet. Leer daarna de volgende slash-commando's:

  • /model – Bekijk en wissel het huidige model.
  • /effort – Stel in hoeveel denkwerk Claude per antwoord doet (hoog voor complex werk, laag voor snelle concepten).
  • /mcp – Beheer live verbindingen met tools zoals Jira, Slack of Confluence.
  • /plugins – Open het pluginsysteem. Installeer specifiek de pm-skills plugin voor toegang tot meer dan honderd PM-vaardigheden (zoals pm-execution en pm-product-discovery).

Modi van Claude Code (Shift+Tab om te wisselen):

  • Default mode: Vraagt toestemming voordat een bestand wordt aangepast.
  • Auto-accept: Past wijzigingen direct toe zonder te vragen.
  • Plan mode: Claude onderzoekt en stelt een plan voor; er verandert niets tot jij akkoord gaat.

Stap 5: Run de setup skill

Typ /setup-workspace. Deze skill interviewt je over je bedrijf, product, gebruikers en werkwijze, en vult vervolgens de contextbestanden in. Je kunt links naar publieke sites of Confluence-pagina's plakken zodat Claude de informatie zelf kan lezen.

Stap 6: Geef een echte taak

Eindig de sessie niet bij de setup; geef Claude direct iets echt te doen. Bijvoorbeeld:

  • Typ /status-update om een update te laten schrijven op basis van het projectbestand.
  • Of: "Draft the kickoff brief for [project]. Match my writing preferences in context/preferences.md. Check the open questions in the project’s tasks.md before concluding anything."

---

Ga verder met zes praktijken

De starter-structuur is gebaseerd op praktijken die ik heb ontwikkeld door eerst fouten te maken. Dit zijn de acties die het systeem laten groeien:

1. Gebruik het voor elke taak, elke dag

Maak van de workspace je standaardplek, zelfs als chat sneller voelt. De eerste keer dat een nieuwe taak wordt uitgevoerd kost het tijd (uitleggen, corrigeren), maar omdat deze uitleg in een bestand landt, begint de tweede run met een voorsprong.

De afsluitende actie: Wanneer een taak klaar is, vraag je Claude om wat hij heeft geleerd te 'banken': "We zijn klaar; maak hier een skill van, bevestig de nieuwe feiten in de contextbestanden en update mijn preferences-bestand met de feedback die ik heb gegeven."

2. Sorteer bestanden op basis van hoe snel ze veranderen

Stel jezelf niet de vraag "bij welk onderwerp hoort dit?", maar "hoe snel verandert dit?".

  • Context (context/): Informatie die nauwelijks verandert (positionering, productdefinitie).
  • Projecten (projects/): Informatie met een gemiddelde snelheid (briefing vs. takenlijst).
  • Operaties (operations/): Informatie die dagelijks/wekelijks verandert (meeting notes met datum in de bestandsnaam).

MCP's (live verbindingen) zijn voor zaken die per uur veranderen. Bestanden zijn voor zaken die langzaam veranderen. Dit voorkomt dat verouderde context wordt hergebruikt als actuele waarheid.

3. Laat Claude de kaart bijhouden

CLAUDE.md is het enige bestand dat elke sessie laadt; het is de kaart van je systeem. Je raakt dit bestand bijna nooit handmatig aan. Wanneer je een nieuwe skill of context toevoegt, update Claude de kaart zelf. Houd deze kaart klein (onder de 200 regels) om het 'aandachtbudget' van de AI niet te verspillen; de kaart wijst alleen naar waar de kennis staat, hij bevat de kennis niet zelf.

4. Zet herhaalwerk om in skills

Hanteer dit onderscheid: Zelfstandige naamwoorden gaan in bestanden, werkwoorden gaan in skills.

  • Namen (Kennis): Productfeiten, gebruikerssegmenten → context/.
  • Werkwoorden (Acties): Concepten schrijven, reviews uitvoeren, synthesiseren → Skills.

Een skill encodeert stappen, een kwaliteitsstandaard en een output-formaat.

5. Archiveer elke correctie één keer

Een correctie in chat is vergankelijk; een correctie in een bestand is permanent. Begin met context/preferences.md en schrijf drie regels over je schrijfstijl (zinslengte, openingen, verboden woorden). Gebruik daarna de /file-feedback skill bij elke correctie:

  • Was het een eenmalige fout? → Laatten rusten.
  • Mist er een feit? → Naar contextbestand of projectbrief.
  • Fout in proces? → Update de skill.
  • Smaak/stijl? → Naar preferences.

Regel: Als je het twee keer hebt gezegd, hoort het in een bestand.

6. Vraag eerst voordat je aannames doet

Stel jezelf niet beperkt door te denken dat iets "te technisch" is voor een PM. Plak de documentatie van een tool in Claude Code en vraag om een prototype of een stapsgewijze handleiding. Omdat je context en voorkeuren al zijn gearchiveerd, is het goedkoop om experimenten uit te voeren.

---

Je dag door de workspace leiden

Een werkdag ziet er als volgt uit:

  1. Start: Open de projectmap in VS Code → start claude. De map laadt en Claude weet direct waar alles staat.
  2. Prompting: Prompts worden korter omdat de context al bekend is. Een goede prompt bevat nu alleen: het doel (één zin), niet-onderhandelbare beperkingen en wat er geverifieerd moet worden.
  3. Uitvoering: Gebruik Plan mode voor grote taken.
  4. Afsluiting: Besteed twee minuten aan de file-feedback skill. Controleer: heb ik iets gecorrigeerd wat ik al eerder deed? Is er een nieuw feit? Is er werk herhaald dat een skill kan worden?
  5. Schoonmaak: Eens per zoveel sessies besteed je 15 minuten aan het snoeien van verouderde context. Verouderde informatie is schadelijker dan ontbrekende informatie.

Conclusie

Het verschil zit hem niet in de intelligentie van Claude, maar in het feit dat ik stop met het voeren van hetzelfde gesprek twee keer. De bedrijfsuitleg staat in context/, feedback staat in skills en voorkeuren.

Dit systeem is breed toepasbaar:

  • Discovery PM: Archiveert interviews als gedateerde outputs → skill voor synthese.
  • Platform PM: Stable context bevat API-consumenten en versiebeleid.
  • Founder: Maakt van de investeerdersupdate een skill gevoed door een metrics-bestand.
  • Design Lead: Archiveert critiquestandaarden één keer in plaats van ze elke review opnieuw uit te leggen.

Begin klein: download de workspace, run het setup-interview en voeg je schrijfvoorkeuren toe. De volgende keer dat je Claude iets voor de tweede keer vertelt, weet je precies waar het moet worden gearchiveerd.