Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Mitme repositooriumiga projektide kallal töötamine

Õppetund 13 / 20 Värskendatud 3. november 2026 Arendajatele
Sellel lehel
  1. Hajusate arhitektuuride keerukuse haldamine
  2. Ristsuunalise muudatuse tegelik hind
  3. Mitme repositooriumi koordineerimine
  4. AGENTS.md konfigureerimine monorepos
  5. Kaks võrdluslikku ristsuunalist töövoo näidet
  6. Mida Codex sinu eest teha ei saa
  7. Peamised punktid

Tund uuendatud 3. novembril 2026 põhinedes Codex Cloud dokumentatsioonil: mitu repositooriumi eksisteerivad nüüd koos Codex Cloudi keskkonnas (vana aadress codex.openai.com ei ole enam sisenemispunkt). Allikas: Codex Cloud.

Hajusate arhitektuuride keerukuse haldamine

Kaasaegsed projektid hõlmavad sageli mitut repositooriumi: kasutajaliides, taustasüsteem, ühine teek, makseteenus. Igal neist on oma elutsükkel, CI-torustik ja haldajad. See seadistus toimib suurepäraselt – kuni muudatus ületab repositooriumide piire. Just siin muudab Codex mängu: see suudab töötada samaaegselt mitme repositooriumiga.

Ristsuunalise muudatuse tegelik hind

Vaatleme rutiinset ülesannet: lisad taustasüsteemi repositooriumis API vastusele välja. Seejärel pead värskendama API klienti kasutajaliidese repositooriumis, ühiseid tüüpe ühises repositooriumis, dokumentatsiooni docs-repositooriumis ja integreerimisteste e2e-repositooriumis. Ükski neist neljast ülesandest pole isoleeritult keeruline. Koos tähendavad need nelja kontekstivahetust, nelja haru, nelja tõmbetaotlust (PR) ja nelja võimalust midagi unustada. Praktikas jäetakse dokumentatsioon või e2e-testid vahele ja probleem kerkib kolm nädalat hiljem uuesti esile veana, mida keegi ei suuda algse koodimuudatusega siduda.

Mitme repositooriumi koordineerimine

Codex Cloudis saab keskkond kokku viia mitu GitHubi repositooriumi: valid need keskkonna loomisel, Codex seab üles nende sõltuvused ja tööriistad ning iga selles keskkonnas käivitatud ülesanne hõlmab kogu komplekti. Sinu vihje kirjeldab seejärel muudatust tervikuna, mitte ei eralda 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 rakendab muudatused igas repositooriumis ja avab koordineeritud tõmbetaotlused. Ühise tüübi levitamine järgib sama loogikat, lisandub vaid üks nõue, mille peaksid sõnaselgelt sätestama: veendu, et kompileerimine õnnestub igas mõjutatud repositooriumis. Ilma selle juhendita avastad tüügivea mobiilirakenduse repositooriumi CI-s kaks tundi pärast kõige muu ühendamist.

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

Kui su projekt on monorepo (Turborepo, Nx, Lerna), muutub loogika vastupidiseks: paketid jagavad ühtset failipuud ja AGENTS.md failide hierarhia kannab endas nendevahelisi eristusi. Juurfail kirjeldab üldist struktuuri ja reegleid, kehtivad kõikjal:

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

Iga alam-pakkett ehitab seejärel sellele alusele oma konventsioonid, kordamata kunagi seda, mis on juba juurfailis olemas:

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

Kaks võrdluslikku ristsuunalist töövoo näidet

Esimene käsitleb funktsiooni, mis hõlmab kogu ahelat. Pööra tähelepanu neljandale juhendile: tõmbetaotluste vaheline ristviide võib tunduda valikuline, kuid just see võimaldab kasutajaliidese repositooriumi ülevaatajal mõista, miks see nupp eksisteerib, ilma et ta peaks vastavat taustasüsteemi PR-i taga ajama.

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

Teine käsitleb versioneeritud API migreerimist. Siin ei ole sammude järjekord pelgalt kosmeetiline: see garanteerib, et ükski klient ei jää migreerumise pooleli, kusjuures v2 on olemas ja v1 on tarbijate migreerumisakna vältel endiselt aktiivne.

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

Mida Codex sinu eest teha ei saa

Codex töötab repositoorium haaval eraldatud liivakastides. See ei saa käivitada kaht repositooriumi koos: näiteks ei saa sa käivitada taustasüsteemi ja kasutajaliidest samaaegselt reaalse integreerimistesti jaoks. Repositooriumidevaheliste testide puhul jääb jada manuaalseks:

  1. Ühenda individuaalsed PR-id
  2. Käivita integreerimistestid oma CI/CD torustikust
  3. Kasuta Codexit tuvastatud probleemide parandamiseks

Teisisõnu garanteerib Codex kirjutatud koodi järjepidevuse, mitte kunagi töötava süsteemi järjepidevuse. Sinu CI/CD jääb lõplikuks otsustajaks ja ettevaatlikkus dikteerib, et ei tohiks koordineeritud PR-ide seeriat kasutusele võtta enne, kui see on oma otsuse langetanud.

Peamised punktid

  • Codex saab luua koordineeritud PR-e üle mitme repositooriumi
  • Ühised tüübid on ideaalne kasutusjuhtum mitme repositooriumiga töövoo jaoks
  • Konfigureeri AGENTS.md monorepo igas paketis
  • Repositooriumidevahelisi integreerimisteste tuleb endiselt kontrollida CI/CD-s
  • Dokumenteeri repositooriumidevahelised sõltuvused failis AGENTS.md