Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Práce na projektech s více repozitáři

Lekce 13 z 20 Aktualizováno 3. listopadu 2026 Vývojář
Na této stránce
  1. Zvládání složitosti distribuovaných architektur
  2. Skutečná cena změn zasahujících více vrstev
  3. Koordinace více repozitářů
  4. Konfigurace souboru AGENTS.md v monorepo
  5. Dva referenční pracovní postupy napříč repozitáři
  6. Co Codex za tebe nedokáže udělat
  7. Klíčové poznatky

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í:

  1. Slouč jednotlivé PR
  2. Spusť integrační testy ze svého CI/CD pipeline
  3. 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