Att skriva för både människor och maskiner

Det här är inte en avvägning mellan att skriva för människor och att skriva för maskiner. Det är samma disciplin. Tvetydighet är alltid ett problem, den är bara osynlig när en människa läser, för hen kan fråga en kollega när något är oklart. En AI-agent kan inte det. Den gissar, och levererar gissningen som ett svar med samma säkerhet som ett korrekt svar.

Tre konkreta tekniker, alla med verkliga exempel.

1. Gör varje stycke självständigt

En människa som läser ett helt dokument bär med sig kontext från tidigare stycken. En AI-agent som söker information hämtar oftast bara ett enskilt utdrag, inte hela dokumentet. Ett stycke som bygger på "den processen" eller "i det här fallet" utan att säga vad det syftar på blir oanvändbart lösryckt.

Skriv inte "Den hanteras annorlunda. Det beror på avtalet som skrevs 2023." Skriv i stället "Kunder med ramavtal från 2023 hanteras enligt de villkor som gällde då, inte enligt nuvarande standardprocess." Den andra versionen betyder samma sak oavsett om den läses i sitt sammanhang eller ensam.

2. Säg villkoren rakt ut, skriv inte "det beror på"

"Det beror på" är en giltig mänsklig konversationsöppning, den inbjuder till en följdfråga. Skriftligt, utan någon som kan svara på följdfrågan, är det en återvändsgränd.

Skriv inte "Prissättningen varierar beroende på kund." Skriv "Kunder med årsomsättning över 10 miljoner kronor får 15 procent rabatt. Övriga kunder betalar listpris."

Om ni skriver "det beror på," fråga er själva vad det faktiskt beror på, och skriv det i stället.

3. Formulera rubriker som frågor, inte etiketter

En rubrik som "Prissättning" fungerar för en människa som bläddrar i ett innehållsförteckning. Den matchar sällan en verklig fråga en AI-agent försöker besvara, eller en sökning en människa faktiskt skriver.

En rubrik som bara säger "Undantag" fungerar sämre än en som frågar "Vad gör vi när en kund ber om rabatt utanför standardvillkoren?"

Den andra rubriken är mer skanningsbar för en människa också. Det är ingen kompromiss, bara tydligare skrivet.

Varför det spelar större roll nu

När bara människor läste dokumentation löstes tvetydighet via en snabb fråga till en kollega. Skadan var liten. När en AI-agent svarar å era vägnar finns ingen kollega att fråga. Agenten gissar utifrån det som faktiskt står, och en dålig gissning levereras med samma självsäkerhet som ett korrekt svar. Det är precis den typ av källa steg fyra i metoden syftar på: inte bara att bygga en källa, utan att skriva den på ett sätt som faktiskt går att lita på.

De här tre teknikerna kostar inget extra att tillämpa. De tar lite mer tid per stycke, och sparar den tiden mångfalt varje gång någon, människa eller agent, faktiskt behöver svaret.