Kif tiddeskrivi grupp lil AI assistant sabiex ikun jista' jiddiagnostikah b'mod preċiż?

Question

Accepted Answer

Rapport tajjeb tal-grupp lil AI hu l-istess bħal rapport tajjeb tal-grupp lil bniedem: agħtih **kontesto biex jista' jiriproduċi l-problema f'ħammu**, u naqqas ir-riedqa. AI jista' jirraġuna biss fuq x'postu — deskrizzjonijiet nuqsin jipproduċu indovini nuqsin.

## X'għandu jkun inklużiż

- **Il-messaġġ tal-iżball eżatt u l-full stack trace** — ikkopja verbatim, mhux parafrażi. Il-file u l-linja fil-trace huma l-aktar útli.
- **Il-kod rilevanti** — il-funzjoni li turmi plus i ċalliemi immedjati, mhux ir-repo sħiħ.
- **Imġiba mistennjija vs attwali** — "Nitmaqqad X, imma nikseb Y" hu l-qalb ta' kull rapport tal-grupp.
- **Passi ta' riproduzzjoni** — l-input eżatt jew is-sekwenza li tipprovokah.
- **Ambjent/verżjonijiet** — lingwa, qafas u verżjonijiet tal-librerija (grupp jista' jkun verżjoni-spesifika).
- **DB schema jew data tal-kampjun** — meta l-grupp imiss query jew forma ta' data.

## X'għandu jkun maqsum

Fajls mhux relatati, l-interi konfigurazzjoni, sigriet/ċwievet API, u teoriji "aħseb li jista' jkun X" li jippejzanaw id-dijanjostika. Agħti fatti, mhux indovini.

## Rapport dgħajjef vs qawwi

```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.
```

Bil-verżjoni qawwija, AI jista' jipponta direzzjonalment fuq il-check `undefined` nieqes u jissuggerixxi proteazzjoni, għax kull fatt li jeħtieġ hu fuq il-paġna.

## Għaliex huwa importanti

AI assistant **m'għandu l-ebda aċċess mat-sistema tiegħek li tmexxu** — irraġuna biss minn x'postu — rapport dgħajjef jiffurzah jigħess l-iżball, il-kodiċi u l-ambjent kollha f'daqqa, u induvina ħażin iddig tur-ritorn. Rapport qawwi (trace eżatt + kodiċi rilevanti + mistennjija/attwali + repro + verżjonijiet) ittrasfurma d-dijanjostika f'kompitu ffokusat u normalment ikun jirċievi l-aġġustament korrett tal-ewwel prova. It-tagħlim biex tikteb rapporti ta' bugs istretti jagħmilok debba debugger aħjar, għax jiffurzak iżola l-fatti qabel ma titlob.