Arbejde med projekter på tværs af flere repos
På denne side
Lektionen opdateret 3. november 2026 baseret på Codex Cloud-dokumentationen: Flere repositories lever nu sammen i et Codex Cloud-miljø (den gamle adresse codex.openai.com er ikke længere indgangspunktet). Kilde: Codex Cloud.
Håndtering af kompleksiteten i distribuerede arkitekturer
Moderne projekter strækker sig ofte over flere repositories: en frontend, en backend, et fælles bibliotek, en betalingstjeneste. Hvert har sin egen livscyklus, CI-pipeline og vedligeholdere. Denne opsætning fungerer perfekt – indtil en ændring krydser grænserne mellem repositories. Det er her, Codex ændrer spillet: Det kan arbejde på tværs af flere repos samtidigt.
De reelle omkostninger ved en gennemgribende ændring
Overvej en rutineopgave: Du tilføjer et felt til et API-svar i backend-repository’et. Derefter skal du opdatere API-klienten i frontend-repository’et, de fælles typer i det fælles repository, dokumentationen i docs-repository’et og integrationstestsene i e2e-repository’et. Ingen af disse fire opgaver er svære isoleret set. Sammen betyder de fire kontekstskift, fire branches, fire pull requests og fire chancer for at glemme én. I praksis bliver dokumentationen eller e2e-testene sprunget over, og problemet dukker op igen tre uger senere som en bug, som ingen kan spore tilbage til den oprindelige commit.
Koordinering af flere repositories
I Codex Cloud kan et miljø samle flere GitHub-repositories: Du vælger dem, når du opretter miljøet, Codex opsætter deres afhængigheder og værktøjer, og hver opgave, der startes i dette miljø, arbejder på tværs af hele sættet. Din prompt beskriver derefter ændringen som en helhed i stedet for at isolere fragmenter:
"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 anvender ændringerne i hvert repo og åbner koordinerede pull requests. Propagering af en fælles type følger den samme logik, med ét ekstra krav, du bør angive eksplicit: Verificér, at kompileringen lykkes i hvert berørt repo. Uden den instruktion vil du opdage typefejlen i mobil-repo’ets CI to timer efter, at alt andet er mergede.
"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."
Konfiguration af AGENTS.md i et monorepo
Hvis dit projekt er et monorepo (Turborepo, Nx, Lerna), vender logikken sig: Pakker deler et enkelt filtræ, og hierarkiet af AGENTS.md-filer bærer forskellene mellem dem. Rodfilen beskriver den overordnede struktur og regler, der gælder overalt:
# 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`
Hver underpakke bygger derefter videre på dette fundament med sine egne konventioner, uden nogensinde at gentage det, der allerede står i rodfilen:
# 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__/
To referencearbejdsgange på tværs af repos
Den første dækker en funktion, der strækker sig over hele kæden. Vær opmærksom på den fjerde instruktion: Krydshenvisningen mellem pull requests kan virke valgfri, men det er netop det, der gør det muligt for anmelderen i frontend-repo’et at forstå, hvorfor denne knap eksisterer, uden at skulle jagte den tilsvarende backend-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"
Den anden dækker migration af en versioneret API. Her er rækkefølgen af trin ikke kosmetisk: Den garanterer, at ingen klienter bliver strandede midt i migrationen, hvor v2 er på plads, og v1 stadig er i live gennem hele forbrugernes migrationsvindue.
"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"
Hvad Codex ikke kan gøre for dig
Codex arbejder repo for repo i separate sandkasser. Det kan ikke køre to repos sammen: Du kan f.eks. ikke starte backend og frontend samtidigt til en rigtig integrationstest. Til tests på tværs af repos forbliver sekvensen manuel:
- Merge de individuelle PRs
- Kør integrationstests fra din CI/CD-pipeline
- Brug Codex til at rette eventuelle problemer, der opdages
Med andre ord garanterer Codex konsistensen af den skrevne kode, aldrig konsistensen af det kørende system. Din CI/CD forbliver den endelige dommer, og forsigtighed dikterer, at du ikke bør deploye en serie af koordinerede PRs, før den har afsagt sin dom.
Vigtige pointer
- Codex kan oprette koordinerede PRs på tværs af flere repositories
- Fælles typer er et ideelt use case til arbejdsgange på tværs af flere repos
- Konfigurér AGENTS.md i hver pakke af et monorepo
- Integrationstests på tværs af repos skal stadig verificeres i CI/CD
- Dokumentér afhængigheder mellem repos i AGENTS.md