Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Arbeta med projekt i flera repo:n

Lektion 13 av 20 Uppdaterad 3 november 2026 Utvecklare
På denna sida
  1. Hantera komplexiteten i distribuerade arkitekturer
  2. Den verkliga kostnaden för en genomgripande ändring
  3. Koordinera flera repo:n
  4. Konfigurera AGENTS.md i ett monorepo
  5. Två referensflöden för genomgripande ändringar
  6. Vad Codex inte kan göra åt dig
  7. Viktiga punkter

Lektionen uppdaterad 3 november 2026 baserat på dokumentationen för Codex Cloud: flera repo:n lever nu tillsammans i en Codex Cloud-miljö (den gamla adressen codex.openai.com är inte längre ingångspunkten). Källa: Codex Cloud.

Hantera komplexiteten i distribuerade arkitekturer

Moderna projekt spänner ofta över flera repo:n: ett frontend, ett backend, ett delat bibliotek, en betalningstjänst. Varje del har sin egen livscykel, CI-pipeline och underhållare. Denna setup fungerar utmärkt – tills en ändring korsar gränserna mellan repo:n. Det är här Codex förändrar spelplanen: det kan arbeta över flera repo:n samtidigt.

Den verkliga kostnaden för en genomgripande ändring

Tänk dig en rutinuppgift: du lägger till ett fält i ett API-svar i backend-repo:t. Därefter måste du uppdatera API-klienten i frontend-repo:t, de delade typerna i det gemensamma repo:t, dokumentationen i docs-repo:t och integrationstesterna i e2e-repo:t. Ingen av dessa fyra uppgifter är svår i sig självt. Tillsammans innebär de fyra kontextbyten, fyra brancher, fyra pull requests och fyra chanser att glömma något. I praktiken hoppas man över dokumentationen eller e2e-testerna, och problemet dyker upp igen tre veckor senare som en bugg som ingen kan spåra tillbaka till den ursprungliga commit:en.

Koordinera flera repo:n

I Codex Cloud kan en miljö samla flera GitHub-repo:n: du väljer dem när du skapar miljön, Codex sätter upp deras beroenden och verktyg, och varje uppgift som startas i den miljön fungerar över hela uppsättningen. Din prompt beskriver sedan ändringen som en helhet istället för att isolera 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 tillämpar ändringarna i varje repo och öppnar koordinerade pull requests. Att sprida en delad typ följer samma logik, med ett extra krav du bör ange explicit: verifiera att kompileringen lyckas i varje påverkat repo. Utan den instruktionen kommer du upptäcka typfelet i mobil-repo:ts CI två timmar efter att ha mergat allt annat.

"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."

Konfigurera AGENTS.md i ett monorepo

Om ditt projekt är ett monorepo (Turborepo, Nx, Lerna) vänds logiken: paket delar en enda filträdstruktur, och hierarkin av AGENTS.md-filer bär på skillnaderna mellan dem. Rotfilen beskriver den övergripande strukturen och regler som gäller överallt:

# 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`

Varje underpaket bygger sedan vidare på denna grund med sina egna konventioner, utan att någonsin upprepa det som redan finns i rotfilen:

# 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__/

Två referensflöden för genomgripande ändringar

Det första täcker en funktion som spänner över hela kedjan. Lägg märke till den fjärde instruktionen: länken mellan pull requests kan verka valfri, men det är den som låter reviewern i frontend-repo:t förstå varför knappen finns utan att behöva jaga motsvarande 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"

Det andra täcker migrering av en versionerad API. Här är stegordningen inte kosmetisk: den garanterar att ingen klient strandar mitt i migreringen, med v2 på plats och v1 fortfarande vid liv under hela konsumenternas migreringsfönster.

"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"

Vad Codex inte kan göra åt dig

Codex arbetar repo för repo i separata sandlådor. Det kan inte köra två repo:n tillsammans: du kan till exempel inte starta backend och frontend samtidigt för ett riktigt integrationstest. För tvärgående tester förblir sekvensen manuell:

  1. Merga de individuella PR:erna
  2. Kör integrationstester från din CI/CD-pipeline
  3. Använd Codex för att åtgärda eventuella problem som upptäcks

Med andra ord garanterar Codex konsistensen i den skrivna koden, aldrig konsistensen i det körande systemet. Din CI/CD förblir den slutgiltiga domaren, och försiktigheten säger att du inte bör deploy:a en serie koordinerade PR:er förrän den har avgett sin dom.

Viktiga punkter

  • Codex kan skapa koordinerade PR:er över flera repo:n
  • Delade typer är ett idealiskt användningsområde för flerrepo-arbetsflöden
  • Konfigurera AGENTS.md i varje paket i ett monorepo
  • Integrationstester mellan repo:n måste fortfarande verifieras i CI/CD
  • Dokumentera beroenden mellan repo:n i AGENTS.md