Práce na projektech s více repozitáři
Na této stránce
Lekce aktualizována 3. listopadu 2026 na základě dokumentace Codex Cloud: více repozitářů nyní funguje společně v prostředí Codex Cloud (stará adresa codex.openai.com již není vstupním bodem). Zdroj: Codex Cloud.
Zvládání složitosti distribuovaných architektur
Moderní projekty se často rozkládají přes více repozitářů: frontend, backend, sdílená knihovna, platební služba. Každý z nich má svůj vlastní životní cyklus, CI pipeline a správce. Tato konfigurace funguje dokonale – dokud změna nepřekročí hranice repozitářů. Právě zde Codex mění pravidla hry: dokáže pracovat současně napříč více repozitáři.
Skutečná cena změn zasahujících více vrstev
Zvaž běžný úkol: do repozitáře backendu přidáš pole do odpovědi API. Následně musíš aktualizovat API klienta v repozitáři frontendu, sdílené typy ve společném repozitáři, dokumentaci v repozitáři docs a integrační testy v repozitáři e2e. Žádný z těchto čtyř úkolů není sám o sobě obtížný. Dohromady však znamenají čtyři přepnutí kontextu, čtyři větve, čtyři pull requesty a čtyři šance, že na něco zapomeneš. V praxi se často vynechá dokumentace nebo e2e testy a problém se znovu objeví o tři týdny později jako chyba, kterou nikdo nedokáže vystopovat zpět k původnímu commitu.
Koordinace více repozitářů
V prostředí Codex Cloud může jedno prostředí spojit více GitHub repozitářů: vybereš je při vytváření prostředí, Codex nastaví jejich závislosti a nástroje a každý úkol spuštěný v tomto prostředí funguje napříč celou sadou. Tvůj prompt pak popisuje změnu jako celek místo izolování fragmentů:
"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 změny v každém repozitáři a otevře koordinované pull requesty. Propagace sdíleného typu funguje na stejném principu, s jedním dodatečným požadavkem, který musíš explicitně uvést: ověř, že kompilace proběhne úspěšně ve všech dotčených repozitářích. Bez tohoto pokynu zjistíš chybu typu v CI mobilního repozitáře až dvě hodiny po sloučení všeho 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."
Konfigurace souboru AGENTS.md v monorepo
Pokud je tvůj projekt monorepo (Turborepo, Nx, Lerna), logika se obrací: balíčky sdílejí jediný strom souborů a hierarchie souborů AGENTS.md nese rozlišení mezi nimi. Kořenový soubor popisuje celkovou strukturu a pravidla platná všude:
# 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íček pak na tomto základě staví svými vlastními konvencemi, aniž by kdy opakoval to, co je již v kořenovém souboru:
# 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 napříč repozitáři
První pokrývá funkci, která zasahuje celý řetězec. Věnuj pozornost čtvrtému pokynu: křížové odkazy mezi pull requesty se mohou zdát volitelné, ale právě ony umožňují recenzentovi frontendového repozitáře pochopit, proč toto tlačítko existuje, aniž by musel lovit odpovídající 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ý pokrývá migraci verzovaného API. Zde není pořadí kroků jen kosmetickou záležitostí: zaručuje, že žádný klient nezůstane uprostřed migrace viset, přičemž v2 je nasazeno a v1 stále běží po celou dobu migračního okna pro spotřebitele.
"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"
Co Codex za tebe nedokáže udělat
Codex pracuje repozitář po repozitáři v oddělených sandboxech. Nedokáže spustit dva repozitáře najednou: například nemůžeš současně spustit backend a frontend pro skutečný integrační test. U testů napříč repozitáři zůstává sekvence manuální:
- Slouč jednotlivé PR
- Spusť integrační testy ze svého CI/CD pipeline
- Použij Codex k opravě jakýchkoli zjištěných problémů
Jinými slovy, Codex garantuje konzistenci napsaného kódu, nikdy však konzistenci běžícího systému. Tvé CI/CD zůstává konečným arbitrem a opatrnost diktuje, abys nenasazoval sérii koordinovaných PR, dokud nevyneslo svůj verdikt.
Klíčové poznatky
- Codex dokáže vytvářet koordinované PR napříč více repozitáři
- Sdílené typy jsou ideálním případem použití pro workflow s více repozitáři
- Nakonfiguruj AGENTS.md v každém balíčku monorepa
- Integrační testy napříč repozitáři musí být stále ověřeny v CI/CD
- Zdokumentuj závislosti mezi repozitáři v souboru AGENTS.md