Több tárolóval rendelkező projektek kezelése
Ezen az oldalon
Lecke frissítve: 2026. november 3. a Codex Cloud dokumentációja alapján: több tároló most már együtt él egy Codex Cloud környezetben (a régi codex.openai.com cím már nem a belépési pont). Forrás: Codex Cloud.
A elosztott architektúrák összetettségének kezelése
A modern projektek gyakran több tárolót (repository) is átfognak: egy frontendet, egy backendet, egy megosztott könyvtárat, egy fizetési szolgáltatást. Mindegyiknek megvan a saját életciklusa, CI folyamata és karbantartója. Ez a felállás tökéletesen működik – egészen addig, amíg egy változás át nem lépi a tárolók határait. Itt változtatja meg a játékot a Codex: képes egyszerre dolgozni több tárolón is.
A határokon átnyúló változtatások valódi költsége
Vegyünk egy rutinfeladatot: hozzáadsz egy mezőt egy API-válaszhoz a backend tárolóban. Ezután frissítened kell az API klienst a frontend tárolóban, a megosztott típusokat a közös tárolóban, a dokumentációt a docs tárolóban és az integrációs teszteket az e2e tárolóban. E négy feladat egyike sem nehéz önmagában. Együtt azonban négy kontextusváltást, négy branchet, négy pull requestet és négy lehetőséget jelentenek arra, hogy valamit elfelejts. A gyakorlatban a dokumentációt vagy az e2e teszteket gyakran kihagyják, és a probléma három héttel később bugként bukkan fel újra, amit senki sem vezet vissza arra az eredeti commitra.
Több tároló koordinálása
A Codex Cloudban egy környezet több GitHub tárolót is egyesíthet: ezeket a környezet létrehozásakor választod ki, a Codex beállítja a függőségeiket és az eszközeiket, és minden ebben a környezetben indított feladat a teljes készleten dolgozik. A promptod ezután a változást egészében írja le, ahelyett, hogy töredékeket izolálnál:
"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"
A Codex alkalmazza a változtatásokat minden tárolóban, és koordinált pull requesteket nyit meg. Egy megosztott típus továbbítása ugyanígy működik, egy további követelménnyel, amit expliciten meg kell fogalmaznod: ellenőrizd, hogy a fordítás minden érintett tárolóban sikeres-e. Enélkül az utasítás nélkül csak két órával azután fedezed fel a típushibát a mobilos tároló CI-jában, hogy minden mást már összefésültél.
"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."
Az AGENTS.md konfigurálása monorepóban
Ha a projekted egy monorepo (Turborepo, Nx, Lerna), a logika megfordul: a csomagok egyetlen fájlfát osztanak meg, és az AGENTS.md fájlok hierarchiája hordozza a közöttük lévő különbségeket. A gyökérfájl írja le az általános struktúrát és a mindenre érvényes szabályokat:
# 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`
Minden egyes alcsomag erre az alapra épít a saját konvencióival, anélkül, hogy valaha is megismételné azt, ami már benne van a gyökérfájlban:
# 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__/
Két referenciális, határokon átnyúló munkafolyamat
Az első egy olyan funkciót fed le, amely az egész láncot átfogja. Figyeld meg a negyedik utasítást: a pull requestek közötti keresztlinkelés opcionálisnak tűnhet, de ez teszi lehetővé a frontend tároló recenzense számára, hogy megértse, miért létezik ez a gomb anélkül, hogy vadásznia kellene a megfelelő backend PR után.
"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"
A második egy verziókezelt API migrálását fedi le. Itt a lépések sorrendje nem kozmetikai kérdés: garantálja, hogy egyetlen kliens sem ragad le a migráció közepén, miközben a v2 már helyén van, és a v1 még életben marad a fogyasztói migrációs ablak alatt.
"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"
Amit a Codex nem tud megtenni helyetted
A Codex tárolóról tárolóra dolgozik, különálló homokozókban. Nem tud két tárolót egyszerre futtatni: például nem indíthatod el egyszerre a backendet és a frontendet egy valódi integrációs teszthez. A tárolókon átnyúló tesztek esetén a szekvencia továbbra is manuális marad:
- Fésüld össze az egyes PR-eket
- Futtasd az integrációs teszteket a CI/CD pipeline-ból
- Használd a Codexet a feltárt problémák javítására
Más szóval, a Codex garantálja a megírt kód konzisztenciáját, sosem a futó rendszer konzisztenciáját. A CI/CD marad a végső döntőbíró, és az óvatosság azt diktálja, hogy ne deployolj egy sorozatnyi koordinált PR-t addig, amíg az ki nem mondta az ítéletét.
Főbb megállapítások
- A Codex képes koordinált PR-eket létrehozni több tároló között
- A megosztott típusok ideális esetet jelentenek a több tárolós munkafolyamatokhoz
- Konfiguráld az AGENTS.md-t egy monorepo minden egyes csomagjában
- A tárolókon átnyúló integrációs teszteket továbbra is a CI/CD-ben kell ellenőrizni
- Dokumentáld a tárolók közötti függőségeket az AGENTS.md fájlban