Agħti lill-aġent kuntest utli mir-repożitorju

Ibda bil-checkout attwali

Aġent irid ikun jaf liema repożitorju u branch qed ibiddel. Irid ikun jaf ukoll jekk id-direttorju tax-xogħol fihx bidliet mhux relatati. Dawn il-fatti jaffettwaw x’jista’ jeditja b’mod sigur u kif għandu jiġi interpretat id-diff finali.

Itlob lill-aġent jispezzjona l-istruzzjonijiet tal-proġett u l-konfigurazzjoni tal-pakkett qabel l-implimentazzjoni. Kmand li jiftakar minn repożitorju ieħor jista’ jkun żbaljat hawn. Isem familjari ta’ framework ma jistabbilixxix il-verżjoni installata jew il-konvenzjonijiet tal-proġett.

Għal bidla żgħira, ipprovdi l-modulu rilevanti, il-kodiċi li jsejjaħlu, it-testijiet u d-deċiżjoni dwar l-arkitettura. Żid aktar informazzjoni meta l-investigazzjoni turi ħtieġa speċifika.

Uża l-istruzzjonijiet tar-repożitorju għal regoli stabbli

Fajl ta’ istruzzjonijiet jista’ jiddeskrivi kmandi appoġġjati, konfini tal-moduli, rekwiżiti tar-reviżjoni u azzjonijiet li jeħtieġu deċiżjoni mill-persuna responsabbli. Il-konvenzjoni AGENTS.md tagħti lill-għodod tal-kodiċi post magħruf għal din l-informazzjoni. L-appoġġ tal-għodod u l-preċedenza tal-istruzzjonijiet jistgħu jvarjaw, għalhekk iċċekkja l-imġiba tal-għodda tiegħek.

Żomm ir-regoli stabbli tal-proġett fir-repożitorju. Żomm il-kompitu attwali fid-deskrizzjoni tal-kompitu. Tibdilx il-fajl tal-istruzzjonijiet fi storja ta’ kull konversazzjoni jew f’lista ta’ pjanijiet temporanji.

Istruzzjoni utli tgħid: ‘Ħaddem it-testijiet tal-integrazzjoni li jivverifikaw l-awtorizzazzjoni meta route jibdel l-imġiba tal-aċċess.’ Istruzzjoni vaga tgħid: ‘Dejjem oqgħod attent għas-sigurtà.’ L-ewwel waħda tidentifika kundizzjoni u azzjoni li persuna tista’ tivverifika fir-reviżjoni.

Iċċekkja l-istruzzjonijiet mal-kodiċi

L-istruzzjonijiet jiskadu meta jinbidlu l-kmandi, id-direttorji jew l-arkitettura. Jekk gwida ssemmi script nieqes, spezzjona l-konfigurazzjoni tal-pakkett. Jekk dokument jgħid li servizz jippermetti l-qari biss, spezzjona l-permessi qabel toqgħod fuq dik l-istqarrija.

Irreġistra l-kunflitt. Uża evidenza diretta dwar il-verżjoni attwali biex tifhem l-imġiba tal-implimentazzjoni. Twarrabx politika intenzjonata mingħajr ma tgħid għax kodiċi qadim jikserha. Il-politika u l-imġiba attwali jwieġbu mistoqsijiet differenti.

Pereżempju, il-gwida tista’ tipprojbixxi kitba diretta fuq branch kondiviż, filwaqt li script qadim għadu jagħmilha. Ir-rispons korrett huwa li tħares il-politika u tikkoreġi l-iscript. Kodiċi eżistenti mhuwiex permess biex tirrepeti azzjoni pprojbita.

Żomm il-kuntest rilevanti u sigur

Repożitorju sħiħ jista’ jkun fih kredenzjali, fixtures privati, esportazzjonijiet tad-data tal-klijenti u logs qodma tal-appoġġ. Aċċess għar-repożitorju ma jagħmilx kull fajl awtomatikament adattat għal servizz ta’ mudell.

Uża għodod u regoli tal-immaniġġjar tad-data approvati. Eskludi s-sigrieti mill-kuntest. Ibdel l-eżempji tal-klijenti b’data ivvintata fejn possibbli. Iċċekkja l-għodod konnessi kif ukoll il-fajls imtella’: konnettur tat-tiftix jista’ jikseb informazzjoni li qatt ma kienet fil-prompt inizjali.

Istruzzjoni tar-repożitorju li tgħid ‘taqrax sigrieti’ hija gwida utli. Ma tissostitwixxix il-limitazzjoni tal-aċċess għall-ħażna tas-sigrieti u għal direttorji sensittivi.

Ħalli rekord utli għall-persuna li jmiss

Meta jitlesta x-xogħol, irreġistra l-imġiba mibdula, il-verifika u l-limiti mhux solvuti fil-pull request. Aġġorna d-dokumentazzjoni dejjiema tal-proġett meta jinbidel il-fluss tax-xogħol appoġġjat. Evita li tikkopja t-traskrizzjoni kollha tal-aġent fir-repożitorju.

Ir-rekord għandu jgħin lil persuna li tieħu ħsieb il-manutenzjoni fil-futur tirrepeti x-xogħol mingħajr ma tibni mill-ġdid konversazzjoni twila. Agħti links għal dokumenti kanoniċi u żomm deskrizzjoni awtorevoli waħda ta’ kull regola stabbli.

Kuntest tajjeb inaqqas l-investigazzjoni ripetuta. Jagħmel ukoll l-iżbalji aktar faċli biex jinstabu għax l-imġiba mistennija u l-kmandi li jaħdmu huma espliċiti.