Delo na projektih z več skladišči
Na tej strani
Lekcija posodobljena 3. novembra 2026 na podlagi dokumentacije Codex Cloud: več skladišč zdaj sobiva v okolju Codex Cloud (stari naslov codex.openai.com ni več vstopna točka). Vir: Codex Cloud.
Obvladovanje kompleksnosti porazdeljenih arhitektur
Sodobni projekti pogosto zajemajo več skladišč: sprednji del (frontend), zadnji del (backend), skupno knjižnico, storitev za plačila. Vsako ima svoj življenjski cikel, cevovod CI in vzdrževalce. Ta postavitev deluje brezhibno – vse dokler sprememba ne prečka meja skladišč. Tu Codex spremeni pravila igre: deluje lahko hkrati v več skladiščih.
Resnična cena sprememb, ki prečkajo meje
Razmisli o rutinski nalogi: v skladišču backend dodaš polje v odziv API-ja. Nato moraš posodobiti odjemalca API v skladišču frontend, skupne tipe v skupnem skladišču, dokumentacijo v skladišču docs in integracijske teste v skladišču e2e. Nobena od teh štirih nalog sama po sebi ni težka. Skupaj pa pomenijo štiri preklope konteksta, štiri veje, štiri zahtevke za združitev (pull requests) in štiri možnosti, da kaj pozabiš. V praksi dokumentacijo ali teste e2e preskočijo, težava pa se tri tedne kasneje ponovi kot hrošč, ki ga nihče ne more slediti nazaj do tistega prvotnega commita.
Usklajevanje več skladišč
V Codex Cloud lahko okolje združi več skladišč GitHub: izbereš jih ob ustvarjanju okolja, Codex nastavi njihove odvisnosti in orodja, vsaka naloga, zagnana v tem okolju, pa deluje po celotnem nizu. Tvoj poziv nato opiše spremembo kot celoto, namesto da bi izoliral drobce:
"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 uveljavi spremembe v vsakem skladišču in odpre usklajene zahtevke za združitev. Širjenje skupnega tipa sledi isti logiki, z eno dodatno zahtevo, ki jo moraš izrecno navesti: preveri, ali je kompilacija uspešna v vsakem prizadetem skladišču. Brez tega navodila boš napako tipa v CI-ju mobilnega skladišča odkril dve uri po združitvi vsega ostalega.
"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."
Konfiguriranje datoteke AGENTS.md v monorepu
Če je tvoj projekt monorepo (Turborepo, Nx, Lerna), se logika obrne: paketi si delijo eno drevo datotek, hierarhija datotek AGENTS.md pa nosi razlike med njimi. Korenska datoteka opisuje splošno strukturo in pravila, ki veljajo povsod:
# 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`
Vsak podpaket nato gradi na tej osnovi s svojimi konvencijami, ne da bi kdajkoli ponavljal tisto, kar je že v korenski datoteki:
# 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čna delovna toka, ki prečkata meje
Prvi zajema funkcijo, ki se razteza po celotni verigi. Bodite pozorni na četrti ukaz: povezava med zahtevki za združitev se morda zdi neobvezna, a prav ta omogoča pregledovalcu v skladišču frontend, da razume, zakaj ta gumb obstaja, ne da bi moral loviti ustrezen PR za backend.
"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"
Drugi zajema migracijo različice API-ja. Tu vrstni red korakov ni kozmetičen: zagotavlja, da noben odjemalec ne obtiči sredi migracije, pri čemer je v2 vzpostavljen, v1 pa ostane živ skozi celotno okno migracije potrošnikov.
"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"
Česa Codex ne more storiti namesto tebe
Codex deluje skladišče za skladiščem, v ločenih peskovnikih. Ne more zagnati dveh skladišč hkrati: na primer, backend in frontend ne moreš zagnati sočasno za pravi integracijski test. Za teste med skladišči zaporedje ostaja ročno:
- Združi posamezne PR-je
- Zaženi integracijske teste iz svojega cevovoda CI/CD
- Uporabi Codex za odpravo morebitnih zaznanih težav
Z drugimi besedami, Codex zagotavlja skladnost napisane kode, nikoli pa skladnosti delujočega sistema. Tvoj CI/CD ostaja končni arbitra, previdnost pa narekuje, da ne smeš razporediti niza usklajenih PR-jev, dokler ne izreče svoje sodbe.
Ključne ugotovitve
- Codex lahko ustvari usklajene PR-je v več skladiščih
- Skupni tipi so idealen primer uporabe za delovne tokove z več skladišči
- Konfiguriraj AGENTS.md v vsakem paketu monorepa
- Integracijske teste med skladišči je treba še vedno preveriti v CI/CD
- V AGENTS.md dokumentiraj odvisnosti med skladišči