Pane Codex, Claude Code ja Cursor töötama ühe CLI-põhise meeskonnana

Codex, Claude Code ja Cursor suudavad juba repositooriume muuta, käske käivitada ja projektijuhendeid järgida. Enamiku tiimide puhul ei ole puuduv lüli järjekordne agendiraamistik. Puudu on toimimisleping, mis muudab kolm võimekat tööriista spetsialiseerunud tiimikaaslasteks.

See artikkel näitab, kuidas seda teha failide ja CLI-dega, mis sul juba olemas on:

• Jagatud projektijuhendid failis AGENTS.md
• Claude’i sild faili CLAUDE.md kaudu, mis impordib @AGENTS.md
• Cursori baasjuhendid pluss valikulised .cursor/rules
• Rollidevaheline kindla vormiga Markdowni üleandmisfail
• Mitteinteraktiivsed CLI käivitused disaini, ülevaatuse ja teostuse jaoks

Siin ei ole vaja eraldi projektihaldusplatvormi. Kui tahad hiljem agentide vahel jagatud tööjärge, ühenda see artikliga Lineari mitme agendi projektihaldus. Siin koordineeritakse tööd Giti ja Markdowni abil.

Tootefunktsioonid kontrollitud 2026-07-29 järgmiste allikate põhjal: AGENTS.md, OpenAI Codex AGENTS.md guidance, Codex non-interactive mode, Claude Code memory docs, Claude Code CLI reference ja Cursor CLI docs.

Tiimi kuju

Usaldusväärne algspetsialiseerumine:

Need rollid on kokkulepped, mitte tarnija seatud piirangud. Iga tööriist oskab disainida, üle vaadata või teostada. Spetsialiseerumine aitab, sest see sunnib peale artefaktipiiri: üks agent kirjutab plaani, teine ründab seda, kolmas teostab ainult selle, mis ülevaatuse üle elas.

Jagatud juhendid: üks tõeallikas

Kasuta AGENTS.md kaasaskantava baasina

AGENTS.md on Agentic AI Foundationi hallatav tööriistaülene juhendiformaat. Codex loeb seda otse. Cursor toetab juurkataloogi faili AGENTS.md jagatud projektijuhisena (kõrvuti kaustaga .cursor/rules). Hoia see lühike ja praktiline:

# AGENTS.md

## Käsud
- Paigaldus: `pnpm install`
- Testid: `pnpm test`
- Tüübikontroll: `pnpm typecheck`
- Lintimine: `pnpm lint`

## Muudatuste reeglid
- Üks käitumismuudatus haru kohta
- Eelista uutele sõltuvustele olemasolevaid abifunktsioone
- Ära muuda saladusi ega `.env*` faile
- Ära ühenda muudatusi harusse `main`

## Mitme agendi protokoll
- Loe enne alustamist kataloogi `docs/handoffs/`
- Kirjuta olek aktiivsesse üleandmisfaili
- Kavandaja, ülevaataja ja teostaja peavad olema eri käivitused
- Peatu autentimise, maksete, tootmistaristu või andmete kustutamise juures

OpenAI Codexi dokumentatsioon kirjeldab failide leidmist projekti juurkataloogist töökataloogini, kusjuures lähemal asuvad failid on ülimuslikud; samuti valikulist faili AGENTS.override.md ja vaikimisi kehtivat summaarset mahupiirangut (32 KiB, kui seda ei tõsteta). Hoia juurfail napp; pane paketipõhised reeglid pesastatud AGENTS.md failidesse.

Ühenda Claude Code failiga CLAUDE.md

Claude Code loeb faili CLAUDE.md, mitte AGENTS.md. Ametlik soovitus on jagatud fail importida:

@AGENTS.md

## Claude Code
- Eelista enne kataloogi `src/billing/` või autentimiskoodi muutmist plaanirežiimi
- Ülevaatusülesande puhul ära teosta muudatusi, kui üleandmisfaili olek pole `implement` või `fixes`

