Marktmannen wiki Context Engineering en Geheugen

AI Stijlgids

Laatst bijgewerkt

TL;DR: Een document dat een LLM jouw schrijfstijl aanleert door onderbewuste patronen expliciet te maken — niet als prompt maar als herbruikbaar systeem dat onder élke prompt actief blijft.

Een AI-stijlgids is fundamenteel anders dan een traditionele stijlgids. Een traditionele gids lost inconsistentie op (meerdere schrijvers, één stem). Een AI-stijlgids lost het tegenovergestelde op: een model is van nature perfect consistent — dat is waarom het op niemand klinkt. De uitdaging is het model naar de eigenaardigheid te duwen die schrijven van een specifiek persoon maakt.

Stijlgids ≠ prompt. Een prompt zegt wat de AI moet doen. Een stijlgids is het herbruikbare systeem eronder dat vertelt hoe de AI moet klinken terwijl het iets doet.

De 8 secties van een effectieve stijlgids

Volgens het template in Every's gids. Daarin is de zwarte lijst van Working Overtime geordend op ernst, en komt elke regel voort uit een concrete fout in een draft.

1. Stem en toon

Beschrijf hoe het schrijven op zijn best aanvoelt. Niet alleen flatterende bijvoeglijke naamwoorden ("slim, conversationeel"), maar de spanning en grenzen:

Voorbeeld (Working Overtime-column): 1. Schrijf vanuit binnenin de transformatie, niet erboven 2. Balans: deelnemer + waarnemer, enthousiast + sceptisch 3. Kwetsbaarheid is analytisch: gebruik persoonlijke inzet om inzichten te kaderen 4. Toon: conversationeel + rigoureus, optimistisch maar niet naïef 5. Gebruik humor spaarzaam voor droge nadruk, niet om te ondermijnen

2. Structuur

Wat onderscheidt je schrijven is hoe je ideeën organiseert. AI raadt structuurkeuzes slecht in — maak ze expliciet.

Voorbeeld: de Discovery Arc (Source Code) 1. Probleem/frustratie tegengekomen 2. Conventionele oplossing inadequaat 3. Doorbraakmoment 4. Nieuwe praktijk ontwikkeld en benoemd 5. Resultaten en transformatie (met echte metrics) 6. Hoe lezers het kunnen adopteren

3. Zinsniveau-voorkeuren

Schrijf de regel-voor-regel gewoonten op: korte vs. lange zinnen, voorkeur voor concrete nouns, interpunctie, ritme, tolerantie voor abstractie.

Voorbeeld: concrete taal (Source Code): - "Claude draaide 5 PRs terwijl ik koffie dronk" — niet "geoptimaliseerde workflows" - "$400/maand vervangt $400k/jaar" — niet "kosteneffectief" - "Gmail rate limits blokkeerden 2.000 e-mailoperaties" — niet "hadden schaalbaarheidsproblemen"

4. Signature moves

Benoem wat deze stem bijzonder goed doet: - Begint concreet en zoomt uit naar cultureel/historisch kader - Leent concept uit onverwachte discipline als interpretatiesleutel - De Één Groot Idee-regel: elk stuk slaat één gedenkwaardig concept vast (een discipline, een les, een architectuur)

5. Anti-patronen (zwarte lijst)

Dit is vaak de meest waardevolle sectie. Vertel het model ook wat slecht schrijven eruit ziet.

Patroon Oplossing
Hedges: "eigenlijk," "misschien," "gewoon" Verwijderen
"Niet X, maar Y"-constructies Zeg direct Y
Retorische vragen als opvulling Knippen of omzetten naar stelling
Slap openingsparagraaf (>3 par. tot kern) Begin met spanning
Samenvatting als afsluiting Eindig met vooruitgang of herijking

6. Positieve voorbeelden

Een paragraaf die de toon raakt, een opening die goed klinkt, een zin met het juiste ritme. Leg bij elk voorbeeld kort uit waarom het werkt.

7. Negatieve voorbeelden

