Paano ito gumagana

Paano gumagana ang RADAR.

Isang teknikal na overview para sa mga developer. Pinapatakbo ng RADAR ang mga coding agent at isinasara lang ang isang task pagkatapos nitong muling patakbuhin mismo ang acceptance test ng task. Claim ang “tapos na” ng isang agent; ang muling pagpapatakbo ang patunay.

01 Ang loop

Iisang loop para sa bawat task.

Dumadaan ang bawat task sa parehong loop, at tumatakbo lang ang bawat hakbang kung pumasa ang naunang hakbang.

01 · buksan Task at acceptance test Isinusulat bago magsimula ang trabaho
02 · lease Isang may-ari, sariling worktree Lease at fence token
03 · trabaho Nagtatrabaho ang agent Sa sarili nitong kopya ng proyekto
04 · claim Sinasabi ng agent na tapos na Itinatala bilang claim, hindi bilang resulta
05 · suriin Muling pinapatakbo ng RADAR ang test Sa kasalukuyang revision
kapag pumasa Sarado Iniingatan sa ledger ang patunay
kapag bumagsak · subok n sa 3 Muling binuksan, kalakip ang pagbagsak Susubok muli ang parehong agent mula sa hakbang 03
pagkatapos ng 3 subok Papalit ang ibang agent Hanggang 3 pang subok, mula sa hakbang 03
pagkatapos ng 3 pa Hinihintay ka ng task Tinatanggihan ng ledger ang mga susunod na subok

Larawan 1 · Ang task loop. Humahantong ang claim sa muling pagpapatakbo, hindi kailanman diretso sa pagsasara.

Buksan: Binubuksan ang isang task kasama ang layunin nito at isang acceptance command na maaaring muling patakbuhin. Sinusuri ang command pagkabukas ng task, nang hindi ito pinapatakbo: ang criterion na hindi tatakbo ayon sa pagkakasulat ay tinatanggihan agad, sa halip na matuklasan pa sa dulo.
Lease: Iisang may-ari lang ang may hawak ng isang task sa bawat pagkakataon, sa pamamagitan ng lease at fence token. Tinatanggihan ang write mula sa lipas nang may-ari.
Trabaho: Nagtatrabaho ang agent sa sarili nitong git worktree, sa sarili nitong branch.
Claim: Itinatala bilang claim ang ulat ng agent na tapos na ito. Hindi isinasara ng claim ang task.
Suriin: Ang RADAR mismo ang nagpapatakbo ng acceptance command, sa kasalukuyang revision ng trabaho. Binabasa ang sariling ulat ng agent, pero hindi ito patunay.
Isara o buksang muli: Kapag pumasa, maaaring isara ang task, at iniingatan ang verify record bilang patunay nito. Kapag bumagsak, muling binubuksan ang task, kalakip ang detalye ng pagbagsak.
Mga limitasyon: Tatlong subok ng worker, saka tatlong takeover ng ibang agent. Pagkatapos nito, tinatanggihan na ng ledger ang mga dagdag na subok at hinihintay ka ng task. Hindi nare-reset ang bilang kapag nagpalit ng model, session o machine, at kailangang sabihin ng bawat muling subok kung ano ang nagbago.

02 Ang ledger

Iisang talaan na sinusulatan ng bawat agent.

Iisang task ledger ang binabasa at sinusulatan ng bawat agent: isang lokal na SQLite file. Ito ang nag-iisang talaan kung sino ang may hawak ng bawat task, ano ang na-claim at ano ang ipinakita ng test.

Mga task: Ang layunin at ang acceptance command, na isinusulat bago magsimula ang trabaho.
Pagmamay-ari: Ang kasalukuyang may-ari ng bawat task, kasama ang lease at fence token nito.
Mga subok: Binibilang kada task, sa lahat ng agent, model at machine.
Mga claim: Ang ulat ng agent na tapos na ang trabaho, nakahiwalay sa mga resulta.
Mga verify record: Bawat acceptance run, nakatali sa commit at sa working tree kung saan ito tumakbo.
Mga pagbabago: Itinatala ang binagong acceptance command kasama ang luma at bagong bersyon nito; itinatala rin ang override.

Memory

Ang mga desisyon at aral ay mga Markdown note na may pinagmulan at saklaw. Hinahanap ang mga ito offline ng isang lokal na index, at inilalagay ng isang hook ang mga tumutugmang note sa harap ng agent bago ito kumilos. Dahil plain Markdown ang mga note, mabubuksan mo ang mga ito sa Obsidian.

03 Paghihiwalay

Bawat subok sa sarili nitong kopya.

Tumatakbo ang bawat subok sa sarili nitong git worktree, sa sarili nitong branch. Hindi kailanman nagsasalo sa iisang tree ang dalawang worker.
Hindi maaaring isulat muli ng worker ang sarili nitong acceptance command. Ang manager lang ang makakapagbago nito, at bago lang maisara ang task; iniingatan ng bawat pagbabago ang luma at bagong bersyon.
Nakakarating lang ang trabaho sa main branch mo pagkatapos pumasa ng verify, at muling pinapatakbo ang acceptance command pagkatapos ng merge.
Tinatanggihan ang force-push para sa lahat ng role.
Tumatakbo ang mga panuntunang ito bilang code, bago at pagkatapos tawagin ang isang model. Hindi ito prompt, kaya hindi ito malulusutan ng isang agent sa pamamagitan ng pakikipagtalo.

