Жоспарлау режимі: нағыз бет жасау

Келесі жиырма бес минутта бос қалтадан жұмыс істейтін тіркелу бетіне жетесің. Ең құнды әрекетің пернетақта теру болмайды. Ол — жоспарды оқу, әрі әлі бірде-бір файлың жоқ кезде сол жоспардың бір жолын өзгерту.

Anthropic құжаттамасы ретті төрт сөзбен береді: explore, plan, implement, commit — жоспарлау режимі (plan mode) алғашқы екеуін атқарады (үздік тәжірибелер). Себебі — қарапайым арифметика: зерттеудің бір қате жолы жоспардың бірнеше қате жолына, ал жоспардың бір қате жолы кодтың жүздеген қате жолына айналады. HumanLayer ережесі де содан шыққан: тек diff-ті емес, зерттеу мен жоспардың өзін тексер (контекст инженериясы).

Жоспар — басынан аяғына дейін оқып шығуға жететіндей қысқа. Оның diff-і — көз жүгіртіп қана өтетіндей ұзын. Арзанын оқы.

Бүгін QAIRU Event Sign-up жобасының алғашқы нағыз нұсқасын жасайсың: бір бет, бір іс-шара, орын брондайтын форма және кері санайтын есептегіш. Бәрі бір файлда: ешқандай framework те, build қадамы да жоқ.

Бос қалтадан commit-ке дейінгі тоғыз қадам

1. Агент тиіп үлгермей тұрып, қалтаны repo-ға айналдыр

   bashКөшіру

   mkdir qairu-event
   cd qairu-event
   git init

   Күтілетін нәтиже: Initialized empty Git repository және qairu-event/.git/ деп аяқталатын жол. Windows PowerShell-де үшеуін && емес, ; арқылы тізбекте — ол жерде && таңбасы The token '&&' is not a valid statement separator деп жазады.

   git init пәрменін аттап кетпе. Claude Code өзінің өңдеу құралдары тиер алдында файлдардың сақтық көшірмесін түсіреді, бірақ checkpoint жүйесі Bash пәрмендері енгізген өзгерістерді де, субагент түзетулерінің көбін де, басқа терезеде өзің өзгерткен файлдарды да қадағаламайды (checkpoint жүйесі). Checkpoint — жергілікті кері қайтару. Git — тұрақты кері қайтару.

2. Жоспарлау режимінде баста да, шынымен сонда екеніңе көз жеткіз

   bashКөшіру

   claude --permission-mode plan

   Жаңа қалтада алғаш іске қосқанда, жұмыс кеңістігіне сенім туралы сұрау шығады — келісім бер. Содан кейін енгізу өрісінің астындағы күй жолағын оқы. Онда plan mode on деп тұруға тиіс.

   Сеанс әлдеқашан ашылып қойған ба? Сол жазу шыққанша Shift+Tab тіркесімін бас. Басу саны әртүрлі: Pro, Max және Team тарифтерінде терминал сеансы енді auto режимінен басталады, сондықтан бірінші басқанда Manual-ға, сосын өңдеулерді қабылдауға, содан соң жоспарлауға өтеді — үш басу. Manual режимінен басталған сеансқа екі басу жетеді (сеанс қай режимнен басталады). Кейбір Windows жүйелерінде бұл тіркесім — Alt+M.

3. Бүкіл тапсырманы бір промптпен бер

   Мынаны дәл сол күйінде қой. Іс-шараның деректерін өзіңдікімен алмастыр немесе солай қалдыр.

   ❯Жасау промптыClaude Code · plan modeКөшіру

   Осы қалтада QAIRU Event Sign-up тіркелу бетін бір файл етіп жаса: index.html.
   Ешқандай framework, build қадамы, жаңа тәуелділік болмасын. Бүкіл CSS пен JS index.html ішінде.
   
   Бет БІР іс-шараны көрсетеді және келушіге орын брондауға мүмкіндік береді:
   - іс-шараның атауы, күні, уақыты, өтетін жері және ол туралы екі сөйлем
   - брондау формасы: аты, электрондық пошта, бір Reserve түймесі
   - 40-тан басталып, әр брондаудан кейін бірге азаятын "қалған орын" есептегіші
   - брондағандардың тізімі, ең жаңасы жоғарыда
   - орын 0 болғанда: форма өшіріледі және бетте іс-шараның толғаны жазылады
   - бет қайта жүктелгенде брондаулар сақталып қалады
   - аты бос, поштасы бос немесе поштасында "@" жоқ болса, көрінетін хабармен қабылданбайды
   
   Әзірге ешқандай код жазба.
   1. Осы қалтада қазір не бар екенін және нені қайта пайдаланбақ екеніңді айт.
   2. Жоспарды көрсет: реттелген қадамдар, әр қадам тиетін файл, әрі әр қадам үшін
      браузерде нақты нені басатынымды және нақты нені көретінімді жаз.
   3. Не істемейтіңді тізіп бер, әрі менен растауды қажет ететін болжамдарыңды айт.
   
   Тоқта да, менің мақұлдауымды күт. Мақұлдағанымда, басқа ештеңені өзгертпей тұрып,
   мақұлданған жоспарды PLAN.md етіп сақта.

   Ол қалтаны оқып шығады, оқуға ғана арналған бір-екі пәрмен орындайды да, тапқандарымен және нөмірленген жоспармен оралады. index.html файлын жасамайды: жоспарлау режимінде сен мақұлдағанша бастапқы кодты өңдеуге тыйым салынған (жоспарлау режимі). Ол жұмыс істеп тұрғанда Ctrl+T оның тапсырмалар тізімін ашып-жабады, ал Ctrl+O әңгіме жазбасын көрсетеді.

