Rozpoczynanie projektow z Codex App

Wlasnie dostales zielone swiatlo na nowy serwis. Specyfikacja produktu jest w dokumencie Notion, deadline za dwa tygodnie, a potrzebujesz projektu z TypeScript, baza danych, testami, CI i konfiguracja wdrozenia zanim napiszesz jedna linie logiki biznesowej. Ustawienie tego wszystkiego recznie zajmuje caly dzien. Ustawienie tego w Codex App zajmuje jeden watek.

Co wyniesiesz z tej lekcji

• Powtarzalny proces bootstrapowania dowolnego typu projektu w Codex App
• Produkcyjnej jakosci plik AGENTS.md, ktory uczyni kazde przyszle zadanie Codex madrzejszym
• Konfiguracje srodowiska lokalnego, aby worktree automatycznie instalowaly zaleznosci
• Twoj pierwszy watek worktree — dzialajacy w izolacji od glownego checkoutu

Workflow

Krok 1: Utwroz projekt w Codex App

Otworz Codex App i dodaj nowy projekt. Wskaz go na katalog, w ktorym znajduje sie (lub bedzie sie znajdowal) twoje repozytorium. Jesli zaczynasz od zera, najpierw utwroz katalog i zainicjalizuj repozytorium git — Codex potrzebuje repozytorium git, aby wlaczyc tryb worktree.

mkdir ~/projects/billing-service && cd ~/projects/billing-service
git init

W Codex App kliknij selektor projektow na pasku bocznym i dodaj ~/projects/billing-service. Masz teraz przestrzen robocza projektu, gdzie kazdy watek dziedziczy odpowiedni kontekst.

Krok 2: Scaffolduj projekt w watku Local

Wybierz tryb Local do poczatkowego scaffoldingu, poniewaz chcesz, aby pliki zostaly zapisane bezposrednio w twoim katalogu roboczym. Wyslij swoj pierwszy prompt z konkretnymi ograniczeniami — Codex dziala najlepiej, gdy powiesz mu, jak wyglada “done”.

Wskazówka

Gotowy prompt do scaffoldingu projektu:

Create a Node.js/TypeScript project for a billing service with:

Tech stack: Express, Drizzle ORM, PostgreSQL, Vitest, Docker Compose
Structure:
- src/routes/ for API endpoints
- src/lib/db/ for schema and queries
- src/middleware/ for auth and validation
- tests/unit/ and tests/integration/

Include:
- tsconfig.json with strict mode
- Dockerfile and docker-compose.yml with PostgreSQL
- .github/workflows/ci.yml with lint, type-check, test
- ESLint flat config with TypeScript rules
- A basic health check endpoint at GET /health

Do NOT generate placeholder business logic. Only infrastructure and tooling.

Po wygenerowaniu plikow przez Codex otworz panel recenzji (ikona diffa), aby sprawdzic, co zostalo utworzone. Dodaj zmiany, ktore chcesz, cofnij te, ktorych nie chcesz, i commituj bezposrednio z App.

Krok 3: Napisz swoj AGENTS.md

To jest pojedynczy plik o najwiekszym wplywie na produktywnosc Codex w twoim repozytorium. Kazde zadanie chmurowe, automatyzacja, interakcja z GitHub i watek lokalny czyta AGENTS.md, aby zrozumiec twoj projekt. Zainwestuj tu piec minut, a kazde przyszle zadanie bedzie lepsze.

Wskazówka

Gotowy prompt do generowania AGENTS.md:

Create an AGENTS.md file at the root of this project. Include:

1. Project overview: what this service does and its tech stack
2. Setup: how to install dependencies and start the dev server
3. Testing: the exact commands to run unit and integration tests
4. Linting: the lint and type-check commands
5. Code style: our conventions (named exports, async/await, Drizzle for DB)
6. Review guidelines: what to flag during code review (no raw SQL, validate all inputs, no console.log in production code)

Keep it concise. Codex reads this on every task, so optimize for signal, not length.

Dobry AGENTS.md wyglada tak:

# Billing Service

Express/TypeScript billing API with PostgreSQL via Drizzle ORM.

## Setup
npm install
docker compose up -d  # starts PostgreSQL
npm run db:migrate
npm run dev           # starts on port 3000