04 Mga agent

Ang mga agent na gamit mo na.

Pinapatakbo ng RADAR ang Claude Code, Codex CLI, OMP at Hermes Agent, sa computer mo o sa sarili mong mga Linux server. Hindi sila pinapalitan nito: sila pa rin ang gumagawa ng trabaho.

Claude Code
Codex CLI
OMP
Hermes Agent

Iisang kontrata: Pareho ang mga panuntunan, ang ledger, ang verify gate at ang mga limitasyon sa subok para sa apat.
Manager: Ang agent na kausap mo ang namamahala: nagbubukas ito ng mga task, ipinapasa ang mga ito sa mga worker at isinasara lang ang isang task kapag may pumasang verify record.
Mga worker: Ginagawa ng mga worker ang trabaho sa sarili nilang mga worktree. Hindi sila makakapagsara ng task at hindi nila mababago ang kanilang acceptance command.

05 Lokal muna

Lokal muna.

Hindi nangangailangan ang RADAR ng account o cloud.

Sa machine mo: Ang ledger, ang mga memory note, ang mga worktree at bawat verify run, sa computer mo o sa sarili mong mga Linux server.
Nangangailangan ng network: Ang mga agent mo, na nakikipag-usap sa sarili nilang mga provider gaya ng ginagawa nila ngayon. Opsyonal ang bawat iba pang panlabas na serbisyo at nakapatay hangga't hindi mo binubuksan.
Mga kailangan: Windows o Linux (hindi pa sinusuportahan ang macOS), Python 3.12 o mas bago, at Git. Ang standard library lang ng Python ang ginagamit ng RADAR.
Gastos: Walang sariling bayarin. Patuloy na ginagamit ng mga agent ang mga account na ginamit mo para mag-sign in sa kanila. Gumagamit lang ng bayad na API kung papangalanan mo ang provider at ang budget.
Pag-install: Ibigay sa iyong coding agent ang link ng repository at sabihing “i-install ito”. Sinusuri nito ang computer mo, nagtatanong muna bago mag-install ng anumang kulang, ini-install ang RADAR sa isang virtual environment at iniuulat ang sinasabi ng radar init at radar doctor.

06 Mga command

Isang maikling listahan ng mga command.

Ang mga command na una mong gagamitin. Nasa loob ng angle bracket ang mga placeholder.

Command	Ang ginagawa nito
`radar init`	Inihahanda ang home ng RADAR at ang ledger.
`radar doctor`	Sinusuri ang install at inililista ang mga opsyonal na serbisyong hindi pa naka-configure.
`radar task new --project P --goal "…" --accept "<command>"`	Nagbubukas ng task kasama ang acceptance command nito.
`radar dispatch <task>`	Ipinapasa ang isang task sa isang agent, na nagtatrabaho sa sarili nitong worktree.
`radar status`	Ipinapakita ang buong sistema.
`radar verify <task>`	Muling pinapatakbo ang acceptance command sa kasalukuyang revision.
`radar task done <task> --evidence "<verification report>"`	Isinasara ang isang task. Tinatanggihan hangga't hindi pumapasa ang verify.
`radar collect`	Kinokolekta ang natapos na trabaho.
`radar integrate`	Mine-merge sa main ang na-verify na trabaho.
`radar stop`	Ipinaparada ang trabaho at itinatakda ang STOP.
`radar go`	Inaalis ang STOP at inililista kung ano ang maaaring ituloy.
`radar memory search --local "<words>"`	Hinahanap offline ang mga memory note.
`radar uiradar web`	Binubuksan ang cockpit sa terminal o sa browser.
`radar help --all`	Inililista ang bawat command. Ibinibigay ng radar <command> -h ang mga detalye.

07 Ang hindi nito ginagawa

Ang hindi ginagawa ng RADAR.

Hindi nito pinapalitan ang mga agent mo. Sila pa rin ang sumusulat ng code; binibigyan sila ng RADAR ng iisang talaan, iisang pagsusuring hindi nila malalaktawan at iisang memory.
Hindi nito isinusulat ang mga test mo. Kasinghusay lang ng test nito ang isang pagsusuri; ipinasusulat ng RADAR nang malinaw ang test bago magsimula ang trabaho, para mabasa ito ng isang tao.
Hindi nito isinasara ang trabahong walang test. Tinatanggihan pagkabukas pa lang ang task na walang acceptance command na maaaring patakbuhin.
Hindi nito pinapanatiling offline ang mga agent mo. Nakikipag-usap pa rin sila sa sarili nilang mga provider, gaya ng ginagawa nila ngayon.
Para sa mga indibidwal na developer ang bukas na edisyon, hindi para sa mga team; may company edition na ginagawa.

08 Status

Nasa early access

Early access ngayon. Open source pagdating ng pampublikong release.

Nasa early access ang RADAR. Ilalathala ito bilang open source sa ilalim ng lisensyang Apache-2.0 pagdating ng pampublikong release. Para sumali, sumulat sa amin.

Sumali sa early access Bumalik sa RADAR