Чаму агентам кадавання накшталт Claude Code патрэбны ўзровень кіравання, а не лепшыя промпты

Болей шчырокія запіты дапамагают атрымліваць лепшыя адказы. Яны зменшаюць непрацэспактнасці, чысткія інструкцыі і задаюць чыткі направленні для адной сесіі, і на час здаецца, што гэта павышае ўсю методыку вашай працы з ШЫ. Гэта адчуванне знікае, калі агенты становяцца частынай ўседзённай працы. Вы перэстаеце прасіць аб аднам пераканаючым адказе на адзін аіслараваны запіт. Вы спакульватэце, што агент знае праект, паважае вялікія вялікія рашэнні, выбірае правільную процедуру, дзеяе ў межах сваіх прав, выкарыстоўвае належныя інструменты і залічае доказы, якія можна пераканацца.

Запіт формуе абмянку, якая відбываецца пры вас. Ён не можа кераваць усім, што абходзіць гэтую абмянку.

Codex і Claude Code ужэ маюць багато корыстных элементаў. Што не хватая, так гэта цэлыснае, перэноснае сістэма, якая вяршыць, якія правілы павінны дзейсніцца, які кантэкст мае значэнне, што можа рабіць агент для кодавання, як распрацоўваюцься задачы і шта лягае ў основу доказаў. Каму-небудзь трэба стварыць такы шар навакола сэрвіса для выканання. Адна з назв такога шара — ядро: шар керавання, які належыць вам і які перадае задачы ад намераў чалавека аж да доказаў. У яго няма внутрашняго модэлю і ён сам па сабе нічога не выкананае.

Конкрэтна, такое ядро можа пачаць сваю дзеяльнасць як сукупнасць перэносных, структураваных файлаў у фармаце Markdown: правілы, протаколы, індэксы, прыйнятыя рашэнні, стан праекта і правілы пра збераганне дакументацыі. Калі паперовыя інструкцыі недастатковы, прыгоднае вжыцце навыкаў, скрыптав, спрытных спосабаў і додатковых элементаў для заполнення прыгождын.

Кантэкст быў толькі сімптамам

Першая помітная проблема — губітця кантэксту. Новая сесія частаў не мае жадных ведамаў пра архітэктуру, няякшыя змяны чыстаў прычыны выканання задання, таму прайшлія перагляды стаюць неабходнымі, прычым як толькі можна будзе продаваць корыстную работу. Такая паўтарэння спалюе час, рэсурсы чыстаў тэрпенне.

Большы кантэкст дапамагае, але не рашаў глыбокія проблемы. Агент усё рав можа следаваць неправым процедурам, дзеяць з большымі правамі, чым яму дазволена, включаць нерэлевантны матэрыял чыстаў анунцаваць успех без падтрымкі.

Явным рашэннем ўсё гэта ўскладніць яе ў AGENTS.md, CLAUDE.md або іншым падобным файле-засновцы. Гэта разумна, але недастаткова. Гэтыя файлы дасканаль павышаюць якасць адчынення праекту, але сподзівацца, што яны будуць кераваць усім працэсам, — гэта памылка. Засновны файл можа прызначыць стабільныя правіла і паказаць надзеяныя джэрэлы. Але ён сам по сабе не можа падтрымваць актуальны стан праекту, выбіраць правы кантэкст для кожнага заведамства, вяршыць, што можа робіць агент, або пераканацца ў рэзультатах.

Ёсць адна галоўная прымета: перш чым прыступіць да выканання, трэба чытка адзначыць, што значыць „завершанне“, а потым на канцы вымагаць доказы.

Усуненне парадокса ніколі не было главной мэтой. Штучны інтэлект перайшаў з рэдкіх эксперыментаў у ўседзённую неабходнасць, і цікавым пытаннем было, сколькі значэння можа даць асяроддзе, створаная з звычайным адказом на патрэбы дызайну програмнага забезпечэння. Штучны інтэлект прыйшоў праз калькі вароў адразу — у рэдагувальніках, у Xcode і VS Code, а таксама ў агентах уродзе Codex і Claude Code. Кожны з іх спрыяў лёгкаму вызыву спроможнага модэлю, але лёгкі доступ нічым не дапамагаў у арганізацыі таго, што відбывалася пад час такога вызыву.

У хорашы дзень агент можа пераглядзець код, паспяшыць невядомую платформу, запропанаваць архітэктуру або дапамогчы запусціць новую функцыю, і гэта можа дастаць вражэнне саавтарства з іншым распрацоўшчыкам. Чым больш вы на гэта рэгулюецеся, тым больш значэнне набіраюць супакоўныя пытанні. Калі два джэрэлы не пагадваюцца, калі ж выграе адно? Калькі правілы прыменяюцца да гэтага заведамства? Чы мае агент прымець рашэнне, чы толькі даваць рэкамендацыі? Якшто ён кажа, што работа завершана, што вы маеце спакоўвацца пабачыць?

