Pane Codex, Claude Code ja Cursor töötama ühe CLI tiimina

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 handoff-markdown
• Mitteinteraktiivsed CLI käivitused disaini, ülevaatuse ja teostuse jaoks

Siin ei ole vaja eraldi projektihaldusplatvormi. Kui tahad hiljem agentide vahel jagatud backlog’i, ühenda see artikliga Lineari mitme agendi projektihaldus. Siin on koordineerimisvahendiks git pluss markdown.

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 natiivselt. Cursor toetab juurkataloogi AGENTS.md faili jagatud projektijuhisena (kõrvuti kaustaga .cursor/rules). Hoia see lühike ja praktiline:

# AGENTS.md

## Commands
- Install: `pnpm install`
- Test: `pnpm test`
- Typecheck: `pnpm typecheck`
- Lint: `pnpm lint`

## Patch rules
- One behavior change per branch
- Prefer existing helpers over new dependencies
- Do not edit secrets or `.env*` files
- Do not merge to main

## Multi-agent protocol
- Read `docs/handoffs/` before starting
- Write status back into the active handoff file
- Designer, reviewer, and implementer must be different runs
- Stop for auth, payments, production infra, or data deletion

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
- Prefer plan mode before edits on `src/billing/` and auth code
- For review jobs, do not implement unless the handoff status is `implement` or `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

# Handoff: pricing section

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

## Goal
Implement the marketing pricing section using existing Section/PlanCard patterns.

## Non-goals
Billing, coupons, seat math.

## Design
(Codex fills this)

## Review
(Claude fills this)

## Implementation notes
(Cursor fills this)

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

## Decision log
- 2026-07-29 Codex: drafted component boundaries

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
Files: `PricingSection.tsx` (new), reuse `PlanCard.tsx`
CTA must call `trackCta()` from `src/lib/analytics.ts`
Mobile: stacked below `md`, three columns from `md` up
Plan IDs: `starter`, `pro`, `business`
Test: `pnpm test:e2e --grep "pricing"`

## Review
Blocking: none remaining (breakpoint + plan IDs resolved in Design above)
Non-blocking:
- Extract plan constants later if CMS arrives.

## Decision log
- 2026-07-29 Codex: initial component boundaries
- 2026-07-29 Claude: requested breakpoint + explicit plan IDs
- 2026-07-29 Codex: updated Design; Claude cleared blocking items → 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'
Read AGENTS.md and docs/handoffs/2026-07-29-pricing-section.md.
Status is design. Produce the Design section only:
- proposed files
- component/API boundaries
- test plan
- risks
- open questions
Do not implement application code.
Set status to design-review and next owner to claude.
Append a Decision log entry.
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'
Read AGENTS.md / CLAUDE.md and docs/handoffs/2026-07-29-pricing-section.md.
You are the reviewer. Do not implement application code.
Challenge the Design section for missing edge cases, local-architecture mismatches, weak tests, and security issues.
Write findings into the Review section as Blocking vs Non-blocking.
If blocking findings exist, set status to design and next owner to codex.
Otherwise set status to implement and next owner to cursor.
Append a Decision log entry.
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'
Read AGENTS.md and docs/handoffs/2026-07-29-pricing-section.md.
Status must be implement or fixes.
Implement only the approved Design, respecting Review blocking resolutions.
Keep the patch small. Add or update tests from the Verification section.
Run the verification command and record the result in the handoff file.
Set status to impl-review and next owner to claude.
Do not merge.
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 handoff-faili põhi jaotistega Goal, Non-goals ja Verification. Commit’i see põhi, 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
Files:
- `src/components/marketing/PricingSection.tsx` (new)
- `src/components/marketing/PlanCard.tsx` (reuse)
- `tests/e2e/marketing-pricing.spec.ts` (new)

Boundaries:
- PricingSection owns layout and plan list
- PlanCard remains presentational
- CTA links use existing `trackCta()` helper

Test plan:
- three plans visible
- CTA hrefs resolve
- analytics helper called once per click

Risks:
- hardcoding plan IDs out of sync with CMS

3. Claude vaatab disaini üle

Ülevaatuse prompt nõuab Blocking/Non-blocking leide, seega ebamäärased disainid tulevad blokeerituna tagasi. Näide:

Blocking:
1. Mobiilipaigutuse otsus virnus olevate plaani kaartide jaoks puudub.
2. Disain ei ütle verifitseerimiskäsku (lisa see Design- ja Verification-jaotisesse).
Non-blocking:
- 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 handoff-failiga, mitte värskelt välja mõeldud ideaaliga. Blokeerivad leiud viivad staatuse olekusse fixes ja omanikuks saab cursor. Puhas ülevaatus seab done, mille järel teeb inimene merge’i.

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() {
  # Prefer the metadata Status field near the top of the handoff file.
  awk '/^- Status:/{print $3; exit}' "$HANDOFF"
}

case "$(status)" in
  design)
    codex exec --sandbox workspace-write "Read AGENTS.md and $HANDOFF. Fill Design only, then set status=design-review and next owner=claude. Do not implement application code."
    ;;
  design-review|impl-review)
    claude -p --permission-mode acceptEdits --max-turns 30 --max-budget-usd 5 --output-format text "Review $HANDOFF per AGENTS.md. Update Review + status only. Do not implement application code."
    ;;
  implement|fixes)
    agent -p --trust --sandbox enabled --output-format text "Status must be implement or fixes. Implement or fix per $HANDOFF and AGENTS.md. Update handoff. Do not merge."
    ;;
  done|blocked-human)
    echo "No agent action for $(status)"
    ;;
  *)
    echo "Unknown status in $HANDOFF" >&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

• Merge kaitstud harudesse
• Tootmisse juurutamine
• Saladuste vahetamine
• Skeemimigratsioonid ilma inimese üle vaadatud plaanita
• Iga töövoog, kus handoff-fail ise tuleb usaldamatult 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 tõmbaksid ülesandeid jagatud ettevõtte backlog’ist, lisa Lineari MCP ja claim/review-staatusmudel artiklist Lineari mitme agendi projektihaldus. Markdown-handoff jääb ikkagi kasulikuks issue’põhise tehnilise märkmikuna.

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
• handoff-markdown koos staatusega
• isoleeritud worktree’d
• piiritletud CLI-käivitused
• inimese vastutus merge’i 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.