Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Jaħdem fuq proġetti b'diversi repożitorji

Lezzjoni 13 / 20 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. L-immaniġġjar tal-kumplessità tal-arkitetturi distribwiti
  2. L-ispiża reali ta’ bidla li taqsam is-sistema
  3. Il-koordinazzjoni ta’ diversi repożitorji
  4. Il-konfigurazzjoni ta’ AGENTS.md f’monorepo
  5. Żewġ flussi ta’ xogħol ta’ referenza li jaqsmu s-sistema
  6. X’ma jistax jagħmel Codex għalik
  7. Punti Ewlenin

Lezzjoni aġġornata fit-3 ta’ Novembru 2026 abbażi tad-dokumentazzjoni ta’ Codex Cloud: diversi repożitorji issa jgħixu flimkien f’ambjent ta’ Codex Cloud (l-indirizz antik codex.openai.com m’għadux il-punt tad-dħul). Sors: Codex Cloud.

L-immaniġġjar tal-kumplessità tal-arkitetturi distribwiti

Il-proġetti moderni spiss jestendu fuq diversi repożitorji: frontend, backend, librerija kondiviża, servizz ta’ ħlas. Kull wieħed għandu ċ-ċiklu tal-ħajja tiegħu, il-pipeline CI, u l-manutenuri tiegħu. Din il-konfigurazzjoni taħdem perfettament—sakemm tibdil jaqsam il-fruntieri tar-repożitorji. Hawnhekk fejn Codex ibiddel il-logħba: jista’ jaħdem fuq diversi repożitorji fl-istess ħin.

L-ispiża reali ta’ bidla li taqsam is-sistema

Ikkunsidra kompitu ta’ rutina: iżżid qasam ma’ tweġiba tal-API fir-repożitorju tal-backend. Imbagħad trid taġġorna l-klijent tal-API fir-repożitorju tal-frontend, it-tipi kondiviżi fir-repożitorju komuni, id-dokumentazzjoni fir-repożitorju tad-dokumentazzjoni, u t-testijiet ta’ integrazzjoni fir-repożitorju e2e. L-ebda waħda minn dawn l-erba’ kompiti mhija diffiċli waħedha. Flimkien, ifissru erba’ bidliet fil-kuntest, erba’ fergħat, erba’ talbiet għal ġbid (pull requests), u erba’ ċansijiet li tinse’ waħda. Fil-prattika, id-dokumentazzjoni jew it-testijiet e2e jiġu mħallija barra, u l-problema terġa’ tidher tliet ġimgħat wara bħala bug li ħadd ma jirrintraċċa lura għal dak il-commit oriġinali.

Il-koordinazzjoni ta’ diversi repożitorji

F’Codex Cloud, ambjent jista’ jiġbor flimkien diversi repożitorji ta’ GitHub: tagħżilhom meta toħloq l-ambjent, Codex jissettja d-dipendenzi u l-għodod tagħhom, u kull kompitu mnedu f’dak l-ambjent jaħdem fuq is-sett kollu. Il-prompt tiegħek imbagħad jiddeskrivi l-bidla bħala totalità minflok ma j iżola frammenti:

"In the backend repo (api-service):
- Add a GET /api/v2/products endpoint with pagination

In the frontend repo (web-app):
- Update the API client to use the new endpoint
- Add pagination to the ProductList component"

Codex japplika l-bidliet f’kull repo u jiftaħ talbiet għal ġbid ikkoordinati. Il-propagazzjoni ta’ tip kondiviż issegwi l-istess loġika, b’rekwiżit addizzjonali li għandek tiddikjara b’mod espliċitu: ivverifika li l-kompilazzjoni tirnexxi f’kull repo affettwat. Mingħajr dik l-istruzzjoni, se tiskopri l-iżball fit-tip fir-repożitorju tal-mobile fil-CI sagħtejn wara li tgħaqqad kollox l-ieħor.

"The Product type in shared-types/src/product.ts has been 
modified (added tags: string[] field). 
Update all usages in:
- api-service: routes and services that use Product
- web-app: components that display a Product
- mobile-app: screens that display a Product
Ensure each repo compiles without errors."

Il-konfigurazzjoni ta’ AGENTS.md f’monorepo