Кантэкст адпавядае на першую частку гэтага пытання, адколі ён дае агенту рэлевантныя знанні. Рэшта стосуецца таго, як гэтыя знанні вікорыстоўваюцца. «Управлінне» — гэта прыдатны тэрмін для всіяго комплексу: практычны звязак между намерам, надзеянымі знаннямі, правіламі, аўтарытэтам, выкананнем і доказам. Ён застаецца практычным, калі наследныя часткі рабочага працэсу ўсталяваныя настаткі ўсталяваныя, каб іх можна было пераглядзець, выправляць і перызнаць.

Для інжынера, якому пасабліва разрабатка сістэм, у якіх ўсе элементы эфектыўна взаімаюцца, імпровізаванне у працэсе працы з агентамі здаецца марнатратным. Гэта стае там, што трэба спраектаваць, а не серыёю чатоў, якія трэба стагнараваць. Ёжы добра выконваць гэта значыць давга студзіраваць свае сабеўпакоранні: што вы пераканаліся перш чым прыступіць да праекту, якія шаблоны вы вжываеце знову, калі сповольняецеся і якія перакананні насправды паводзяцца тым, што работа завершана. Мета — ператворыць гэтыя неявныя сабеўпакоранні на прыемы, якія можа следаваць агент і якія можа пераглядаць чалавек.

Што можа і чаго не можа зробіць bootstrap

Разрабоўцу, які прыўязваецца да вялікага праекту, патрэбны не толькі талант. Ям трэба выучыцца, як організаваны код, якія рашэнні вжываюцца, што змянілася нешта няўзабаве і дзе знаходзяцца межы. Без гэтага нават выдаюшчыся спецыяліст пасвяціць дні на паўторную адкрыццю срэдавішча.

Сесіі агента таксама страждаюць ад ускладненай формы таго ж проблемы. Вы адгукледзіце архітэктуру, цілі, ныяню стан і абмежэнні, агент выканае хорашую працу, а ў наступной сесіі патрэбна большая частка гэтай інфармаціі, каб яе зноў стварыць.

Размешчэнне гэтага матэрыялу ў файле AGENTS.md або CLAUDE.md робіць працэс адпрацоўкі значна танней. Слова «bootstrap» пазначае межу і не ўжо ўзнэмаркаўка: хорашы документ паказвае мінімальныі контракт на адработку і адказвае, дзе знаходзяцца надзеяныя даны. Документы Codex выкарыстоўваюць файлы AGENTS.md, якіх аб’ём залічваецца, а Claude Code пропануея короткія інструкцыі да праектаў, пры чым процедуры, якія рэдка патрабуюцца, выдэляюцца як навыкі. Гэта все практыкуецца ў дакументах прадавцоў: у прадаванні Claude Code па канцэпцыі памяці і ў гідзе Codex AGENTS.md. Навык паказвае процедуру, якая можа быць выканана знову і знову, таму яна можа выкорыстоўватыцца ў розных праектах, а хукі могу прымусіць певную дзеянню ў кожны раз. Тым не менш, яшчое якое-небудзь засоба павінен вырашыць, калі кожны механізм прымае дзеянне і як пераканацца ў рэзультатах яго работы.

Проблемы пачынаюцца тады, калі аднаго файлу чакаюць, што ён будзе ўсім працоўным прасторам. Ён не можа застацца маленькім і водночас мець у сабе кожнае архітэктурнае рашэнне, чырговы план, паказнікі з працы, протаколы і дэталі завад. А якбы вікно з кантэкстам магло прыjęць усё, то заполненне яго ў кожной сесіі прынесла бы свае проблемы: важлівыя інструкцыі пачнулі бы конкуруваць з застарэлым чы або несувязаным тэкстам. Для вылечэння бага патрэбны іншыя умовы, чым для аналізу архітэктуры. Выпуск продукту адбываецца іншым спосабам, чым раннія нарада па продукту, і простая запытка не должна купіваць сабой кошты коордынаціі для большай функцыі.

Таму bootstrap павінен запропанаваць шлях у сістэму, а не прабаваць стаць самай сістэмай.

З bootstrap да карты

У гэтым дыяграме бутстрап зберагае невялікі кантракт аператырання, а пасля паказывае на адзінаковыя істочнікі, калі яны становяцца значнымі. Прынятыя рашэнні застаюцца ў праекце. Пратаколы опісваюць паўтараючыяся відэры працы, навыкі маюць процедуры, якія можна выконваць паўтараючы, скорыя способы скартаваюць частыя запіты, а чыргавыя планы зберагаюць інфармацыю, якая можа знадобіцца ў наступнай сесіі.

