Plan Mode režimas Claude Code: nuoseklus vadovas ir 4 etapai 2026 m.
MarkdownPlan Mode režimas Claude Code: kas tai yra, kaip jį įjungti paspaudus Shift+Tab, 4 Anthropic etapai, paruošti naudoti užklausų šablonai ir komanda /goal savarankiškoms nakties užduotims.
Skaityti visą straipsnį
Papildomų instrukcijų rasite Ailoot dokumentacijoje.
Kas yra Plan Mode režimas ir kodėl vien jo nepakanka?
Svarbiausia mintis
Plan Mode režimu Claude Code skaito failus, analizuoja kodą ir siūlo pakeitimų planą, tačiau nieko nerašo, kol nepatvirtinate. Jis įjungiamas du kartus paspaudus Shift+Tab arba naudojant vėliavėlę --permission-mode plan. Jis naudingas, kai požiūris neaiškus, kodas nepažįstamas ar pakeitimas kelia reikšmingą kelių failų arba veiklos riziką. Aiškiam mažos rizikos vienos eilutės rašybos pataisymui atskiro planavimo etapo paprastai nereikia.
Įprastu režimu Claude Code iškart rašo kodą, o jei nestebite, netikėtai galite gauti daug failų apimantį pakeitimų rinkinį. Plan Mode pakeičia veiksmų seką: pirmiausia tyrimas ir planavimas, tada patvirtinimas, o po to pakeitimai.
Anthropic oficialioje dokumentacijoje Plan Mode aprašo taip:
Plan Mode nurodo Claude ištirti ir pasiūlyti pakeitimus jų neatliekant. Claude skaito failus, vykdo apvalkalo komandas, kad išsiaiškintų situaciją, ir parengia planą, tačiau kodo neredaguoja.
Skamba paprastai, bet čia slypi svarbiausias pokytis. Plan Mode pakeičia darbo ritmą: pirmiausia susitariama, o tada veikiama. Pasikeičia darbo režimas, o ne vien kosmetinė detalė. Vibe coding kūrėjams sunku tai, kad DI agentai linkę skubėti. Jei įprastu režimu paprašysite „Pridėk „Google“ autentifikavimą“, Claude per minutę parašys kodą, bet pusė failų bus ne tie. Plan Mode režimu tas pats prašymas virsta tekstiniu planu, kurį galite perskaityti per dvi minutes ir pataisyti dar prieš paliečiant kodą.
Štai spąstai, apie kuriuos tarptautiniuose vadovuose niekas nerašo. Vien Plan Mode yra silpnas įrankis: planas egzistuoja tik dabartiniame pokalbyje. Uždarykite langą ir planas dings. Negalite jo perduoti kitam agentui. Nėra versijų ar istorijos. Jei užduotis didelė (pavyzdžiui, 30 failų modulio pertvarkymas ar perėjimas prie naujos duomenų bazės), planas greitai atsitrenks į konteksto lango ribą ir ims prastėti.
Todėl Plan Mode puikiai dera su saugykloje esančiu plans/ aplanku. Planas išsaugomas kaip plans/2026-05-21-google-oauth.md, suskaidomas į etapus su žymimaisiais langeliais, o bet kuris kitas agentas gali jį perimti. Taip veikia konteksto inžinerija: kontekstas valdomas prieš raginimą, o ne jo metu.
Kaip įjungti Plan Mode Claude Code?
Svarbiausia mintis
Yra keturi oficialūs būdai įjungti Plan Mode. Vykstant sesijai du kartus paspauskite Shift+Tab arba prieš raginimą įrašykite prefiksą /plan. Paleisdami naudokite vėliavėlę claude --permission-mode plan. Visam laikui nustatykite lauką defaultMode faile .claude/settings.json. Aktyvaus režimo indikatorius terminalo apačioje yra ⏸ plan mode on.
Greičiausias būdas sesijos metu – naudoti klaviatūrą:
Shift+Tab # cikliškai perjungia režimus: default → acceptEdits → plan
Paspaudus du kartus, terminalo apačioje pasirodys indikatorius ⏸ plan mode on. Trečias paspaudimas grąžina į įprastą režimą. Tai patogiausias būdas – įjungiate režimą iškart, kai pastebite, kad užduotis plečiasi.
Antras būdas – prieš vieną raginimą pridėti prefiksą:
/plan parašyk planą, kaip perkelti duomenų bazę iš MySQL į Postgres
Ši parinktis naudinga, kai įjungtas automatinio patvirtinimo režimas ir nenorite jo keisti visai sesijai. Viena užklausa Plan Mode režimu, o tada darbas tęsiamas kaip anksčiau.
Trečias būdas – įjungti režimą paleidžiant sesiją:
claude --permission-mode plan
Naudokite šį būdą, kai iš anksto žinote, kad užduotį reikia suplanuoti. Pavyzdžiui, prieš didelį pertvarkymą ar perkėlimą.
Ketvirtas būdas – nustatyti numatytąjį režimą projekto faile .claude/settings.json:
{
"permissions": {
"defaultMode": "plan"
}
}
Kada tai naudinga? Kai komanda dirba su sudėtinga sistema, kurioje kiekvienas pakeitimas gali paveikti gretimus modulius. Tuomet pagal numatytuosius nustatymus įjungtas Plan Mode apsaugo visus nuo atsitiktinių pakeitimų.
Dažnai pamirštamas penktas triukas: Ctrl+G atveria planą tekstų rengyklėje. Naudokite šią funkciją, kai planas beveik tinkamas, bet reikia performuluoti 2–3 punktus arba pridėti apribojimą. Redaguokite rankiniu būdu, išsaugokite, ir Claude tęs darbą su jūsų versija.
Kokie yra 4 pagrindiniai Anthropic Plan Mode etapai: Explore, Plan, Implement, Commit?
Svarbiausia mintis
Geriausios praktikos apraše Anthropic įvardija pagrindinę keturių etapų darbo eigą: Explore (skaityti failus ir nagrinėti kontekstą), Plan (sudaryti pakeitimų planą nieko neredaguojant), Implement (grįžti į įprastą režimą ir įgyvendinti planą), Commit (sukurti aprašomąjį įrašą ir PR). Kiekviename etape taikomi atskiri įrankių apribojimai.
Daugelyje vadovų aprašomi 3 etapai (Explore-Plan-Execute) arba tik 2 (Plan-Implement). Tai supaprastinimai. Savo oficialiame geriausios praktikos vadove Anthropic tiksliai aprašo 4 etapus. Skirtumas svarbus: atskiras Commit etapas skatina užfiksuoti rezultatą, užuot palikus jį kaip „dar šiek tiek pakoregavau, įrašą padarysiu vėliau“ – tai dažniausias prarasto darbo šaltinis.
Kuo tikslesnis planas, tuo mažiau iteracijų prireikia įgyvendinant. Jei planui skirsite 10 minučių, įgyvendinimui užteks vieno raginimo. Jei planą per minutę tik apmesite, valandą taisysite klaidas.
Štai kaip atrodo 4 etapai pridedant „Google OAuth“ (pavyzdys iš Anthropic Docs):
| Etapas | Ką daro Claude | Ką darote jūs | Režimas |
|---|---|---|---|
| Explore | Skaito /src/auth, ieško, kaip tvarkomos sesijos ir aplinkos kintamieji | Nustatote tyrimo apimtį | Plan Mode |
| Plan | Sudaro planą: kuriuos failus keisti, kuriuos naujus sukurti ir kokios rizikos kyla | Perskaitote planą, redaguojate naudodami Ctrl+G ir patvirtinate | Plan Mode |
| Implement | Įgyvendina planą, rašo OAuth srauto kodą, testus ir atgalinio iškvietimo logiką | Stebite kiekvieną taikomą pakeitimą | Default arba acceptEdits |
| Commit | Sukuria aprašomąjį įrašą ir atidaro „Pull Request“ | Patikrinate įrašo pranešimą ir peržiūrite PR | Default |
Kiekvienam etapui skirti ir skirtingi raginimai. Explore etape: „perskaityk /src/auth ir išsiaiškink, kaip tvarkome sesijas ir prisijungimą“. Plan etape: „noriu pridėti Google OAuth. Kuriuos failus reikia pakeisti? Sudaryk planą“. Implement etape: „įgyvendink OAuth srautą pagal savo planą, parašyk testus, paleisk testų rinkinį ir ištaisyk nesėkmes“. Commit etape: „sukurk aprašomąjį įrašą ir atidaryk PR“.
Svarbi detalė: Plan Mode netrukdo Claude vykdyti tyrimui skirtų komandų. Leidžiama naudoti Read, LS, Glob, Grep, žiniatinklio duomenų gavimo ir tyrimui skirtas apvalkalo komandas. Draudžiama tik naudoti Edit, Write ir bet kokias failų sistemos operacijas, kurios keičia duomenis. Taigi Claude gali perskaityti projekto struktūrą, vykdyti git log ir peržiūrėti testus, bet netyčia nieko nepakeis.
Kaip perskaityti Claude planą ir nuspręsti, ar jį patvirtinti?
Svarbiausia mintis
Gerame Claude plane pateikiamas konkrečių failų ir juose atliktinų pakeitimų sąrašas, nuosekli veiksmų seka, aiškios rizikos ir sėkmės kriterijai. Blogame plane vartojamos bendros frazės, pavyzdžiui, „atnaujinsiu autentifikavimo modulį“, nenurodant detalių. Spręsdami, ar jį patvirtinti, vadovaukitės toliau pateiktais 7 požymiais. Patikslinkite planą pastabomis arba redaguokite jį tiesiogiai naudodami Ctrl+G.
Baigęs kurti planą Claude pateikia kelias galimybes, ką daryti toliau:
- Patvirtinti ir pradėti automatiniu režimu
- Patvirtinti ir leisti atlikti pakeitimus
- Patvirtinti ir kiekvieną pakeitimą peržiūrėti rankiniu būdu
- Tęsti planavimą pateikiant pastabų
- Patikslinti naudojant Ultraplan (peržiūra naršyklėje)
Gebėjimas nuspręsti, ar patvirtinti planą, yra pagrindinis Plan Mode įgūdis. Lengva automatiškai paspausti „Patvirtinti“, o paskui tekti atšaukti įrašus. DI pataikūnas nori greitai atsakyti, o jūs norite kuo greičiau pereiti prie kodo. Klystate abu.
Geras planas atitinka 7 kriterijus:
- Konkretūs failų pavadinimai. Ne „atnaujinsiu autentifikavimą“, o „pakeisiu
src/auth/login.ts:42-58, sukursiusrc/auth/oauth-callback.tsir atnaujinsiusrc/auth/session.ts:103“. - Nurodyta veiksmų seka. Planas suskirstytas į etapus arba žingsnius, o ne aprašytas kaip „kažkaip viską padarysiu“.
- Įvardytos išorinės priklausomybės. Jei užduočiai reikia naujos bibliotekos, ji įtraukta į sąrašą. Jei reikia aplinkos kintamųjų, jie taip pat nurodyti.
- Išvardytos rizikos. Gerame plane sakoma: „Perkėlimas gali nutraukti esamas sesijas; reikia patikrinti X.“ Blogame apie šalutinius poveikius neužsimenama.
- Yra sėkmės kriterijai. „
test/authtestai sėkmingai vykdomi, linteris neranda klaidų, o kūrimo serveris paleidžiamas be klaidų.“ - Nėra „iš piršto laužtų“ prielaidų. Jei Claude sako „naudosiu biblioteką Z“, patikrinkite: ar ji išvis įdiegta projekte? Jei DI ją išgalvojo, pamatysite, kad ji nepaminėta faile
package.json. - Planą galima peržiūrėti viename ekrane. Jei paprastos funkcijos planas užima 200 eilučių, tikriausiai užduotis per didelė vienam planui. Suskaidykite ją į dalis.
Jei planas neįveikia patikros, turite tris pasirinkimus:
- Tęsti planavimą pateikiant pastabų – parašykite Claude konkrečią pastabą apie tai, kas nepatinka, ir jis perrašys planą.
- Ctrl+G – atverkite planą rengyklėje, redaguokite jį rankiniu būdu ir išsaugokite. Claude tęs darbą su jūsų versija.
- Patikslinti naudojant Ultraplan – planas perkeliamas į žiniatinklio Claude Code naršyklės režimą, kuriame peržiūrite dalis ir teikiate pastabas, o tada vykdote planą vietoje arba debesyje.
Jei įgyvendinant kas nors nepavyksta, nebandykite bet kokia kaina tęsti. Grįžkite į Plan Mode ir perrašykite planą. Taip dešimt kartų pigiau, nei vėliau atšaukti 40 įrašų.
Plan Mode ir plans/ aplankas: derinys ilgam kontekstui
Svarbiausia mintis
Vien Plan Mode veikia tik dabartiniame pokalbyje. Uždarykite langą ir planas dings. Saugykloje esantis plans/YYYY-MM-DD-feature.md aplankas paverčia planą patvariu artefaktu: failu su etapais, žymimaisiais langeliais ir būsenomis, kurį gali perimti bet kuris kitas agentas. Taip pereinama nuo „plano atmintyje“ prie „plano kode“.
Plan Mode yra Claude Code režimas. plans/ aplankas – juo paremta metodika. Jei naudosite Plan Mode be aplanko, po valandos darbo atsitrenksite į ribą.
Logika tokia. Claude konteksto langas yra sesijos atmintis. Jame telpa 1 milijonas žetonų, kai naudojamas Opus 4.7, tačiau tai viso jūsų pokalbio apimtis. Jei viename pokalbyje suplanuojate sudėtingą užduotį, tada liepiate ją įgyvendinti, aptariate klaidą, o paskui dar ką nors, langas „išsipučia“. Claude ima pamiršti ankstyvus sprendimus, painioti kontekstus ir vėl užduoti klausimus.
Sprendimas – auksinė taisyklė: viena užduotis – vienas pokalbis.
Štai kaip tai padaryti:
- 1 pokalbis – sudaryti planą. Įjunkite Plan Mode, aprašykite užduotį, ir Claude parengs planą. Išsaugokite jį kaip
plans/2026-05-21-feature-name.md. Uždarykite langą. - 2 pokalbis – suskaidyti į etapus. Atidarykite naują pokalbį. Paprašykite: „paimk
plans/2026-05-21-feature-name.mdir suskaidyk jį į etapus“. Išsaugokite atnaujintą failą. - 3 pokalbis – įgyvendinti 1 etapą. Atidarykite naują pokalbį. Paprašykite: „įgyvendink 1 etapą iš
plans/2026-05-21-feature-name.mdir pažymėk elementus, kai juos atliksi“. Uždarykite langą. - 4 pokalbis – įgyvendinti 2 etapą. Atlikite tą patį.
Kuo tai naudinga? Kiekvieno pokalbio konteksto langas lieka neužterštas. 3 etapo Claude nežino 1 etapo detalių, bet žino planą, nes failas plans/ yra saugykloje. Bet kuris kitas agentas (pagalbinis agentas, nauja sesija ar vykdymas per /goal) gali perimti planą ir tęsti darbą.
Požiūrių palyginimas:
| Savybė | Tik Plan Mode | Plan Mode ir plans/ aplankas |
|---|---|---|
| Patvarumas | Tik dabartiniame pokalbyje | Saugykloje visam laikui |
| Perdavimas kitam agentui | Neįmanomas | cat plans/file.md |
| Versijos ir istorija | Nėra | Per git diff |
| Pagalbinių agentų palaikymas | Tik dabartinėje sesijoje | Kiekvienam etapui skiriamas atskiras pagalbinis agentas |
| Žymimieji langeliai ir būsenos | Tik tekstas | Markdown žymimieji langeliai [ ] / [x] |
| Plano dydis | Ribotas lango | Bet kokio dydžio |
Kiekviena funkcija turi atskirą plano failą. Kai po trijų mėnesių reikia prisiminti, kodėl vienas mokėjimų paslaugų teikėjas pasirinktas vietoj kito, galite atverti atitinkamą planą ir perskaityti sprendimų istoriją: kas buvo aptarta, kokios galimybės svarstytos ir kodėl pasirinktas būtent šis kelias.
Tai nuolat atnaujinami darbo planai; statinė dokumentacija pasensta per kelis mėnesius.
Kaip priversti Claude dirbti, kol miegate, naudojant Plan Mode ir /goal?
Svarbiausia mintis
/goal – tai autonominis ciklas, apie kurį Anthropic kalba jau metus. Komanda /goal atsirado Claude Code v2.1.139 versijoje (2026 m. gegužės 11 d.). Ji nustato užbaigimo sąlygą, o Claude dirba be žmogaus įsikišimo, kol ši sąlyga įvykdoma. Nedidelis vertinimo modelis po kiekvieno ėjimo patikrina, ar sąlyga įvykdyta.
Pagrindinis ilgų DI sesijų apribojimas yra ne pats modelis, o žmogus, kuris spaudžia Enter. Kiekvieną kartą, kai Claude baigia ėjimą, jis laukia jūsų atsakymo. /goal panaikina šį laukimą.
Sintaksė paprasta:
/goal visi testai test/auth sėkmingi, o linteris švarus, arba sustoti po 20 ėjimų
Sąlyga gali būti iki 4000 simbolių ilgio. Vienai sesijai galima nustatyti vieną tikslą. Po kiekvieno ėjimo mažasis Haiku modelis peržiūri stenogramą ir nusprendžia: „sąlyga įvykdyta – baigti“ arba „neįvykdyta – tęsti kitą ėjimą“. Vertinimo modelis įrankių nekviečia, tik skaito.
Komandos tikslui išvalyti: /goal stop, /goal off, /goal reset, /goal none, /goal cancel.
Derinys su Plan Mode atrodo taip:
- Įjunkite Plan Mode (du kartus paspauskite
Shift+Tab). - Paprašykite: „sudaryk planą perkelti duomenų bazę iš MySQL į Postgres, išsaugok jį kaip
plans/2026-05-21-postgres-migration.mdsu etapais ir kriterijais“. - Peržiūrėkite planą, jį redaguokite ir patvirtinkite.
- Išeikite iš Plan Mode (dar kartą paspauskite
Shift+Tab). - Nustatykite tikslą: „užbaik visus
plans/2026-05-21-postgres-migration.mdetapus, pažymėk langelius, visi testai turi būti sėkmingi arba sustoti po 50 ėjimų“. - Užverkite nešiojamąjį kompiuterį ir eikite miegoti.
Ryte patikrinkite rezultatą: arba „✓ tikslas pasiektas“, arba „◎ sustota po 50 ėjimų“, taip pat bus pateikta atliktų darbų istorija.
Yra trys esminės /goal taisyklės, antraip švaistysite žetonus:
1 taisyklė: išmatuojama galutinė būsena. „Padaryk, kad atrodytų gražiai“ – netinka. „npm test grąžina 0, npm run lint grąžina 0, o faile CHANGELOG.md pridėtas įrašas“ – tinka.
2 taisyklė: aiški patikra. Sąlygoje turi būti nurodyta tai, ką galima patikrinti: komanda, failas ar galinis punktas. Ne „viskas veikia“, o „curl localhost:3000/api/users grąžina 200“.
3 taisyklė: apribokite ėjimų skaičių. Visada pridėkite „arba sustoti po N ėjimų“. Anthropic tai aiškiai rekomenduoja dokumentacijoje:
Norėdami apriboti, kiek ilgai vykdomas tikslas, į sąlygą įtraukite ėjimų arba laiko ribą, pavyzdžiui: „arba sustoti po 20 ėjimų“.
Jei įjungsite /goal ir nenurodysite „arba sustoti po“, biudžetas gali išsekti per naktį.
Koks 4 žingsnių ciklas Plan Mode paverčia inžineriniu procesu?
Svarbiausia mintis
Nestruktūruotas Plan Mode duoda vidutiniškus rezultatus. Tvirta darbo eiga viename lange apima 4 žingsnius: nustatyti faktus nesiūlant sprendimo, išnagrinėti galimybes pagal pavyzdžius internete, sudaryti išsamų planą ir numatyti rizikas 2–3 žingsnius į priekį, taip pat reikalauti pačiam patikrinti planą, ar jame nėra „iš piršto laužtų“ prielaidų. Ši seka sustabdo DI pataikūną.
Dažna klaida – klausti „kaip man tai ištaisyti?“: Claude pateikia sprendimą, jūs jį pritaikote, bet niekas neveikia arba viskas pablogėja. Tai ir yra „DI pataikūnas“: jis išmokytas greitai atsakyti, o jūs norite greičiau pereiti prie kodo. Šią problemą sprendžia 4 žingsnių ciklas.
Šis 4 žingsnių ciklas padeda išvengti tokio elgesio. Jis nuosekliai vykdomas vienos Plan Mode sesijos metu:
1 žingsnis. Nustatyti faktus, nesiūlant sprendimo.
Užklausa: „Patiriu štai ką: [simptomo aprašymas]. Dabar tavo užduotis – nustatyti faktus. Bet kokie sprendimai, idėjos ir patarimai draudžiami. Tik tai: ką stebiu, kokius veiksmus galima pakartoti, kokie duomenys turimi ir kokių duomenų trūksta. Griežta stabdymo sąlyga: N E S I Ū L Y K sprendimų; tik užfiksuok diagnozę.“
Taip sustabdomas pirmasis DI impulsas: „štai sprendimas“. Claude turi apsiriboti tuo, „kas žinoma ir kas nežinoma“.
2 žingsnis. Išnagrinėti galimybes pagal pavyzdžius.
Užklausa: „Dabar, kai diagnozė nustatyta, internete rask ankstesnių panašių problemų sprendimo pavyzdžių. Bent 3 skirtingus metodus. Kiekvienam pateik: nuorodą į pirminį šaltinį, trumpą aprašymą ir privalumus bei trūkumus mūsų atveju.“
Taip sustabdomas antrasis DI impulsas: „sugalvoti sprendimą vietoje“. Priverčiame jį ieškoti realių pavyzdžių, kuriuos galima patikrinti.
3 žingsnis. Išsamus planas ir rizikos.
Užklausa: „Pasirink geriausią 2 žingsnio variantą ir sudaryk išsamų planą: kokius konkrečius failus keisti, ką pridėti, ką pašalinti, kokius testus parašyti, kas gali sugesti ir kokios rizikos kyla 2–3 žingsnius į priekį.“
Tai įprastas Plan etapas, tačiau su vienu skirtumu: jis grindžiamas patikrintomis 2 žingsnio galimybėmis, o ne Claude spėjimais.
4 žingsnis. Patikrinti planą.
Užklausa: „Dabar privalomai patikrink planą pats. Sąžiningai jį peržiūrėk: ar yra vietų, kur ką nors išsigalvojai ir nepatikrinai pagal kodą, dokumentaciją ar 2 žingsnio pavyzdį? Jei taip, pažymėk tokias vietas ir pataisyk planą.“
Tai paskutinis filtras. Claude turi patikrinti savo samprotavimus ir pripažinti, kur haliucinavo. Šiame žingsnyje paprastai pataisomi bent 2 plano punktai.
Po šių 4 žingsnių planas paruoštas tvirtinti. Galite pradėti įgyvendinti žinodami, kad užduotis suprasta, galimybės įvertintos, o rizikos apsvarstytos.
Ši metodika skirta sudėtingoms klaidoms diagnozuoti ir architektūriniams sprendimams priimti – ten, kur klaidos kaina didelė. Pritaikyta Plan Mode, ji pašalina pagrindinę vibe coding kūrėjų problemą: „DI pasiūlė sprendimą, aš jį pritaikiau ir viskas sugedo“.
Kokie 5 paruošti raginimai tinka įprastoms Plan Mode užduotims?
Svarbiausia mintis
Paruošti raginimai sutaupo 10–15 minučių kiekvienai užduočiai ir pagerina plano kokybę. Yra penki universalūs šablonai: modulio pertvarkymui, duomenų bazės perkėlimui, naujai funkcijai pridėti, testams rašyti ir sudėtingai klaidai derinti. Kiekvienas pritaikytas 4 žingsnių ciklui ir susietas su plans/ aplanku.
1 šablonas. Modulio pertvarkymas.
Įjungiu Plan Mode. Užduotis: pertvarkyti modulį {module-name}.
1 žingsnis: išnagrinėk dabartinę modulio {module-path} struktūrą. Aprašyk:
- kurie failai priklauso moduliui
- kokių išorinių priklausomybių jis turi
- kurios dalys dubliuojasi
- kurios funkcijos pernelyg sudėtingos
2 žingsnis: internete rask 2–3 panašių modulių pertvarkymo pavyzdžių.
Bent 1 šaltinis turi būti oficiali Anthropic arba susijusios sistemos dokumentacija.
3 žingsnis: sukurk pertvarkymo planą faile plans/YYYY-MM-DD-refactor-{module}.md:
- kuriuos failus pervadinti
- kurias funkcijas iškelti į atskirus modulius
- kuriuos testus palikti, o kuriuos perrašyti
- rizikos: kas gali sutrikti naudotojams
4 žingsnis: patikrink planą. Ar jame yra „iš piršto laužtų“ prielaidų?
Perrašyk jas arba pašalink.
2 šablonas. Duomenų bazės perkėlimas.
Įjungiu Plan Mode. Užduotis: perkelti duomenų bazę iš {old} į {new}.
1 žingsnis: išnagrinėk dabartinę duomenų bazės schemą naudodamas {schema-reading-command}. Aprašyk:
- kokios lentelės yra ir koks jų dydis
- kokie ryšiai, indeksai ir apribojimai nustatyti
- kur saugomos perkėlimo procedūros
- kurie duomenys yra kritiniai
2 žingsnis: rask gamybinėse sistemose taikytų {old → new} perkėlimų pavyzdžių.
Bent 3 skirtingi metodai: pg_dump, dual-write, blue-green.
Kiekvienam išvardyk privalumus ir rizikas, atsižvelgdamas į mūsų duomenų kiekį.
3 žingsnis: sukurk perkėlimo planą faile plans/YYYY-MM-DD-db-migration.md:
- etapai (atsarginė kopija, perkėlimas, patikra, perjungimas)
- kiekvieno etapo sėkmės kriterijai
- veiksmų atšaukimo planas, jei kas nors nepavyktų
- su prastova ar be jos
4 žingsnis: patikrink planą. Ar visi skaičiai pagrįsti dokumentacija?
Ar visi žingsniai mintyse patikrinti pagal kūrimo aplinką?
3 šablonas. Naujos funkcijos pridėjimas.
Įjungiu Plan Mode. Užduotis: pridėti projekte funkciją {description}.
1 žingsnis: išnagrinėk, kaip projekte šiuo metu veikia panašios funkcijos.
Konkrečiai peržiūrėk:
- {file-1}
- {file-2}
- kokie architektūros šablonai naudojami
- kokie testai rašomi panašioms funkcijoms
2 žingsnis: rask, kaip ši funkcija įgyvendinta atvirojo kodo projektuose
su panašia architektūra. Bent 2 skirtingi metodai.
3 žingsnis: sukurk planą faile plans/YYYY-MM-DD-feature-{name}.md:
- naujų failų sąrašas
- keičiamų failų sąrašas su konkrečiomis eilutėmis
- įgyvendinimo seka
- kokius testus pridėti
- kokią taisyklę įrašyti į CLAUDE.md būsimoms sesijoms
4 žingsnis: patikrink planą. Ar jis atitinka projekto architektūrą?
Ar jame numatomos dar neįdiegtos bibliotekos?
4 šablonas. Testų rašymas.
Įjungiu Plan Mode. Užduotis: parašyti {name} modulio testus.
1 žingsnis: išnagrinėk modulį {path}. Nustatyk:
- viešąsias funkcijas ir jų signatūras
- vidines funkcijas, kurių NETESTUOSIME (įgyvendinimo detalių)
- ribinius atvejus: tuščią įvestį, klaidas, lygiagrečią prieigą
2 žingsnis: rask panašios užduočių klasės testų pavyzdžių
populiariuose atvirojo kodo projektuose, naudojančiuose tą pačią sistemą.
3 žingsnis: sukurk testų planą faile plans/YYYY-MM-DD-tests-{module}.md:
- kiekvienos viešosios funkcijos testų sąrašas
- kokių imitacijų reikia
- kokie fikstūrų rinkiniai reikalingi
- kokį patikros būdą naudoti (teiginių stilius)
4 žingsnis: patikrink planą. Ar visi testai tikrina veikimą, o ne įgyvendinimą?
Ar aprėpti ribiniai atvejai?
5 šablonas. Sudėtingos klaidos derinimas.
Įjungiu Plan Mode. Užduotis: išsiaiškinti klaidos {symptom-description} priežastį.
1 žingsnis: NUSTATYK FAKTUS. Sprendimai ir idėjos draudžiami. Tik:
- ką stebiu (tikslus klaidos tekstas)
- atkuriami žingsniai
- kokie duomenys turimi (žurnalai, pėdsakai, bibliotekų versijos)
- kokių duomenų trūksta (ką reikia surinkti papildomai)
2 žingsnis: rask šios klaidos pavyzdžių.
Bent 3 šaltiniai: „GitHub“ problemos, dokumentacija ir kiti techniniai šaltiniai.
Prie kiekvieno pateik nuorodą ir trumpą sprendimo santrauką.
3 žingsnis: sukurk diagnostikos planą faile plans/YYYY-MM-DD-bug-{name}.md:
- tikrintinos hipotezės (surikiuotos pagal tikėtinumą)
- kokias komandas ar scenarijus vykdyti kiekvienai hipotezei patikrinti
- tikėtinas kiekvienos patikros rezultatas
4 žingsnis: patikrink planą. Ar yra „iš piršto laužtų“ hipotezių?
Ar visos hipotezės susietos su 1 žingsnio faktais?
Nukopijuokite kiekvieną šabloną, pakeiskite {parameters} savo reikšmėmis ir įklijuokite į Claude Code, kai įjungtas Plan Mode. Gausite darbinį planą aplanke plans/, kurį galėsite patvirtinti ir naudoti įgyvendinimui.
Plan Mode ar įprastas režimas: kurį pasirinkti?
Svarbiausia mintis
Plan Mode naudokite neaiškiam požiūriui, nepažįstamam kodui, architektūriniams sprendimams, migracijoms ar reikšmingą šalutinį poveikį turintiems pakeitimams. Failų skaičius primena apsvarstyti priklausomybes, o ne nustato griežtą taisyklę. Nedidelį, suprastą ir mažos rizikos pakeitimą galima atlikti tiesiogiai; vien aprašymas vienu sakiniu nepadaro autentifikavimo ar migravimo saugaus.
Anthropic tai tiesiogiai teigia dokumentacijoje:
Planavimas naudingiausias, kai reikia išsiaiškinti požiūrį, kodas nepažįstamas arba pakeitimai kelia svarbų šalutinį poveikį. Nedidelį, aiškų ir mažos rizikos pakeitimą su akivaizdžia patikra galima atlikti tiesiogiai; vien trumpas tikslo aprašymas rizikos nepanaikina. Žr. Anthropic geriausią praktiką.
Atskiro plano atsisakykite tik tada, kai tikrasis pakeitimų rinkinys nedidelis, suprastas ir mažos rizikos. Planuokite, kai reikia atrasti požiūrį ar suderinti rizikingus kelių komponentų pakeitimus. Failų pavadinimų žinojimas ar gebėjimas apibendrinti tikslą vienu sakiniu nepanaikina migravimo, autentifikavimo ar duomenų vientisumo rizikų.
Sprendimų lentelė:
| Užduotis | Režimas | Kodėl |
|---|---|---|
| Rašybos klaida faile README | Default | Vienas failas, vienas pakeitimas, akivaizdus pakeitimų rinkinys |
| Kintamojo pervadinimas viename faile | Default | Apimtis aiški ir galima patikrinti nuorodas; įvertinkite šalutinį poveikį |
| Žurnalo eilutės pridėjimas | Default | Vienos eilutės pakeitimas, neliečiantis logikos |
| Naujo mygtuko pridėjimas puslapyje | Default | Jei mygtukas tik vienas ir aišku, kur jis turi būti, plano nereikia |
| Modulio pertvarkymas | Plan Mode | 5 ar daugiau failų, šalutinio poveikio rizika |
| Duomenų bazės perkėlimas | Plan Mode ir /goal | Kelių žingsnių procesas; reikia atšaukimo plano |
| Autentifikavimo pridėjimas | Plan Mode | Veikia 10 ar daugiau failų; saugumas kritiškai svarbus |
| Modulio testų rašymas | Plan Mode | Reikia nustatyti, ką testuoti |
| Neaiškios klaidos derinimas | Plan Mode ir 4 žingsnių ciklas | Nenustačius diagnozės, sprendimai bus netaiklūs |
| Visos sistemos perkėlimas į naują sistemą | Plan Mode, plans/ ir /goal per naktį | Ilga užduotis, kuriai reikia etapų ir autonominio ciklo |
Prieš rinkdamiesi režimą paklauskite, ar suprantami požiūris, šalutinis poveikis ir patikra. Tiesiogiai atlikite nedidelį, lokalų, mažos rizikos pakeitimą su akivaizdžia patikra. Pirmiausia planuokite esant neaiškumui, nepažįstamam kodui, migravimui, autentifikavimui ar kelių komponentų derinimui — net jei jau galite įvardyti visus 3–5 paveiktus failus.
Kaip suderinti Plan Mode, CLAUDE.md ir pagalbinius agentus patikimam darbui?
Svarbiausia mintis
Tinkamai sukonfigūruotas CLAUDE.md ir pagalbiniai agentai Plan Mode sustiprina 10 kartų. CLAUDE.md nustato taisykles, pagal kurias Claude rengia planą. Pagalbiniai agentai leidžia paskirstyti plano etapus lygiagrečiai dirbantiems agentams. Be šio derinio Plan Mode lieka vienkartiniu įrankiu.
CLAUDE.md yra failas, kurį Claude perskaito kiekvienos sesijos pradžioje, įskaitant Plan Mode. Jei CLAUDE.md nurodyta „niekada nekoduokite datų; visada gaukite jas iš duomenų bazės“, plane niekada nebus siūloma datų įrašyti tiesiogiai. Jei tokios taisyklės nėra, plane gali atsirasti bet kas.
Derinys veikia taip:
1 sluoksnis. CLAUDE.md nustato taisykles.
Faile nurodomos projekto technologijos, architektūros principai, draudimai („nenaudokite pasenusių API“) ir reikalavimai („visi el. laiškai turi naudoti bendrą išdėstymą“). Išsamus vadovas: Kaip sukonfigūruoti CLAUDE.md.
2 sluoksnis. Plan Mode pritaiko taisykles užduočiai.
Įjungus Plan Mode ir paprašius „pridėk OAuth“, Claude perskaito CLAUDE.md, pamato taisykles („žetonus saugok „Redis“, o ne duomenų bazėje“) ir iškart į jas atsižvelgia sudarydamas planą. Planas atitinka projekto architektūrą.
3 sluoksnis. Pagalbiniai agentai paskirsto darbą.
Jei planas suskaidytas į etapus, kiekvieną jų galima pavesti atskiram pagalbiniam agentui. Kiekvienas agentas dirba savo konteksto lange ir neužteršia pagrindinio pokalbio. plans/ aplanke esantis planas lieka pagrindiniu tiesos šaltiniu: pagalbiniai agentai jį perskaito, atlieka savo etapą ir atnaujina žymimuosius langelius.
Kokios 7 klaidos sužlugdo Plan Mode?
Svarbiausia mintis
Plan Mode dažnai sugenda dėl įprastų naudojimo klaidų, o ne dėl to, kad įrankis silpnas. Septynios pagrindinės klaidos: planą laikyti atmintyje, o ne faile; visas užduotis sudėti į vieną pokalbį; sudaryti planą be etapų; praleisti išsamų tyrimą; leisti DI pataikūnui siūlyti sprendimą be diagnozės; praleisti savitikrą; ir naudoti miglotas /goal sąlygas.
1 klaida. Planas yra tik pokalbyje.
Požymis: sudarėte planą, uždarėte langą ir norite grįžti kitą dieną, bet nieko nebėra – kontekstas prarastas. Sprendimas: visada išsaugokite planą saugyklos faile plans/YYYY-MM-DD-feature-name.md. Pokalbis yra rašomasis stalas, o failas – archyvas.
2 klaida. Visos užduotys atliekamos viename pokalbyje.
Požymis: vienoje sesijoje aptariate autentifikavimą, tada perkėlimą, naudotojo sąsajos dizainą, o paskui klaidą. Konteksto langas „išsipučia“, ir Claude pamiršta ankstesnius dalykus. Sprendimas: viena užduotis – vienas pokalbis. Baigėte planą? Uždarykite langą. Pradedate įgyvendinti? Atidarykite naują.
3 klaida. Vienas 3000 eilučių planas be etapų.
Požymis: planas yra, bet jame nėra žymimųjų langelių ar skirsnių. Neįmanoma suprasti, kas atlikta, o kas ne. Darbo deleguoti neįmanoma. Sprendimas: kiekvieną planą padalykite į 3–7 etapus. Kiekviename etape turi būti konkrečių veiksmų žymimųjų langelių sąrašas.
4 klaida. Prieš planą neatliekamas išsamus tyrimas.
Požymis: Claude siūlo sprendimą iš galvos, nes neprašėte jo ieškoti ankstesnių pavyzdžių. Po savaitės sužinote, kad atvirojo kodo bendruomenė jau seniai turi geresnį metodą. Sprendimas: 4 žingsnių ciklo 2 žingsnyje paprašykite Claude internete rasti 2–3 pavyzdžius prieš sudarant planą.
5 klaida. DI pataikūnas pateikia sprendimą be diagnozės.
Požymis: klausiate „kaip ištaisyti klaidą X?“, Claude pasiūlo sprendimą, jį pritaikote, o niekas neveikia arba viskas pablogėja. Sprendimas: visada pradėkite nuo „nustatyk faktus; sprendimai draudžiami“. Tik nustačius diagnozę pereikite prie galimybių.
6 klaida. Praleidžiama savitikra.
Požymis: planas atrodo įtikinamas, bet jame yra 2–3 „iš piršto laužtos“ prielaidos (išgalvota biblioteka, neegzistuojanti API ar netinkama versija). Įgyvendinimas sugenda būtent dėl jų. Sprendimas: 4 žingsnių ciklo 4 žingsnyje paprašykite Claude sąžiningai patikrinti planą ir pažymėti prielaidas.
7 klaida. Miglotos /goal sąlygos.
Požymis: nustatote /goal padaryk, kad atrodytų gražiai, paliekate veikti per naktį ir ryte sužinote, kad išnaudota 200 $ kvota. Sprendimas: naudokite tik išmatuojamas sąlygas, patikros komandą ir privalomą „arba sustoti po N ėjimų“. Jokių „padaryk gerai“ ar „nupoliruok“.
Aštuntoji klaida, kurią dažniausiai daro vibe coding kūrėjai, yra visiškas plans/ aplanko idėjos ignoravimas. Plan Mode be plans/ aplanko nėra metodika – tai žaislas. Jei naudojate Plan Mode, bet nekuriate failų, išnaudojate tik 10 % jo galimybių.
Ką daryti po pirmosios patirties su Plan Mode?
Svarbiausia mintis
Pirmoji patirtis su Plan Mode yra pradžia. Tolesni žingsniai: sukonfigūruokite CLAUDE.md, jei dar to nepadarėte (be jo planas kybo ore), sukurkite saugykloje plans/ aplanką kaip darbo metodikos dalį ir prieš miegą išbandykite /goal vienai autonominei užduočiai. Visų trijų elementų – Plan Mode, CLAUDE.md ir plans/ – derinys sudaro veikiančią sistemą.
Trys konkretūs, vis sudėtingesni žingsniai:
1 žingsnis. Sukonfigūruokite CLAUDE.md, jei jo dar neturite.
Be CLAUDE.md Plan Mode veikia „vakuume“ – Claude nežino projekto taisyklių ir siūlo planus, kurie pažeidžia architektūrą. Išsamus vadovas: Kaip sukonfigūruoti CLAUDE.md. Minimalus CLAUDE.md – tai 50–80 eilučių apie naudojamas technologijas, taisykles ir draudimus. Ilgis nėra svarbiausias. Svarbu konkretumas.
2 žingsnis. Sukurkite saugykloje plans/ aplanką.
Projekto šakniniame aplanke sukurkite plans/ aplanką. Susitarkite dėl pavadinimų formato: YYYY-MM-DD-feature-name.md. Kiekvienam planui skirkite atskirą failą. Po mėnesio turėsite 20–30 failų, o po šešių mėnesių – 100 ar daugiau. Tai gyva projekto sprendimų istorija.
3 žingsnis. Išbandykite /goal vienai užduočiai.
Pasirinkite užduotį, kurią paprastai rankiniu būdu atliekate per 30–40 minučių. Įjunkite Plan Mode, sudarykite planą ir išsaugokite jį aplanke plans/. Išeikite iš Plan Mode. Nustatykite /goal complete all phases in plans/file.md, all tests pass, or stop after 30 turns. Valandai užverkite nešiojamąjį kompiuterį ir užsiimkite kuo nors kitu. Grįžkite ir patikrinkite rezultatą.
Šių trijų žingsnių pakanka pradžiai. Visa tai formuojasi palaipsniui – nebandykite visko įdiegti per vieną vakarą. Pradėkite nuo CLAUDE.md, po savaitės pridėkite plans/, o po mėnesio išbandykite /goal per naktį.
Šaltiniai
Kai būsite pasiruošę, susipažinkite su Ailoot.
Išsamiau
Klausimai ir atsakymai
Ar galima praleisti planavimą vien žinant, kurie failai keisis?
Ne. Žinomi failų pavadinimai nepanaikina neaiškumo dėl šalutinio poveikio ar patikros. Planuokite migravimus, autentifikavimo ir suderintus komponentų pakeitimus net tada, kai jų failų sąrašas jau aiškus.
Kada atskiras Plan Mode etapas nereikalingas?
Nedidelį, suprastą, mažos rizikos pakeitimą su akivaizdžia patikra, pavyzdžiui, vietinę rašybos klaidą, pagrįsta taisyti tiesiogiai. Planuokite, kai požiūris neaiškus, kodas nepažįstamas arba reikia išnagrinėti veiklos ir kelių failų rizikas.