Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Darbs ar vairāku repozitoriju projektiem

Nodarbība 13 no 20 Atjaunota 2026. gada 3. novembris Programmētājs
Šajā lapā
  1. Izkliedētu arhitektūru sarežģītības pārvaldība
  2. Patiesās šķērsvirziena izmaiņu izmaksas
  3. Vairāku repozitoriju koordinēšana
  4. AGENTS.md konfigurēšana monorepozitorijā
  5. Divas atsauces šķērsvirziena darbplūsmas
  6. Ko Codex tavā vietā nevar izdarīt
  7. Galvenās atziņas

Nodarbība atjaunināta 2026. gada 3. novembrī, pamatojoties uz Codex Cloud dokumentāciju: vairāki repozitoriji tagad darbojas kopā vienā Codex Cloud vidē (vecā adrese codex.openai.com vairs nav ieejas punkts). Avots: Codex Cloud.

Izkliedētu arhitektūru sarežģītības pārvaldība

Mūsdienu projekti bieži aptver vairākus repozitorijus: frontendu, backendu, koplietojamo bibliotēku, maksājumu servisu. Katram ir savs dzīves cikls, CI cauruļvads un uzturētāji. Šī pieeja darbojas nevainojami, līdz izmaiņas šķērso repozitoriju robežas. Tieši šeit Codex maina spēles noteikumus: tas spēj strādāt ar vairākiem repozitorijiem vienlaicīgi.

Patiesās šķērsvirziena izmaiņu izmaksas

Apsver ikdienišķu uzdevumu: backend repozitorijā pievieno lauku API atbildei. Tad tev jāatjaunina API klients frontend repozitorijā, koplietojamie tipi kopīgajā repozitorijā, dokumentācija docs repozitorijā un integrācijas testi e2e repozitorijā. Neviens no šiem četriem uzdevumiem nav grūts atsevišķi. Kopā tie nozīmē četras konteksta maiņas, četrus zarus, četrus vilkšanas pieprasījumus (pull requests) un četras iespējas kaut ko aizmirst. Praksē dokumentāciju vai e2e testus izlaiž, un problēma parādās atkal trīs nedēļas vēlāk kā kļūda, kuru neviens nespēj saistīt ar sākotnējo komītu.

Vairāku repozitoriju koordinēšana

Codex Cloud vidē var apvienot vairākus GitHub repozitorijus: tu tos atlasi, veidojot vidi, Codex iestata to atkarības un rīkus, un katrs šajā vidē uzsāktais uzdevums darbojas visā kopumā. Tavs prompts tad apraksta izmaiņas kā veselu, nevis izolētus fragmentus:

"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 piemēro izmaiņas katrā repozitorijā un atver koordinētus vilkšanas pieprasījumus. Koplietojama tipa propagēšana seko tai pašai loģikai, ar vienu papildu prasību, kas jānorāda tieši: pārliecinies, ka kompilācija veicas veiksmīgi katrā ietekmētajā repozitorijā. Bez šīs instrukcijas tu uzzināsi par tipa kļūdu mobilās lietotnes repozitorija CI divas stundas pēc pārējā koda sapludināšanas.

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

AGENTS.md konfigurēšana monorepozitorijā

Ja tavs projekts ir monorepozitorijs (Turborepo, Nx, Lerna), loģika mainās: pakotnes dalās vienotā failu kokā, un AGENTS.md failu hierarhija nosaka atšķirības starp tām. Saknes fails apraksta kopējo struktūru un noteikumus, kas attiecas uz visu:

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

Katra apakšpakotne tad balstās uz šo pamatu ar saviem konvencijām, nekad neatkārtojot to, kas jau ir saknes failā:

# 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__/

Divas atsauces šķērsvirziena darbplūsmas

Pirmā attiecas uz funkciju, kas aptver visu ķēdi. Pievērs uzmanību ceturtajai instrukcijai: saišu izveide starp vilkšanas pieprasījumiem var šķist opcionāla, taču tieši tā ļauj frontend repozitorija recenzentam saprast, kāpēc šī poga eksistē, nemeklējot atbilstošo backend PR.

"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"

Otrā attiecas uz versijotas API migrēšanu. Šeit soļu secība nav tikai kosmētiska: tā garantē, ka neviens klients nepaliek iesprūdis migrācijas vidū, kamēr v2 ir ieviests un v1 joprojām darbojas patērētāju migrācijas loga laikā.

"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"

Ko Codex tavā vietā nevar izdarīt

Codex strādā repozitorijs pa repozitorijam atsevišķās smilškastēs. Tas nevar palaist divus repozitorijus kopā: piemēram, tu nevari vienlaicīgi startēt backendu un frontendu reālam integrācijas testam. Šķērsojošu repozitoriju testiem secība paliek manuāla:

  1. Sapludini individuālos PR.
  2. Palaid integrācijas testus no sava CI/CD cauruļvada.
  3. Izmanto Codex, lai novērstu visas atklātās problēmas.

Citiem vārdiem, Codex garantē rakstītā koda konsekvenci, nekad nedarbojošās sistēmas konsekvenci. Tavs CI/CD paliek galīgais arbitrs, un piesardzība diktē, ka nedrīksti izvietot (deploy) koordinētu PR sēriju, kamēr tas nav devis savu spriedumu.

Galvenās atziņas

  • Codex var izveidot koordinētus PR starp vairākiem repozitorijiem
  • Koplietojamie tipi ir ideāls lietojuma gadījums darbam ar vairākiem repozitorijiem
  • Konfigurē AGENTS.md katrā monorepozitorija pakotnē
  • Šķērsojošu repozitoriju integrācijas testi joprojām jāpārbauda CI/CD vidē
  • Dokumentē starprepozitoriju atkarības failā AGENTS.md