У ядрэ няма нічога «розумнага». Яго цэннасьць вырабляецца за счыткам таго, як файлы аддзеляюцца, выкананыя з’яўляюцца ў зв’язку, выбіраюцца і падтрымваюцца ў разныя сесіі і працэсы.

Аддзеленне таксама заходзіць значэнне. Прынятыя рашэнні керуюць развіццем праекта, апошнія адчыткі опісваюць певны момент, а рэзультаты тэстаў фіксуюць доказы. Калі аб’еднаны ў адну неразмежаваную памяць, старая адзінаковасць пачынае выглядаць як чыргавая інструкцыя.

Калі структура развіваецца, яна пачынае абарачваць політыку памяці, складнасць заданняў, колькасць зусібоў для размышлення і які мадэль належыць выбраць, шорткаты, прымыканне межы сесіямі, параболенне і коордынацыю межа кількомі агентамі. Полны пераказ усіх элементаў мог бы сховаць сутнасць архітэктуры. Галоўнае — калі працавае, агент можа поступова адкрываць іх. За гэтым „картам“ стояць чатыры абавясці, якія не опісваюць кожны механізм, але пояснююць, чаму яны належаць разам.

Дзеяныя веды павінны застацца пасля заканчэння чату

Чат працюе падчас выканання задання, але ён не павінен быць офіцыяльным архівам рашэнняў праекта. Прыйнятая архітэктура, абмежэнні і выборы способу кодавання павінны знаходзіцца ў кераваных істочніках, якія можа прачытаць будзь-якая пазнейшая сесія, а актуальныя планы патрабуюць свайго стану, які можна будзе пракраты. Зберагчыць надзеяныя даны — гэта не тое ж сама, што архіваваць кожную розмову, адколькі большая часць з іх ёсць тымчасовымі елементамі. У замяну запытайцеся, што ўсё ж такі павінна заліцца автантычным пасля завершэння сесіі.

Завантажыце тое, што патрэбна заданню

Агенту патрэбна столькі меркаваінасць, каб ён могаў разумець сваю задачу, а не весь матэрыял, які калі-небудзь быў схованы ў сістэме. Для невялікіх змян у кодзе можа знадобіцца толькі правіла праекту і калькі файлаў. Для складных функцыяй можа знадобіцца таксама інтэнцыя продукту, архітэктурныя рашэнні, дапамога спецялістаў і план пераканання. Мета — мінімальна неабходная меркаваінасць, а не максымальная доступная. Кантынуітэт значыць можлівасць знайсці правы матэрыял у правы момант, а не пераноскаўці всей історыі ў кожную задачу.

Пошук чаго-небудзь — гэта не разрэшэнне

Адказаванне пра файл, паведамленне чырага рэкамендацыю не дае права дзеяць на ўснове іх. Сістэма павінна аддзеляць інфармацыю ад праваў, бальш за ўсё для разрушных дзеянняў, заканчычнай атрыбутацыі, публікацыі і усяго, што стосуецца света за межамі рабочай зоны. Шырыню гэтага слоя можна спазіраць менш чытка, чым інтэлект модэлі, пры тым яна мае важнае значэнне кожны раз, калі абмовленыя памылкі коштаюць больш, чым пауза для прыняцця рашэння.

Дабы завершыць, патрэбны доказы

Бліскучая влада мовай не значыць правільна, а правдападобна версія не значыць завершаная. Таму ядро запытаеся, што трэба параболіць, якія доказы трэба захаваць і дзе запісваецца падтверджаны стан. Калі агент вырэджвае код і паведамляе "завершана", вы толькі атрымалі заяву, і больш нічога. Параболка можа значыць паспэльныя тэсты, успешную кампіляцыю, прыемнае паведамленне ў працюючым прыкладніку і запісаны стан. Для іншых полей патрэбны іншыя доказы, але правілле адно: заканчэнне размовы не значыць, што праца завершана.

Арганізацыя як аналагія

Уявіце сабе компанію з будынкам, камп’ютарамі і высокакалітэтным обяжынкам, але без спільнага спосабу работы. У яе ёсць можлівасці, але ёй не хвацкае цялесообразнасць. Людзям як і раней патрэбны спільныя знанні, процедуры, права на прыняцце рашэнняў, чыстая структура обавязакоў і контроль якасці. Гэта паўпораўненне ёсць нечыткым, таму што агент — гэта не працавальнік, а асяроддзе выканання выполняе больш, чым проста размешчае людзей за столамі. Аднак гэта паказвае, як вузлі адносяцца адзін да другога: агенты выпалняюць апраначаныя ролі, інструменты — гэта обяжынкі, а асяроддзе выканання — гэта месца, дзе все выкананае. Ядро — гэта спільны слой правіл, знанняў, методаў і контроў, які дазволяе ўсім ім саавершаць работу. Лепшыя мадэлі не прымусова ствараюць крашчую сістэму.

