Hvordan beskriver du en bug til en AI-assistent slik at den kan diagnostisere den nøyaktig?

Question

Accepted Answer

En god bug-rapport til en AI er det samme som en god bug-rapport til et menneske: gi den **nok kontekst til å kunne reprodusere problemet i sitt hode**, og fjern støyen. AI-en kan bare resonnere om det du limer inn — vage beskrivelser gir vage gjettinger.

## Hva du skal inkludere

- **Den nøyaktige feilmeldingen og full stack trace** — kopier den ordrett, ikke en omskriving. Filen og linjen i tracet er den enkelt mest nyttige ledetråden.
- **Den relevante koden** — funksjonen som kaster feilen pluss dens nærmeste kallere, ikke hele repoet.
- **Forventet vs faktisk oppførsel** — "Jeg forventer X, men får Y" er kjernen i enhver bug-rapport.
- **Reproduksjonstrinn** — den nøyaktige inndataen eller sekvensen som utløser det.
- **Miljø/versjoner** — språk, framework og bibliotekversjoner (en bug kan være versjonsspesifikk).
- **DB-skjema eller eksempeldata** — når buggen berører en spørring eller datainvolvering.

## Hva du skal utelate

Irrelevante filer, hele konfigurasjonen din, hemmeligheter/API-nøkler og "jeg tror det kan være X" teorier som påvirker diagnosen. Gi fakta, ikke antagelser.

## Svak vs sterk 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 sterke versjonen kan AI-en peke rett på den manglende `undefined`-kontrollen og foreslå et vakthold, fordi alle fakta den trenger er på siden.

## Hvorfor det betyr noe

En AI-assistent har **ingen tilgang til systemet ditt som kjører** — den resonnerer bare ut fra det du gir. En svak rapport tvinger den til å gjette på feilen, koden og miljøet samtidig, og en feil gjetning koster en rundtur. En sterk rapport (nøyaktig trace + relevant kode + forventet/faktisk + reproduksjon + versjoner) gjør diagnosen til en fokusert oppgave og får vanligvis riktig løsning første gang. Å lære å skrive stramme bug-rapporter gjør deg også selv til en bedre feilsøker, fordi det tvinger deg til å isolere fakta før du spør.