Lucrul la proiecte cu mai multe depozite
Pe această pagină
Lecție actualizată la 3 noiembrie 2026 pe baza documentației Codex Cloud: mai multe depozite coexistă acum într-un mediu Codex Cloud (vechea adresă codex.openai.com nu mai este punctul de intrare). Sursă: Codex Cloud.
Gestionarea complexității arhitecturilor distribuite
Proiectele moderne se întind adesea pe mai multe depozite: un frontend, un backend, o bibliotecă partajată, un serviciu de plăți. Fiecare are propriul ciclu de viață, propriul pipeline CI și propriii întreținători. Această configurație funcționează perfect – până când o modificare traversează limitele dintre depozite. Aici intervine Codex pentru a schimba regulile jocului: poate lucra simultan pe mai multe depozite.
Costul real al unei modificări transversale
Să luăm în considerare o sarcină de rutină: adăugați un câmp la un răspuns API în depozitul backend. Apoi, trebuie să actualizați clientul API în depozitul frontend, tipurile partajate în depozitul comun, documentația în depozitul docs și testele de integrare în depozitul e2e. Niciuna dintre aceste patru sarcini nu este dificilă în izolare. Împreună, însă, ele implică patru schimbări de context, patru ramuri, patru pull request-uri și patru șanse de a uita una dintre ele. În practică, documentația sau testele e2e sunt omise, iar problema reapare trei săptămâni mai târziu sub forma unui bug pe care nimeni nu îl poate urmări până la acel commit original.
Coordonarea mai multor depozite
În Codex Cloud, un mediu poate reuni mai multe depozite GitHub: le selectați la crearea mediului, Codex configurează dependențele și uneltele acestora, iar fiecare sarcină lansată în acel mediu funcționează pe întregul set. Promptul dumneavoastră descrie apoi modificarea ca un tot unitar, în loc să izoleze fragmente:
"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 aplică modificările în fiecare depozit și deschide pull request-uri coordonate. Propagarea unui tip partajat urmează aceeași logică, cu o cerință suplimentară pe care trebuie să o enunțați explicit: verificați dacă compilarea reușește în fiecare depozit afectat. Fără această instrucțiune, veți descoperi eroarea de tip în CI-ul depozitului mobile la două ore după ce ați făcut merge la tot restul.
"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."
Configurarea AGENTS.md într-un monorepo
Dacă proiectul dumneavoastră este un monorepo (Turborepo, Nx, Lerna), logica se inversează: pachetele partajează un singur arbore de fișiere, iar ierarhia fișierelor AGENTS.md gestionează distincțiile dintre ele. Fișierul rădăcină descrie structura globală și regulile care se aplică peste tot:
# 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`
Fiecare sub-pachet se bazează apoi pe această fundație cu propriile convenții, fără a repeta niciodată ceea ce se află deja în fișierul rădăcină:
# 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__/
Două fluxuri de lucru transversale de referință
Primul acoperă o funcționalitate care se întinde pe întregul lanț. Acordați atenție celei de-a patra instrucțiuni: legătura încrucișată dintre pull request-uri poate părea opțională, dar ea este cea care permite reviewer-ului din depozitul frontend să înțeleagă de ce există acel buton, fără a fi nevoit să vâneze PR-ul corespunzător din 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"
Al doilea acoperă migrarea unui API versionat. Aici, ordinea pașilor nu este cosmetică: garantează că niciun client nu rămâne blocat la mijlocul migrării, cu v2 pus în place și v1 încă activ pe durata ferestrei de migrare a consumatorilor.
"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"
Ce nu poate face Codex pentru dumneavoastră
Codex lucrează depozit cu depozit, în sandbox-uri separate. Nu poate rula două depozite împreună: de exemplu, nu puteți lansa simultan backend-ul și frontend-ul pentru un test de integrare real. Pentru testele cross-repo, secvența rămâne manuală:
- Faceți merge la PR-urile individuale
- Rulați testele de integrare din pipeline-ul CI/CD
- Folosiți Codex pentru a remedia orice problemă detectată
Cu alte cuvinte, Codex garantează consistența codului scris, niciodată consistența sistemului în execuție. CI/CD-ul dumneavoastră rămâne arbitrul final, iar prudența dictează să nu implementați o serie de PR-uri coordonate până când acesta nu și-a dat verdictul.
Puncte cheie
- Codex poate crea PR-uri coordonate pe mai multe depozite
- Tipurile partajate reprezintă un caz de utilizare ideal pentru fluxurile de lucru multi-repo
- Configurați AGENTS.md în fiecare pachet al unui monorepo
- Testele de integrare cross-repo trebuie verificate în continuare în CI/CD
- Documentați dependențele inter-repo în AGENTS.md