## Testing
npm run test           # Vitest unit tests
npm run test:integration  # requires running PostgreSQL

## Linting
npm run lint           # ESLint
npm run type-check     # tsc --noEmit

## Code style
- Named exports only
- async/await over raw promises
- Drizzle ORM for all database access (no raw SQL)
- Zod schemas for input validation on every route

## Review guidelines
- Flag any raw SQL queries
- Flag missing input validation
- Flag console.log (use structured logger)
- Verify error responses do not leak internal details

Krok 4: Skonfiguruj srodowisko lokalne

Srodowiska lokalne informuja Codex, jakie skrypty konfiguracyjne uruchomic przy tworzeniu worktree. Bez tego kazdy worktree startuje pusty — bez node_modules, bez bazy danych, bez mozliwosci uruchomienia testow.

W Codex App przejdz do ustawien projektu i utwroz srodowisko lokalne ze skryptem konfiguracyjnym:

npm install
docker compose up -d --wait
npm run db:migrate

Teraz kazdy watek worktree automatycznie instaluje zaleznosci i uruchamia PostgreSQL zanim Codex zacznie prace. To wlasnie sprawia, ze rownolegly development faktycznie dziala — kazdy worktree jest samowystarczalny.

Krok 5: Uruchom swoj pierwszy watek Worktree

Z infrastruktura na miejscu przetestuj pelny workflow. Wybierz tryb Worktree w edytorze watku i wskazuj galaz main jako punkt wyjscia. Codex tworzy izolowany git worktree w $CODEX_HOME/worktrees/, wiec nic nie dotyka twojego lokalnego checkoutu.

Wskazówka

Gotowy prompt do pierwszej funkcji w worktree:

Implement a POST /api/invoices endpoint that:
- Accepts { customerId, items: [{ description, amount }] }
- Validates input with Zod
- Inserts an invoice record and line items using Drizzle
- Returns the created invoice with a generated invoice number
- Includes a unit test for the validation logic and an integration test for the database insert

Follow the patterns in AGENTS.md. Run tests after implementation.

Gdy Codex zakonczy, masz trzy opcje dla zmian w worktree:

1. Create branch here — promuje worktree do nazwanej galezi. Wypchnij i otworz PR bezposrednio z App.
2. Sync with local — aplikuje zmiany z powrotem do twojego lokalnego checkoutu. Uzyj tego, gdy musisz zweryfikowac wzgledem dzialajacego serwera deweloperskiego.
3. Keep iterating — wysylaj dodatkowe prompty w tym samym watku, aby dopracowac implementacje.

Gdy cos sie nie uda

Skrypt konfiguracyjny worktree nie powiedzie sie po cichu. Jesli skrypt konfiguracyjny srodowiska lokalnego ma blad (na przyklad PostgreSQL sie nie uruchomil), Codex kontynuuje, ale nie moze uruchomic testow. Sprawdz zintegrowany terminal (Cmd + J), aby zobaczyc wynik skryptu konfiguracyjnego. Napraw skrypt i rozpocznij nowy watek worktree.

AGENTS.md jest za dlugi. Jesli twoj AGENTS.md przekracza kilkaset linii, Codex spedza tokeny na czytaniu instrukcji zamiast wykonywaniu pracy. Utrzymaj go skupionego na poleceniach i konwencjach. Przenies szczegolowa dokumentacje architektury do oddzielnych plikow i odwoluj sie do nich tylko gdy jest to istotne.

Submoduly git w projekcie. Worktree nie inicjalizuja automatycznie submodulow git. Dodaj git submodule update --init do skryptu konfiguracyjnego srodowiska lokalnego, jesli twoj projekt ich uzywa.

Prompt scaffoldingowy generuje zbyt wiele opinii. Jesli Codex generuje pliki, o ktore nie prosiles (odznaki README, przewodniki kontrybutorskie, nadmiarowy boilerplate), dodaj jawne ograniczenie: “Do NOT create files I did not list. Only generate the files specified above.”

Co dalej

Zrozumienie baz kodu z Codex Uzyj Codex na roznych powierzchniach do mapowania architektury i onboardingu do nieznanego kodu

Budowanie funkcji z rownoleglymi agentami Uruchamiaj wiele watkow worktree do rownoleglego rozwijania funkcji