4. Жоспарды бүгін оқитын жалғыз мәтінің сияқты оқы

   Үш сұрақ.

   1. Әр қадамда мен орындай алатын тексеріс аталған ба? «Брондау формасын жаса» дегеннің жұмыс істегенін білуге жол жоқ — бұл қадам емес, тілек. Агентке өзі орындай алатын тексеріс беру — осы курстағы ең көп пайда әкелетін әдет (үздік тәжірибелер).
   2. Неге тиіспейтінін айтқан ба? Шекарасы айтылмаған агент сен мүлде сұрамаған нәрселерді қайта реттеп тастайды.
   3. Қасымда отырған адамға түсіндіріп бере алмайтын қадам бар ма? Кейін дәл сол қадам соққы береді.

   Екі жауап көңілден шықпаса, «No, keep planning» дегенді таңда да, себебін жаз: 3 және 5-қадамда браузерде тексеру жоқ. Екеуін де мен нені басатынымды, нені көруім керегін жазып қайта жаз.

5. Мақұлдар алдында бір жолды өзгерт

   Ctrl+G тіркесімін бас. Ұсынылған жоспар мәтін редакторыңда ашылады. Мынаны қос, сақта, жап.

   ❯Өзің қосатын жолYour editor · via Ctrl+GКөшіру

   - Келуші көретін әр жазба қазақша және ағылшынша болады. Беттің жоғарғы жолағындағы
     KK / EN түймесі екеуін ауыстырады және таңдауды есте сақтайды. Әдепкісі — қазақша.

   Дәл осы талап — бұл жобада бар, ал қарапайым тіркелу формасында жоқ нәрсе, әрі агент оны сен үшін өзі ойлап таппайды. Енді мақұлдайтын жоспарың ішінара өзіңдікі — жобаның жасалуын басқару мен оны жай ғана бақылап отырудың айырмасы осында.

6. Асықпай мақұлда

   Claude үш жауап ұсынады: auto режимін қосу, өңдеулерді қолмен мақұлдау немесе жоспарлауды жалғастыру. Auto режимі қолжетімсіз жерде біріншісі “Yes, auto-accept edits” деп тұрады.

   «Yes, manually approve edits» дегенді таңда. Бір diff-ті басынан аяғына дейін оқы — форманы жіберуді өңдейтін JavaScript кодын, себебі сен жазған ережелердің бар-жоғы дәл сол жерден көрінеді. Қалғанын қалаған жылдамдығыңмен мақұлдай бер. Simon Willison агентпен жұмыстағы басты анти-үлгі деп осы ереженің бір деңгей үлкен түрін атайды: өзің қарап шықпаған кодпен ешқашан pull request ашпа (анти-үлгілер).

   Күтілетін нәтиже: алдымен PLAN.md, сосын index.html жазылады, ал қалтада басқа ештеңе жоқ.

7. Өзің іске қосып көр

   Claude-ты жаппа, жұмыс істей берсін. Сол қалтада екінші терминал аш.

   bashКөшіру

   npx -y serve

   Ол http://localhost:3000 сияқты жергілікті мекенжай шығарады. Портты өз экраныңнан оқы — терминал қай есікті ашқанын әрдайым өзі айтады. Мекенжайды ашып, бетті бұзып көруге тырыс, мына ретпен: орын бронда (есептегіш азаяды, аты жоғарыда шығады), бетті қайта жүкте (аты орнында тұр), бос форманы жібер (үнсіздік емес, көрінетін хабар шығады), KK / EN түймесін бас (көрініп тұрған әр жазба өзгереді).

   Интернет жоқ па, әлде npx қатып қалды ма? index.html файлын файлдар менеджерінен тікелей аш — бүгінге жарайды, бірақ http:// арқылы ашуды әдетке айналдыр, себебі бет ноутбугіңнен шыққаннан кейін дәл солай жұмыс істейді.

8. Жұмыс істемейтін бір нәрсені тауып, оны дәл айт

   Ондай нәрсе әрқашан табылады. Ешқашан «бұзылып қалды» деп жазба. Белгісін, орнын және не болса бітті саналатынын жаз.

   ❯Түзету промптыClaude Code · manual approve modeКөшіру

   Қате: [не көріп тұрсың]. Күтілетіні: [не болуға тиіс].
   Қай жерде: index.html, [күдіктенген функция немесе блок].
   Оны жұмыс істейтін ең шағын өзгеріспен түзет те, браузерде тексеретін
   нақты қадамдарды айт. Басқа ештеңеге тиіспе.

   Күтілетін нәтиже: шағын diff және тексеру қадамдарының тізімі. Егер ол файлдың жартысын қайта жаза бастаса, Esc пернесін бас — ол тоқтайды, бұған дейінгі жұмысы сақталады — сосын сұрағыңды тарылтып, қайта сұра.