AI-gegenereerde regels die te generiek zijn, te symmetrisch, te gepolijst. Leg uit wat er niet klopt.

8. Revisiechecklist

Hoe evalueer je of een draft werkt? - Klinkt dit als een echt persoon of een gepolijste samenvattingsmachine? - Is de taal specifiek genoeg? - Staan er nog zwarte-lijst-patronen in? - Behoudt de afsluiting energie, of zakt het in een samenvatting?

De drie rijpheitsniveaus

Niveau Wanneer Wat bevat het Waar opslaan
Starter Net begonnen met AI 3-5 bullets over toon, structuurvoorkeur, 5-10 te vermijden patronen, 2-3 voorbeeldteksten Plak in chatvenster
Werkgids Schrijf regelmatig met AI, eigen fouten bekend + Zinsniveau met pos/neg voorbeelden, signature moves, revisiechecklist, structuursjablonen Claude Project of custom GPT
Compound systeem AI is kern van schrijfworkflow + Automatische checks op drafts, feedback-loop die de gids bijwerkt, geïntegreerd in skills Skill / agent-pipeline

Hoe bouw je er een: het interview-proces

  1. Geef voorbeeldteksten — 3-5 sterke teksten die jouw schrijven vertegenwoordigen (of teksten die je bewondert als je nog weinig eigen werk hebt)
  2. Laat AI je interviewen — vraag het om één vraag tegelijk te stellen over toon, structuur, ritme, starters, metaforen, gewoonten en wat je haat in AI-proza
  3. Reageer op voorbeelden, niet op algemeenheden — laat AI sample-zinnen tonen en reageer: "dit is te symmetrisch," "dit klinkt te corporate"
  4. Laat AI een conceptgids synthetiseren — op basis van het gesprek
  5. Test en verfijn — gebruik een week, noteer waar je steeds dezelfde correcties maakt, verscherp die secties

Het dubbele effect

Het schrijven van een AI-stijlgids dwingt je een moeilijkere vraag te beantwoorden: Waarom schrijf ik zoals ik schrijf? Het document is gericht aan een machine, maar de persoon die er het meest van leert, ben jijzelf.

Relatie met brand context

In een Agentic OS leeft je stijlgids als voice profile in de gedeelde brand context-map. Alle skills die content produceren trekken eruit — van LinkedIn-posts tot klantonderzoek tot landingspagina's. Let op: persoonlijke skills (~/.claude/skills/) laden niet in Cowork of cloudsessies; daar werken alleen account-skills.

De drie pijlers van merkcontext

Volgens Simon Scrapes zijn er naast de stijlgids zelf (stem) twee aanvullende bestanden die samen de volledige merkcontext vormen voor een Agentic OS:

Pijler 1: Voice (stem)

De voice-profile.md — wat dit document hierboven beschrijft. Te genereren via een marketing-brand-voice skill die drie modi biedt: bestaande voice-documenten importeren, extraheren uit ruwe content (transcripts, posts), of vanaf nul opbouwen via een interview (10-15 min playbook). Volgens Simon Scrapes wordt 80% van je merkstem bepaald door je persoonlijkheid en standpunten — niet door woordkeuze alleen. Een voice-profile is een levend bestand: vaakst bijgewerkte bestand in de brand context.

Praktische test: volgens Simon Scrapes scoort content gegenereerd met een goed voice-profile aanzienlijk lager op AI-detectors (bij hem 12% i.p.v. veel hoger) — niet als doel op zich, maar als signaal dat de stem authentiek aanvoelt.

Pijler 2: Body of work (gedachtegoed)

