TUTORIAL | Workstation Setup voor Conduction-developers

[WilcoLouwerse]

Achtergrond

Een Conduction-werkplek heeft een specifieke combinatie van tools nodig: Claude Code, Docker, Nextcloud lokaal, Playwright, een hand vol globale settings en hooks, en een werkende GitHub-CLI. Nieuwe medewerkers verliezen vaak hun eerste dag(en) met setup-puzzels die we al hebben opgelost.

Doel

Een Nederlandstalige, publieke tutorial op conduction.nl/academy die een nieuwe developer in één avond een werkende Conduction-werkplek bezorgt — getest op een schone laptop.

Doelgroep

Nieuwe Conduction-developers, stagiairs, partner-developers die voor het eerst met onze stack werken.

Voorgestelde structuur (chaining)

Liever een ketting van kleine tutorials dan één lange installatiegids:

1. Wat installeer je en waarom? — overzicht, beslissingen (WSL2, Docker Desktop, native, etc.). Linkt door naar 2.
2. Werkplek inrichten — basis — Git, Node, PHP, Docker, GitHub-CLI, editor. Linkt door naar 3.
3. Claude Code installeren en configureren — installatie, login, globale settings, hooks. Linkt door naar 4.
4. MCP-server koppelen — onderdeel van een complete werkplek; verwijst naar de aparte tutorial Zet de Conduction MCP-server op en .mcp.json op je project-root. Linkt door naar 5.
5. Nextcloud lokaal draaien — verwijst naar bestaande tutorial Nextcloud lokaal draaien als ze die nog niet hebben.
6. Klaar — wat nu? — verwijzingen naar OpenSpec-, Skills- en Build-an-app-tutorials.

Overlap met de MCP-tutorial: MCP-configuratie is een deel van werkplek-inrichting. We splitsen het in twee tutorials zodat Workstation Setup kort blijft en de MCP-tutorial dieper kan ingaan op wat MCP is en hoe je de Conduction MCP-server draait. Workstation Setup verwijst dóór; de MCP-tutorial verwijst terug ("Doe eerst Workstation Setup als je nog geen werkende .mcp.json hebt"). Coördineer de scheidslijn bij het schrijven met issue #55.

Bestaande documentatie (referenties)

In /home/wilco/.github/docs/claude/ staat al veel:

• docs/claude/workstation-setup.md
• docs/claude/getting-started.md
• docs/claude/docker.md
• docs/claude/global-claude-settings.md
• docs/claude/playwright-setup.md
• docs/claude/local-llm.md

Pluvo-vragen (minimaal 4)

Voorbeelden:

1. Welke combinatie van OS + tooling adviseert Conduction, en waarom?
2. Wat is het verschil tussen globale en project-specifieke Claude-settings?
3. Welke hooks zijn standaard aanbevolen, en wat doen ze?
4. Hoe controleer je dat je gh-cli correct is gekoppeld aan je GitHub-account?
5. Wat is de eerste tutorial die je doet nadat je werkplek klaar is?

Op te leveren

• Tutorial(s) in MDX op ConductionNL/conduction-website onder academy/
• Getest op een schone (W11/macOS/Linux) machine — minimaal één OS bevestigd
• Minimaal 4 Pluvo-vragen per deel
• Cross-links naar Nextcloud-lokaal, MCP-server (issue #55), OpenSpec, Skills, Build-an-app
• Linkcheck
• Peer review

Schrijfstijl

Volg de Conduction-schrijfstijl (zie identity.conduction.nl). Voorbeeldstructuur: Bestanden bij een Woo-publicatie uploaden. Liever vijf korte dan één megagids.

Tijdregistratie

Uren op dit issue boeken op de Jira-issue van het SLIM-account.