Skriv avsikten först: en sida som gör att AI:n bygger rätt sak

Du ber om en sak. Du får något som tekniskt sett är det du bad om. Men det är inte det du menade.

Känslan är att AI:n inte förstod. Oftare är det tvärtom: den förstod precis det du skrev. Problemet är allt du inte skrev, för att det var självklart för dig.

Varför det blir fel

Du bär på en mängd sammanhang som aldrig hamnar i prompten:

varför du vill ha det här just nu,
vem som ska använda resultatet,
vad som absolut inte får röras,
hur du kommer att avgöra om det blev bra.

AI:n har inget av det. Så den gör det enda den kan: väljer det mest sannolika. Ibland stämmer det. Ofta stämmer det nästan, och det är värre, för då upptäcker du felet sent.

Ett exempel från när vi byggde den här sajten. Uppdraget var att ta fram en logga, eftersom det inte fanns någon. Innan något ritades letade vi i det som redan fanns, och hittade en färdig logga från ett tidigare projekt. Hade vi börjat rita direkt hade resultatet varit snyggt, och fel. Luckan var inte kompetens. Den var sammanhang.

Lösningen: en fil innan arbetet börjar

Innan AI:n skriver en rad kod, en text eller ett förslag, skriv ner avsikten i en kort fil. Vi kallar den avsikt.md.

Det är inte en kravspecifikation. Det är en sida på vanlig svenska som svarar på det du annars hade tagit för givet.

Låt AI:n intervjua dig

Precis som med andra instruktioner: skriv inte filen själv från ett tomt papper. Låt AI:n fråga. Frågorna tvingar fram det du inte visste att du visste.

Innan du börjar bygga något vill jag att vi skriver avsikt.md tillsammans.

Intervjua mig, en fråga i taget, tills du kan fylla i alla rubriker nedan
utan att gissa. Om mitt svar är vagt: fråga igen, konkretare.

Skriv sedan filen. Där du fortfarande är osäker, skriv det under
"Öppna frågor" i stället för att välja åt mig.

Uppgiften: [beskriv kort vad du vill ha]

Mallen

Sex rubriker räcker långt:

# Avsikt: [kort namn]

## Vad ska bli bättre
Vad ska vara annorlunda när det här är klart? Beskriv resultatet,
inte lösningen.

## Varför nu
Vad är det som gör att det behövs? Vad händer om vi inte gör det?

## För vem
Vem ska använda resultatet, och vad vet de redan?

## Rör inte
Filer, system, texter eller beslut som ligger fast. Med en rad om varför.

## Klart när
Hur ser vi att det är klart? Saker man kan pröva, inte känslor.

## Öppna frågor
Det vi inte vet än. Ska besvaras innan det påverkar arbetet.

Två rubriker gör mest nytta.

Rör inte. De dyraste misstagen är sällan att något nytt blev dåligt. Det är att något befintligt ändrades som ingen bad om. En rad som säger “den här texten är redan godkänd, ändra den inte” sparar mycket.

Klart när. Om du inte kan säga hur du ska avgöra att det är klart kan AI:n inte heller det. “Snygg och modern” går inte att pröva. “Fungerar i mobilen utan att man behöver scrolla i sidled” går.

När filen finns

Peka varje ny chatt dit först. Börja med “Läs avsikt.md innan du gör något.” Då slipper du förklara om sammanhanget varje gång, och du slipper att det förklaras lite olika varje gång.

Uppdatera den när beslut fattas. Svarar du på en öppen fråga, flytta svaret till rätt rubrik. Filen ska beskriva hur det är nu, inte hur det var när ni började.

Låt den leva i projektet. Den här sajten har en sådan fil i sin kodbas. Där står bland annat vilka domäner som visar vilket språk, att inga kundcase eller siffror får hittas på, och att ingenting publiceras utan att en människa har gått igenom det först. Varje ny session börjar med att läsa den.

När det behövs mer

En sida räcker för det mesta. Gå vidare när:

flera personer ska fatta beslut. Då behöver öppna frågor en ägare och ett datum.
utseendet är det svåra. Ta fram ett designförslag och låt det godkännas innan något byggs. En bild svarar på frågor som text inte kan.
jobbet återkommer. Då är det inte längre en avsikt utan en playbook. Se guiden En playbook per jobb.

Vanliga misstag

Att beskriva lösningen i stället för resultatet. “Lägg till en knapp” låser svaret. “Kunden ska kunna avboka själv” lämnar plats för ett bättre.
Att hoppa över “Rör inte”. Det känns onödigt tills något godkänt har skrivits om.
Att låta AI:n svara på de öppna frågorna. Då har den gissat igen, bara i en snyggare fil.
Att skriva filen en gång och aldrig igen. En gammal avsikt är sämre än ingen, eftersom den ser sann ut.