Arbeta med projekt i flera repo:n
På denna sida
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:
- Merga de individuella PR:erna
- Kör integrationstester från din CI/CD-pipeline
- 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