Дзе знаходзіцца гэты слой

Ядро не конкуруець з Codex, Claude Code, Gemini чым бы то ня было іншым срэдавам выканання, якія з’явяцца пазней. Ці срэдавы забезпечваюць робочае сераўыс: мадэлі, інструменты, сесіі, настройкі аналізу, а таксама все большы ўзбор сваіх сабеагентаў, хуків і навыкаў. Слой керавання працюе ў рамках гэтага сераўысу і вірашае тры пытанні: што павінна застацца, што агент можа робіць, і якія доказы лягаюць у вазу як завершана праца.

Гэтая схема становіцца ўсё цянючай з кожным разам, калі новая версія рантайму додае функцыю, якая падобная да той, што ужо створаны ручная працай. Перзначэнне кожнай можлівасці рантайму займала бы час, які можна было бы выкорыстаць для праектаў, якія обслужваюць агенты. Болей стойкім падходам ёсць дазволіць рантаймам кераваць выконаннем, тады калі слой керавання застаецца перэносным. Прадаўцы разлічаюцца за мадэлямі, інструментамі, інтэрфейсамі і стылем выходных дадзеных, а перэноснасць дапамагае захаваць вашыя правілы незалежнымі ад кожнага з іх, не выдаваючы ся, што гэтыя разлікі зніклі.

Кераванне не гарантуе пэўнасці

Запіс правіла не гарантуе, што агент яго прачытае, зрозумее чы ўжыць яго у правы час. Бустап можа паказаць правы протакол, але яго можна ўсё раве ігнораваць. Канонічнае рашэнне можа застацца ідэальна захаваным, тады калі яго змест спакойна стане застарэлым. Хук можа верна адмаўляць правіло ўжо давно пасля таго, як гэта правіло перэстало быць корыстным.

Практыка паказвае, што такі сістэмы працуюць быстра. Правілы, дадзеныя для робочых дрэваў і хуків, пачынаюць перакрывацца, ствараць суперсечанні і блакаваць задачы, якія яны мялі захішчаць, таму іх неабходна спроставаць і выправіць. Управлінне трэба падтрымваць, а расходы не заканчываюцца тут: інтэрфейсы і індэксы спрацоўваюць за рахунак часу і токенав, і ўсё ж можа не паказваць найновейшы стан; агенты ігнаруе ўказванні па меры зростання сістэмы, а доверлівасць важка восстанавіць пасля таго, як рабочы працэс заявляе пра успех без апэксыўных доказаў.

Такая сістэма ніколі не ўвесь час працюе ідзеальна і не ёсць універсальной. Гэта персональная настройка, якая працуе пад тэстамі, падвергаецца бягам і выправляецца працой месяцамі. Яна павышае вашу здатнасць сочыць за паведаннем агентаў і ўсунуць адхыленні, пры тым жаданага правіла, пратакола, спрытку чы механізма памяці ніколі не дотрымвана ідэальна. Управлінне можа спрыяць лёгшаму адзіроўванню і выправленню паведання, але не можа ператворыць верагатывістскага агента на дэтэрміністскі.

Тры пытанні, якія трэба запытаць перш

Утрата кантэксту — гэта тое, што прыводзіць людзей на гэты шлях. Тое, што трывае там, — гэта большая інжынерная прыблымо: як следуець спроекаваць шлях або алгорытм для функцыональнага модэлю, надаючы такі ж увагу будзь-якай іншай важлівайй архітэктурэ?

То чы можна падтвердзіць, што работа завершана? Толькі тады, калі пярэд зданнем на выконанне было з’явлена вялічына „завершэння“, а рэзультат паказвае доказы, якія пасуюць да задання. Без гэтага тое, што у вас ёсць, — гэта толькі тверджэнне, а тверджэнне — не доказ.

Вам не патрэбна такая сістэма, каб пачаць думаць такім чынам. Перш чым дадзіць ўсё новы запіт або файл, запытайцеся:

1. Каліясць джэрэла, якія могуць вялічыць, што ёсць правдой?
2. Каліясць рашэнні і дзеянні, якія патрабуюць людскага разрэшэння?
3. Каліясць доказы, якія пакажуць, што работа завершана?

Этыя запытанні ператвараюць адзінаковыя функцыі ШЫ ў часткі надзеянага рабочага працэсу, а не проста ў можлівасці, якія існуюць парадульна. Не кожны маленькі запіт павінен трымаць усю сістэму ў руху. Кантрольны меры должны зменяцца ў залежнасці ад наследкав: лёгкія, калі рызык нізкі, і строгіяя, калі памылка можа прынесці вялікія збыткі. Мадэлі з’являюць можлівасці, а шлях, які керуецца намерамі і прыводзіць да рэзультата, — гэта тое, што вы будуеце ствараць навакола іх.