Hur beskriver du en bugg för en AI-assistent så att den kan diagnostisera den korrekt?

Question

Accepted Answer

En bra buggrapport till en AI är samma sak som en bra buggrapport till en människa: ge den **tillräckligt med sammanhang för att reproducera problemet i huvudet**, och ta bort bruset. AI:n kan bara resonera om det du klistrar in — vaga beskrivningar ger vaga gissningar.

## Vad du ska inkludera

- **Det exakta felmeddelandet och den fullständiga stack trace** — kopiera det ordagrant, inte en omformulering. Filen och raden i trace är den enskilt mest användbara ledtråden.
- **Den relevanta koden** — funktionen som kastar undantaget plus dess direkta anropare, inte hela repot.
- **Förväntat vs faktiskt beteende** — "Jag förväntar mig X, men jag får Y" är kärnan i varje buggrapport.
- **Reproduktionssteg** — den exakta inmatningen eller sekvensen som utlöser det.
- **Miljö/versioner** — språk, ramverk och biblioteksversioner (en bugg kan vara versionsspecifik).
- **Databassschema eller exempeldata** — när buggen rör en fråga eller datakonfiguration.

## Vad du ska lämna ut

Orelaterade filer, hela din konfiguration, hemligheter/API-nycklar och "Jag tror det kan vara X"-teorier som förvränger diagnosen. Ge fakta, inte gissningar.

## Svag vs stark rapport

```text
❌ WEAK: "My login is broken, it throws an error. Why?"
   → no error text, no code, no repro → the AI can only guess

✅ STRONG:
   Error (verbatim):
     TypeError: Cannot read properties of undefined (reading 'id')
       at getUser (auth.js:42)
   Code (auth.js:40-43):
```

```js
function getUser(token) {
  const session = sessions.find(s => s.token === token); // returns undefined if not found
  return session.user.id; // line 42: crashes when session is undefined
}
```

```text
   Expected: return null for an unknown token.
   Actual:   throws TypeError above.
   Repro:    call getUser('expired-token').
   Env:      Node 20, no framework.
```

Med den starka versionen kan AI:n peka direkt på den saknade `undefined`-kontrollen och föreslå ett skydd, eftersom varje fakta det behöver finns på sidan.

## Varför det är viktigt

En AI-assistent har **ingen tillgång till ditt körande system** — den resonerar bara baserat på det du tillhandahåller. En svag rapport tvingar den att gissa på felet, koden och miljön samtidigt, och en felaktig gissning slösar en rundresa. En stark rapport (exakt trace + relevant kod + förväntat/faktiskt + reproduktion + versioner) gör diagnosen till en fokuserad uppgift och får oftast rätt fix redan första gången. Att lära sig att skriva snäva buggrapporter gör också dig själv till en bättre felsökare, eftersom det tvingar dig att isolera fakta innan du frågar.