Hvordan beskriver du en fejl til en AI-assistent, så den kan diagnosticere den nøjagtigt?

Question

Accepted Answer

En god fejlrapport til en AI er det samme som en god fejlrapport til et menneske: giv den **nok kontekst til at kunne genskabe problemet i sit hoved**, og fjern støjen. AI'en kan kun ræsonnere om det, du indsætter — vage beskrivelser producerer vage gæt.

## Hvad der skal inkluderes

- **Den nøjagtige fejlmeddelelse og fuld stack trace** — kopier det ordret, ikke en omformulering. Filen og linjen i sporet er det eneste mest nyttige spor.
- **Den relevante kode** — den funktion, der kaster plus dens umiddelbare kalders, ikke hele repo'et.
- **Forventet vs. faktisk adfærd** — "Jeg forventer X, men jeg får Y" er kernen i enhver fejlrapport.
- **Repro-trin** — det nøjagtige input eller den sekvens, der udløser det.
- **Miljø/versioner** — sproget, framework og biblioteksversioner (en fejl kan være versionspecifik).
- **DB-skema eller eksempeldata** — når fejlen berører en forespørgsel eller dataform.

## Hvad der skal undgås

Ikke-relaterede filer, hele din konfiguration, hemmeligheder/API-nøgler og "Jeg tror, det kan være X" teorier, der påvirker diagnosen. Giv fakta, ikke gætterier.

## Svag rapport vs. stærk 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 stærke version kan AI'en pege direkte på den manglende `undefined` kontrol og foreslå en garde, fordi alle de fakta, det har brug for, er på siden.

## Hvorfor det betyder noget

En AI-assistent har **ingen adgang til dit kørende system** — den ræsonnerer kun ud fra det, du leverer. En svag rapport tvinger den til at gætte på fejlen, koden og miljøet på samme tid, og et forkert gæt spilder en rundtur. En stærk rapport (nøjagtig spor + relevant kode + forventet/faktisk + repro + versioner) gør diagnosen til en fokuseret opgave og får normalt den rigtige løsning første gang. At lære at skrive stramme fejlrapporter gør dig også til en bedre debugger, fordi det tvinger dig til at isolere fakta før du spørger.