Práca na projektoch s viacerými repozitármi
Na tejto strane
Lekcia aktualizovaná 3. novembra 2026 na základe dokumentácie Codex Cloud: viaceré repozitáre teraz fungujú spoločne v prostredí Codex Cloud (stará adresa codex.openai.com už nie je vstupným bodom). Zdroj: Codex Cloud.
Zvládanie zložitosti distribuovaných architektúr
Moderné projekty sa často rozkladajú do viacerých repozitárov: frontend, backend, zdieľaná knižnica, platobná služba. Každý má svoj vlastný životný cyklus, CI pipeline a tímu zodpovedných za údržbu. Toto nastavenie funguje dokonale – kým zmena nepresiahne hranice repozitárov. Práve tu Codex mení pravidlá hry: dokáže pracovať súčasne naprieč viacerými repozitármi.
Skutočná cena zmien presahujúcich viacero častí
Zoberme si bežnú úlohu: v repozitári backendu pridáš pole do odpovede API. Následne musíš aktualizovať API klienta v repozitári frontendu, zdieľané typy v spoločnom repozitári, dokumentáciu v repozitári docs a integračné testy v repozitári e2e. Žiadna z týchto štyroch úloh nie je sama o sebe zložitá. Spolu však znamenajú štyri prepínania kontextu, štyri vetvy, štyri pull requesty a štyri šance, že na niečo zabudneš. V praxi sa často vynechá dokumentácia alebo e2e testy a problém sa objaví o tri týždne ako chyba, ktorú nikto nedokáže vystopovať späť k pôvodnému commitu.
Koordinácia viacerých repozitárov
V prostredí Codex Cloud môže jedno prostredie spájať viaceré GitHub repozitáre: vyberieš ich pri vytváraní prostredia, Codex nastaví ich závislosti a nástroje a každá úloha spustená v tomto prostredí funguje naprieč celou množinou. Tvoj prompt potom opisuje zmenu ako celok namiesto izolovania fragmentov:
"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 aplikuje zmeny v každom repozitári a otvorí koordinované pull requesty. Propagácia zdieľaného typu funguje na rovnakom princípe, s jednou dodatočnou požiadavkou, ktorú musíš explicitne uviesť: overiť, že kompilácia prebehne úspešne vo všetkých dotknutých repozitároch. Bez tejto inštrukcie objavíš chybu typu v CI mobilného repozitára až dve hodiny po zlúčení všetkého ostatného.
"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."
Konfigurácia súboru AGENTS.md v monorepo
Ak je tvoj projekt monorepo (Turborepo, Nx, Lerna), logika sa obracia: balíky zdieľajú jeden strom súborov a hierarchia súborov AGENTS.md nesie rozdiely medzi nimi. Koreňový súbor opisuje celkovú štruktúru a pravidlá platné všade:
# 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`
Každý podbalík potom na tomto základe stavia svoje vlastné konvencie bez toho, aby opakoval to, čo už je v koreňovom súbore:
# 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__/
Dva referenčné pracovné postupy naprieč repozitármi
Prvý pokrýva funkciu, ktorá zasahuje celý reťazec. Všimni si štvrtú inštrukciu: prepojenie medzi pull requestami sa môže zdať voliteľné, ale práve to umožňuje recenzentovi frontendového repozitára pochopiť, prečo toto tlačidlo existuje, bez toho, aby musel loviť zodpovedajúci backendový 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"
Druhý prípad pokrýva migráciu verziovaného API. Poradie krokov tu nie je len kozmetické: garantuje, že žiadny klient nezostane uviaznutý uprostred migrácie, pričom v2 je nasadené a v1 stále funguje počas okna migrácie spotrebiteľov.
"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"
Čo Codex za teba nedokáže urobiť
Codex pracuje repozitár po repozitári v oddelených pieskoviskách. Nedokáže spustiť dva repozitáre súčasne: napríklad nemôžeš naraz spustiť backend a frontend pre skutočný integračný test. Pri testoch naprieč repozitármi zostáva sekvencia manuálna:
- Zlúč jednotlivé PR
- Spusti integračné testy z tvojej CI/CD pipeline
- Použi Codex na opravu akýchkoľvek zistených problémov
Inými slovami, Codex garantuje konzistenciu napísaného kódu, nikdy nie konzistenciu bežiaceho systému. Tvoja CI/CD zostáva konečným arbitrom a opatrnosť diktuje, aby si nenasadzoval sériu koordinovaných PR, kým ona nevynesie svoj verdikt.
Kľúčové poznatky
- Codex dokáže vytvárať koordinované PR naprieč viacerými repozitármi
- Zdieľané typy sú ideálnym prípadom použitia pre workflow s viacerými repozitármi
- Nakonfiguruj AGENTS.md v každom balíku monorepa
- Integračné testy naprieč repozitármi sa musia stále overovať v CI/CD
- Zdokumentuj závislosti medzi repozitármi v súbore AGENTS.md