Volgens Simon Scrapes legt een body-of-work.md vast wat je denkt en waarom — de 7-12 terugkerende kernconcepten/theses die je telkens weer naar voren brengt in podcasts, posts en gesprekken. Opbouw: verzamel bestaande content (posts, transcripts, sales- en aboutpagina's) → laat Claude terugkerende thema's destilleren → kom uit op één kernthese + onderbouwende standpunten.

Gecombineerd met het voice-profile geeft dit elke output een point of view in plaats van een generiek 60-70%-antwoord dat je zelf nog moet ombuigen.

Pijler 3: Visuele identiteit

Bij Simon Scrapes zet een visual-identity-skill kleurenpalet, typografie, logo's en lay-outregels om in een tokens.json — een configuratiebestand dat skills (bijv. een LinkedIn-carousel-generator) injecteren zodat output consistent oogt zonder elke keer art direction. Werkt het best met 3-5 visuele referenties (carousels, posts, brandbooks die je bewondert) als input.

In de opzet van Simon Scrapes vormen deze drie pijlers samen de merkcontext-map uit Agentic OS (context/brand/): voice, body of work en visuele identiteit — eenmalig opbouwen, daarna voedt elke output zich ermee.

Schrijf-guardrails: AI-tells eruit halen vóór publicatie

Naast het genereren in je eigen stem, kun je AI ook gebruiken om AI-klinkende patronen op te sporen vóórdat een tekst de deur uitgaat — een omgekeerde stijlgids-toepassing.

/guardrails-skill

Een skill die vóór publicatie scant op "AI-tells" en meer: AI-achtige retoriek, terugkerende stemtics, vage claims, slappe openingen en gaten in bewijs en argumentatie. Daarmee overlapt hij met de patronen uit de Anti-patronen-sectie hierboven, nu geautomatiseerd als check.

Persona-reviewers

In plaats van één generieke "verbeter dit"-prompt, kunnen meerdere persona-skills een draft vanuit verschillende invalshoeken reviewen:

Persona Focus
Sorkin Momentum — houdt het tempo erin
Mom Toegankelijkheid — is dit voor iedereen te volgen?
Asshole Adversarial — zoekt zwakke argumenten en gaten
Hitchcock Spanning — bouwt het op naar iets?
Sedaris Humor — zit er leven in?

Katie Parrott noemt in haar column daarnaast /tighten-draft (van Every-redacteur Jack Cheng) en /kate-top-edit voor structurele edits. Die zitten niet in de publieke draft-review-kit (13 skills); daar komt hemingway (bloat schrappen) het dichtst bij.

/panel-orchestratie

Een /panel-commando roept meerdere persona-reviewers tegelijk aan, plus een synthesizer die de feedback samenvoegt — en bewust productieve spanningen tussen reviewers behoudt in plaats van ze plat te slaan tot een gemiddelde.

Gefaseerd reviewproces

Algemene fasering: outline → sectie-drafts → volledige draft → eindchecklist (zie Revisiechecklist hierboven).

De draft-review-kit hanteert per draft een eigen volgorde, en je hoeft niet elke reviewer elke keer te draaien: 1. dev-edit zolang de structuur nog kan veranderen 2. asshole, mom of eli5, afhankelijk van het lezersrisico 3. Eén of twee craft-reviewers (hitchcock, sorkin, vonnegut, sedaris, hemingway) 4. guardrails vóór publicatie 5. panel of debate bij drafts waar veel van afhangt 6. line-edit als de grote beslissingen genomen zijn

Referentie-implementatie: draft-review-kit (EveryInc, GitHub).

Verwante concepten

  • Agentic OS — waar de stijlgids als brand context leeft
  • Geheugen en Context — hoe brand context gedeeld wordt
  • Anti-AI-Schrijfstijl — smallere, explicietere aanvulling: één audit-bestand gericht op negative parallelism en AI-tells
  • Anthropic Werkpatronen voor Niet-technici — deze stijlgids is een concrete uitwerking van patroon 1 (contextbestand bijhouden) uit die bredere werkpatronen-analyse
  • AI;DR — Het Lezerscontract in het AI-Tijdperk — het waaróm achter de stijlgids: wat de lezer opgeeft zodra hij vermoedt dat een tekst door AI is geschreven
  • Claude Slides — zelfde grondidee als Pijler 3 (Visuele identiteit) hierboven, maar dan zonder vooraf vastgelegd tokens.json: de huisstijl wordt per gesprek uit schermafbeeldingen afgeleid

Bronnen