Mitme repositooriumiga projektide kallal töötamine
Sellel lehel
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:
- Ühenda individuaalsed PR-id
- Käivita integreerimistestid oma CI/CD torustikust
- 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