Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Arbejde med projekter på tværs af flere repos

Lektion 13 af 20 Opdateret 3. november 2026 Udvikler
På denne side
  1. Håndtering af kompleksiteten i distribuerede arkitekturer
  2. De reelle omkostninger ved en gennemgribende ændring
  3. Koordinering af flere repositories
  4. Konfiguration af AGENTS.md i et monorepo
  5. To referencearbejdsgange på tværs af repos
  6. Hvad Codex ikke kan gøre for dig
  7. Vigtige pointer

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:

  1. Merge de individuelle PRs
  2. Kør integrationstests fra din CI/CD-pipeline
  3. 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