9. Тым ұнатып кетпей тұрып, commit жаса

   Бос жолдың басына ! таңбасын тер — shell режимі қосылады, сонда нәтиже Claude көретін әңгіменің ішіне түседі.

   Claude Code · shell modeКөшіру

   ! git status

   ❯Commit промптыClaude Code · manual approve modeКөшіру

   Осы қалтадағының бәрін commit жаса. type(scope): summary түрінде, бұл бет не
   істейтінін айтатын бір сипаттама хабар жаз.
   Сосын маған git log --oneline және git status нәтижесін көрсет.

   Күтілетін нәтиже: бір commit, бір жол, шамамен feat(signup): event landing page with seat counter сияқты, әрі таза git status. Anthropic-тің harness туралы зерттеуі мұны ашық жазады: әр ілгерілеу бөлігінен кейін сипаттама хабармен commit жаса — сонда кейінгі сеанс, немесе ертеңгі өзің, жұмыс істеген күйге қайта орала алады (ұзақ жұмыс істейтін агенттерге арналған harness).

Бұл іс бұзылатын төрт жағдай және әрқайсысының шешімі

• Зерттеуі бітпейді. Шеңбері белгіленбеген зерттеу жүздеген файлды оқып, контекст терезесін толтырып тастайды — құжаттамадағы аты «infinite exploration». Оны нақты аталған файлдармен шектеп қой немесе субагентке тапсыр.
• Бір нәрсені екі рет түзеттің. Тоқта: контекстің енді негізінен сәтсіз әрекеттерден тұр. /clear пәрменін орында да, бірінші промптты жақсырақ жаз (үздік тәжірибелер).
• «Бітті» дейді, бірақ бітпеген. Құжаттама мұны trust-then-verify алшақтығы деп атайды. Мәлімдеме емес, дәлел сұра: қандай пәрмен орындағанын және қандай нәтиже алғанын көрсетсін.
• Ол үнсіз алдап отыр. Kent Beck атаған белгілер: бір шеңберде айналады, ешкім сұрамаған мүмкіндіктер қосады немесе жасыл нәтиже алу үшін тестерді өшіріп, жойып жібереді (augmented coding).

Соңғы он минутты қайтарғың келе ме? Бос енгізу өрісінде Esc Esc басу кері қайтару мәзірін ашады: кодты, әңгімені немесе екеуін де қалпына келтіресің. Bash пәрмені істеген нәрсені ол кері қайтармайды. Ол үшін commit бар.

ТереңірекЖоспарды мүлде жасамауға болатын кездер

Жоспарлау режимі тегін емес — зерттеу де, жоспардың өзі де контексті жұмсайды. Құжаттамадағы ереже: шығатын өзгерісті бір сөйлеммен айтып бере алсаң, жоспарды аттап өтіп, бірден сұра. Қате терілген әріп, бір журнал жолы, атын өзгерту. Жоспарлау тәсіл әлі белгісіз болғанда, өзгеріс бірнеше файлды қамтығанда немесе код саған таныс болмағанда пайда береді (үздік тәжірибелер).

ТереңірекЖоспарлау режимін жоба үшін әдепкі ету

Әрқашан алдымен жоспар керек repo үшін оның .claude/settings.json файлына {"permissions": {"defaultMode": "plan"}} жазып қой; сонда ондағы әр сеанс жоспарлау режимінен басталады, ал Shift+Tab бұрынғысынша ештеңені мақұлдамай-ақ одан шығарады (рұқсат режимдері).

Жылдам тексеру

Жоспарыңда алты қадам бар. 4-қадамда былай жазылған: «Брондау формасын жасап, оның жұмыс істейтініне көз жеткіз». Мұның шын мәніндегі кемшілігі неде?

AЕшқандай кемшілігі жоқ — жоспар қадамы дәл солай жазылуға тиісBОл тым ұзын; жоспар қадамы бір ғана етістіктен тұруға тиісCОнда сен орындай алатын тексеріс аталмаған, сондықтан «жұмыс істейді» дегеннің мағынасын агент өзі шешедіDҚай framework қолдану керегі көрсетілмеген

Терминалды жаппай тұрып0/7 дайын

• ✓Claude қалтаға тиер алдында git init орындалды
• ✓Тапсырманы айтпай тұрып, күй жолағында plan mode on деп тұрды
• ✓Жоспарды кемінде бір рет кері қайтардым немесе неге оның қажеті болмағанын айта аламын
• ✓Мақұлдар алдында Ctrl+G арқылы жоспарға өз жолымды қостым
• ✓Барлығына көз жүгіртудің орнына бір diff-ті басынан аяғына дейін оқыдым
• ✓Бетті браузерде ашып, форманы бұзып көруге тырыстым
• ✓git log --oneline бір айдан кейін де түсінетін хабары бар commit-ті көрсетеді