Jekk il-proġett tiegħek huwa monorepo (Turborepo, Nx, Lerna), il-loġika tinbidel: il-pakketti jaqsmu siġra waħda ta’ fajls, u l-ġerarkija tal-fajls AGENTS.md iġġorr id-distinzjonijiet bejniethom. Il-fajl root jiddeskrivi l-istruttura ġenerali u r-regoli li japplikaw kullimkien:

# AGENTS.md (monorepo root)

## Structure
Turborepo monorepo with the following packages:
- packages/api — Fastify backend
- packages/web — Next.js frontend
- packages/shared — Shared types and utilities
- packages/e2e — Playwright end-to-end tests

## Rules
- Changes to packages/shared MUST be followed by a build 
  of all dependent packages
- Global build command: `turbo run build`
- Global test command: `turbo run test`

Kull sotto-pakkett imbagħad jibni fuq din il-bażi bil-konvenzjonijiet tiegħu stess, mingħajr qatt ma jirrepeti dak li diġà jinsab fil-fajl root:

# packages/api/AGENTS.md

## Backend API
- Framework: Fastify
- Validation: Zod (schemas in src/schemas/)
- Types from packages/shared are imported via @myorg/shared
- Every new route requires a test in __tests__/

Żewġ flussi ta’ xogħol ta’ referenza li jaqsmu s-sistema

L-ewwel jkopri karatteristika li testendi fuq iċ-ċ catena kollha. Agħti kas tar-raba’ istruzzjoni: il-konnessjoni bejn it-talbiet għal ġbid tista’ tidher fakultattiva, iżda hija dik li tippermetti lir-reviżur tar-repożitorju tal-frontend jifhem għaliex jeżisti dan il-buttun mingħajr ma jfittex il-PR korrispondenti tal-backend.

"New feature: favorites system.
1. shared-types: Add the Favorite type
2. api-service: CRUD /api/favorites with auth
3. web-app: Heart button on product cards
4. Create a PR in each repo with links 
   to the other repos' PRs in the description"

It-tieni jkopri l-migrazzjoni ta’ API b’verżjoni. Hawnhekk, l-ordni tal-passi mhix kosmetika: tiggarantixxi li l-ebda klijent ma jibqa’ mitluq f’nofs il-migrazzjoni, bil-v2 fis-seħħ u l-v1 għadha ħajja matul it-tieqa tal-migrazzjoni tal-konsumatur.

"API v1 /users is deprecated. Create v2:
1. api-service: Add v2 routes with the new format
2. api-service: Mark v1 routes as deprecated (header)
3. web-app: Migrate all calls from v1 to v2
4. mobile-app: Migrate all calls from v1 to v2
5. docs: Update the API documentation"

X’ma jistax jagħmel Codex għalik

Codex jaħdem repożitorju b’repożitorju, f’sandbox separati. Ma jistax iħaddem żewġ repożitorji flimkien: pereżempju, ma tistax tniedi l-backend u l-frontend fl-istess ħin għal test ta’ integrazzjoni reali. Għat-testijiet bejn ir-repożitorji, is-sekwenza tibqa’ manwali:

  1. Igħaqqad il-PRs individwali
  2. Ħaddem it-testijiet ta’ integrazzjoni mill-pipeline CI/CD tiegħek
  3. Uża Codex biex tirranġa kwalunkwe problema skoperta

Fi kliem ieħor, Codex jiggarantixxi l-konsistenza tal-kodiċi miktub, qatt il-konsistenza tas-sistema li qed taħdem. Iċ-ĊI/ĊD tiegħek tibqa’ l-arbitru finali, u l-kawtela timponi li ma tiddispjaxja serje ta’ PRs ikkoordinati sakemm ma tkunx tat il-verdett tagħha.

Punti Ewlenin

  • Codex jista’ joħloq PRs ikkoordinati fuq diversi repożitorji
  • It-tipi kondiviżi huma każ ta’ użu ideali għal flussi ta’ xogħol multi-repo
  • Ikkonfigura AGENTS.md f’kull pakkett ta’ monorepo
  • It-testijiet ta’ integrazzjoni bejn ir-repożitorji għadhom iridu jiġu vverifikati fiċ-ĊI/ĊD
  • Iddokumenta d-dipendenzi bejn ir-repożitorji f’AGENTS.md