Sümlink (ln -s AGENTS.md CLAUDE.md) sobib samuti, kui Claude’i-põhiseid lisandeid pole vaja. Windowsis eelista @AGENTS.md importi.

Kontrolli laadimist Claude’i käsuga /context ja vaata jaotist Memory files.

Hoia Cursori-põhised reeglid kitsad

Cursor võib jagatud kokkulepete jaoks kasutada juurkataloogi AGENTS.md faili. Kasuta .cursor/rules/*.mdc ainult Cursori-põhiste vajaduste jaoks, näiteks glob-mustriga piiritletud reeglite jaoks. Ära pea üleval kolme lahknevat entsüklopeediat.

Handoff-fail on tiimikaaslaste vestlus

Loo kataloog:

mkdir -p docs/handoffs

Kasuta ühte faili tööüksuse kohta:

docs/handoffs/2026-07-29-pricing-section.md

# Üleandmine: hinnastuse jaotis

- ID: pricing-section
- Status: design
- Owner now: codex
- Next owner: claude
- Branch: codex/design-pricing-section
- Worktree: ../app-pricing-section

## Goal
Teosta turunduslehe hinnastuse jaotis olemasolevate `Section`- ja `PlanCard`-mustrite järgi.

## Non-goals
Arveldamine, kupongid ja kasutajakohtade arvutused.

## Design
(Selle täidab Codex.)

## Review
(Selle täidab Claude.)

## Implementation notes
(Selle täidab Cursor.)

## Verification
- Command: `pnpm test:e2e --grep "pricing"`
- Last result:

## Decision log
- 2026-07-29 Codex: koostas komponentide piirid

Staatusväärtused, mis hästi toimivad (tsüklitega, mitte ühesuunalise liuguna):

1. design
2. design-review — blokeerivad leiud saadavad töö tagasi olekusse design; puhas ülevaatus viib edasi olekusse implement
3. implement
4. impl-review — blokeerivad leiud viivad olekusse fixes; puhas ülevaatus seab oleku done
5. fixes — teostaja lahendab leiud ja naaseb siis olekusse impl-review
6. done
7. blocked-human

Iga ülesanne ei satu olekusse fixes. Puhas impl-review võib minna otse olekusse done.

Iga CLI käivitus algab faili lugemisest ja lõpeb staatuse, omaniku ja Decision log’i uuendamisega. See ongi kogu orkestreerimiskiht.

Näide: pärast üht disaini ja ülevaatuse tsüklit

Illustratiivne väljavõte handoff-failist pärast seda, kui Codex disainis ja Claude vaatas üle:

- Status: implement
- Owner now: cursor
- Next owner: claude

## Design
Failid: `PricingSection.tsx` (uus), kasuta uuesti faili `PlanCard.tsx`
CTA must track clicks with `trackEvent()` + `getCtaClickProps()` from `src/lib/analytics.ts`
Mobiil: allpool katkestuspunkti `md` üksteise all, alates `md` kolm veergu
Plan IDs: `starter`, `pro`, `business`
Test: `pnpm test:e2e --grep "pricing"`

## Review
Blokeerivad leiud: puuduvad (katkestuspunkt ja pakettide ID-d on ülal Design-osas lahendatud)
Mitteblokeerivad leiud:
- CMS-i lisamisel eralda pakettide konstandid.

## Decision log
- 2026-07-29 Codex: komponentide esialgsed piirid
- 2026-07-29 Claude: requested breakpoint + explicit plan IDs
- 2026-07-29 Codex: uuendas Design-osa; Claude kinnitas blokeerivate leidude lahendused → implement

See artefakt on see, mida Cursor peaks järgima. Vestluse ajalugu on valikuline. Fail on kohustuslik.

Paigalda ja käivita iga CLI

Täpsed paigaldusteed muutuvad; kasuta iga tarnija praegust paigaldusjuhendit. Oluline on mitteinteraktiivse käivitamise muster.

Codex: disainietapp

Codexi mitteinteraktiivne režiim on codex exec. Vaikimisi töötab see ainult lugemisõigusega liivakastis. Disainitöö, mis handoff-faili uuendab, vajab workspace-write õigust:

cd ../app-pricing-section
codex exec --sandbox workspace-write "$(cat <<'EOF'
Loe faile AGENTS.md ja docs/handoffs/2026-07-29-pricing-section.md.
Olek on design. Koosta ainult Design-osa:
- kavandatud failid
- komponentide ja API piirid
- testiplaan
- riskid
- lahtised küsimused
Ära teosta rakenduse koodi.
Sea olekuks design-review ja järgmiseks omanikuks claude.
Lisa Decision log'i kirje.
EOF
)"

Kasuta interaktiivset codex-i ainult siis, kui tahad disaini reaalajas suunata. Skriptide ja järjestatud käivituste puhul eelista codex exec.

Claude Code: ülevaatusetapp

Claude Code’i print-režiim saab handoff-faili üle vaadata ja uuendada, aga ainult siis, kui sinu õiguste seaded lubavad selles worktree’s kirjutada. Hoia ulatus kitsas:

cd ../app-pricing-section
claude -p --permission-mode acceptEdits --max-turns 30 --max-budget-usd 5 --output-format text "$(cat <<'EOF'
Loe faile AGENTS.md, CLAUDE.md ja docs/handoffs/2026-07-29-pricing-section.md.
Oled ülevaataja. Ära teosta rakenduse koodi.
Otsi Design-osast puuduvaid äärejuhte, kohaliku arhitektuuriga vastuolus olevaid valikuid, nõrku teste ja turbeprobleeme.
Kirjuta leiud Review-ossa blokeerivate ja mitteblokeerivate leidudena.
Blokeerivate leidude korral sea olekuks design ja järgmiseks omanikuks codex.
Muul juhul sea olekuks implement ja järgmiseks omanikuks cursor.
Lisa Decision log'i kirje.
EOF
)"

Kui sinu Claude’i õigusrežiim ei saa faile mitteinteraktiivselt kirjutada, tee ülevaatus ainult lugemisõigusega ja lase inimesel või skriptil Review-osa handoff-faili kleepida. Handoff-faili uuendamiseks ühekordses worktree’s eelista --permission-mode acceptEdits (või seadete lubatud loendit). Päris checkout’i puhul ära haara --dangerously-skip-permissions järele.

Kasulikud Claude Code’i juhtnupud skriptitud käivituste jaoks (vaata CLI reference):

• -p / --print mitteinteraktiivseks vastuseks
• --max-turns tsüklite piiramiseks
• --max-budget-usd kulude piiramiseks
• --output-format json|text|stream-json automatiseerimiseks
• --permission-mode acceptEdits, kui ülevaatus peab piiritletud worktree’s handoff-faili kirjutama

Ära kasuta --dangerously-skip-permissions kergekäeliselt tootmise checkout’ides.

Cursor: teostusetapp

Cursori CLI (agent). Eelista sedasama pühendatud worktree’d, mis on handoff-failis kirjas — ära teosta tööd peamises checkout’is:

cd ../app-pricing-section
agent -p --trust --sandbox enabled --output-format text "$(cat <<'EOF'
Loe faile AGENTS.md ja docs/handoffs/2026-07-29-pricing-section.md.
Olek peab olema implement või fixes.
Teosta ainult heakskiidetud Design-osa ja arvesta Review-osa blokeerivate leidude lahendustega.
Hoia muudatus väike. Lisa või uuenda Verification-osas nimetatud teste.
Käivita kontrollkäsk ja kirjuta tulemus üleandmisfaili.
Sea olekuks impl-review ja järgmiseks omanikuks claude.
Ära ühenda muudatusi.
EOF
)"

Olulised Cursori CLI lipud:

• -p / --print — mitteinteraktiivne; kirjutamise ja shell-tööriistade ligipääs on juba olemas
• --force / --yolo — kinnita shell-käsud automaatselt, kui neid pole keelatud; kasuta ainult ühekordsetes liivakastides, mitte koodi kirjutamise vaikevalikuna
• --sandbox enabled|disabled — käivituse liivakastirežiim; eelista enabled, kui teostad tööd koos lipuga --trust
• --trust — usalda tööruumi automatiseerimises
• -w / --worktree [name] — isoleeritud checkout kataloogis ~/.cursor/worktrees/<repo>/ (erineb käsitsi tehtud git worktree add teest; kui seda kasutad, uuenda vastavalt handoff-faili Branch/Worktree väljad)
• --mode plan või --mode ask — planeerimine või ainult lugemine
• --output-format text|json|stream-json

Ainult ülevaatuseks mõeldud Cursori käivituste puhul eelista ask/plan-režiime või selget juhist „ära muuda faile“. Eelista käsitsi git worktree add-i, et handoff-failis olev tee vastaks teostaja checkout’ile.

Vaata skriptitud töövoogude jaoks ka Cursori headless CLI juhendit.

Juhendfailide kaart (väldi tõe dubleerimist)

Kui reegel puudutab iga agenti, on selle koht failis AGENTS.md. Kui see puudutab ainult ühe tarnija funktsiooni, hoia see kohalikuna. Sama reegli dubleerimine kolmes failis tagab lahknemise.

Täielik näide kogu ahelast

Eeldame puhast repositooriumi ja alustamata funktsiooni.

1. Loo isoleeritud worktree

git fetch origin main
git worktree add -b feat/pricing-section ../app-pricing-section origin/main
cd ../app-pricing-section
mkdir -p docs/handoffs

Loo üleandmisfaili põhi jaotistega Goal, Non-goals ja Verification. Lisa see eraldi commiti, kui tiim tahab lepingut PR-is näha.

2. Codex disainib

Codex kirjutab Design-osa: failid, liidesed, testid, riskid. Staatuseks saab design-review.

Päris disainiväljund peaks olema umbes sellise kujuga:

## Design
Failid:
- `src/components/marketing/PricingSection.tsx` (uus)
- `src/components/marketing/PlanCard.tsx` (kasuta uuesti)
- `tests/e2e/marketing-pricing.spec.ts` (uus)

Piirid:
- `PricingSection` vastutab paigutuse ja pakettide loendi eest
- `PlanCard` jääb esitluskomponendiks
- CTA links use existing `trackEvent()` + `getCtaClickProps()` helpers

Testiplaan:
- kolm paketti on nähtavad
- CTA-de `href`-id lahenevad
- analüütika abifunktsiooni kutsutakse klõpsu kohta üks kord

Riskid:
- koodi sisse kirjutatud pakettide ID-d võivad CMS-ist lahkneda

3. Claude vaatab disaini üle

Ülevaatuse prompt nõuab blokeerivate ja mitteblokeerivate leidude eristamist, seega ebamäärased kavandid tulevad blokeerituna tagasi. Näide:

Blokeerivad leiud:
1. Mobiilipaigutuse otsus virnus olevate plaani kaartide jaoks puudub.
2. Disain ei ütle verifitseerimiskäsku (lisa see Design- ja Verification-jaotisesse).
Mitteblokeerivad leiud:
- Kaaluda plaaniandmete konstandi eraldamist.

Staatus naaseb olekusse design või liigub olekusse implement alles siis, kui blokeerivad punktid on Design-osas lahendatud.

4. Cursor teostab

Cursor teostab ainult heakskiidetud disaini. Ta käivitab:

pnpm test:e2e --grep "pricing"

Ta salvestab tulemuse, avab või valmistab ette PR-i ja seab staatuseks impl-review.

5. Claude vaatab teostuse üle

Teine Claude’i käivitus võrdleb diff’i üleandmisfailiga, mitte värskelt välja mõeldud ideaaliga. Blokeerivad leiud viivad oleku väärtusele fixes ja omanikuks saab cursor. Puhas ülevaatus seab väärtuse done, mille järel ühendab muudatuse inimene.

6. Inimene teeb merge’i

Kaitstud harud jäävad inimeste hallata. Agendid võivad olla kiired juuniorid. Nad ei tohiks olla väljalasete haldajad.

Shell-orkestreerimine ilma platvormita

Lihtsast järjestajast piisab:

#!/usr/bin/env bash
set -euo pipefail
ROOT="${1:?worktree path}"
HANDOFF="${2:?handoff file}"
cd "$ROOT"

status() {
  # Eelista üleandmisfaili alguses asuvat metaandmevälja Status.
  awk '/^- Status:/{print $3; exit}' "$HANDOFF"
}

case "$(status)" in
  design)
    codex exec --sandbox workspace-write "Loe faile AGENTS.md ja $HANDOFF. Täida ainult Design-osa, seejärel sea olekuks design-review ja järgmiseks omanikuks claude. Ära teosta rakenduse koodi."
    ;;
  design-review|impl-review)
    claude -p --permission-mode acceptEdits --max-turns 30 --max-budget-usd 5 --output-format text "Vaata $HANDOFF faili AGENTS.md järgi üle. Uuenda ainult Review-osa ja olekut. Ära teosta rakenduse koodi."
    ;;
  implement|fixes)
    agent -p --trust --sandbox enabled --output-format text "Olek peab olema implement või fixes. Teosta või paranda failide $HANDOFF ja AGENTS.md järgi. Uuenda üleandmisfaili. Ära ühenda muudatusi."
    ;;
  done|blocked-human)
    echo "Olek $(status) ei vaja agendi tegevust"
    ;;
  *)
    echo "Failis $HANDOFF on tundmatu olek" >&2
    exit 1
    ;;
esac

See on tahtlikult igav. Igavat orkestreerimist saab siluda. Hoia liivakastid ja õigusrežiimid nii kitsad, kui etapp lubab: disain ja ülevaatus ei tohiks vajada laia ligipääsu süsteemile.

Ebaõnnestumise mustrid

Mitteinteraktiivsed lipud, mis kinnitavad muudatusi või õigusi automaatselt, on mugavusvahendid liivakastide ja kitsalt piiritletud worktree’de jaoks. Need ei ole tootmise ligipääsukontrolli mudel.

Mida veel mitte automatiseerida

• Muudatuste ühendamine kaitstud harudesse
• Tootmisse juurutamine
• Saladuste vahetamine
• Skeemimigratsioonid ilma inimese üle vaadatud plaanita
• Iga töövoog, kus üleandmisfail ise tuleb ebausaldusväärselt väliselt esitajalt ilma puhastamiseta

Praktiline stardikomplekt

1. Lisa juurkataloogi AGENTS.md käskude, paikade reeglite ja mitme agendi protokolliga.
2. Lisa CLAUDE.md, mis sisaldab rida @AGENTS.md.
3. Lisa docs/handoffs/_template.md.
4. Vali üks väike funktsioon.
5. Käi disain → ülevaatus → teostus → ülevaatus üks kord käsitsi läbi.
6. Alles siis mähi staatused shell-järjestajasse.

Kui vajad, et samad agendid võtaksid ülesandeid ettevõtte jagatud tööjärjest, lisa Lineari MCP ning hõivamise ja ülevaatuse olekumudel artiklist Lineari mitme agendi projektihaldus. Markdowni üleandmisfail jääb kasulikuks ülesandepõhiseks tehniliseks märkmikuks.

Standard ongi leping

Codex, Claude Code ja Cursor kattuvad võimekuselt juba praegu. Tiimiks saavad nad siis, kui lõpetad abstraktse palve „töötage koos“ ja sunnid selle asemel peale nähtava lepingu:

• jagatud juhendid
• selge roll iga käivituse kohta
• olekuga Markdowni üleandmisfail
• isoleeritud worktree’d
• piiritletud CLI-käivitused
• inimese vastutus muudatuste ühendamise ja väljalaske eest

Sellest piisab, et tänaste tööriistadega tõsist kohalikku agenditiimi käigus hoida — ja piisab ka selleks, et kiiresti märgata, kui tiim inseneritöö asemel improviseerib.