shadcn/improve: қымбат модель жоспар жазады, арзан модель орындайды

Осы аптадағы GitHub трендтерінің бірі — shadcn/improve, MIT лицензиясымен шыққан агенттік дағды. Авторы — shadcn, қазіргі React жобаларының жартысында тұрған UI-компоненттерді жасаған адам. 13 қарашада репозиторийде шамамен 11,6 мың жұлдыз бар; жоба 2026 жылдың маусымында ашылған, соңғы коммиті қыркүйекте жасалған.

Репозиторийдің сипаттамасы қысқа әрі нақты:

«Use your most capable model to audit your codebase and write plans for cheaper models to execute».

Яғни: интеллект қор жинайтын жерге қымбат модельді қою — кодты түсіну, нені істеу керектігін шешу, техникалық тапсырма жазу. Ал орындауды арзан модельдерге беру.

сіз          →  /improve                    (қымбат модель, кеңес береді)
plans/       →  001-fix-n-plus-one.md       (өз-өзіне жеткілікті ТТ)
басқа агент  →  іске асырады, тексереді     (арзан модель, орындайды)

Басты ой: өнім — код емес, жоспар. Дағды өзі ешнәрсені іске асырмайды.

Қалай жұмыс істейді

README-де ашық сипатталған бес қадамды процесс.

Recon. Дағды репозиторийдің картасын жасайды: стек, конвенциялар, дәл build/test/lint командалары. Кейін олар әр жоспардағы тексеру қақпаларына айналады. Жобада ADR, PRD, CONTEXT.md, DESIGN.md немесе PRODUCT.md болса, дағды оларды оқиды — бұрын қабылданған шешімдер жаңа «табылған мәселе» болып қайта шықпауы үшін.

Audit. Параллель субагенттер тоғыз санатты қамтиды: дұрыстық, қауіпсіздік, өнімділік, тест қамтуы, техникалық қарыз, тәуелділіктер мен миграциялар, DX, құжаттама және даму бағыты. Әр табылған мәселеде file:line, әсері, еңбек сыйымдылығы және сенімділік көрсетіледі. Даму бағыты туралы ұсыныстар репозиторийдің өзінен дәлел келтіруі керек — README бұны «generic idea-slop жоқ» деп атайды.

Vet. Субагенттер артық хабарлауға бейім, сондықтан кеңес беретін модель әр келтірілген жерді өзі қайта оқып шығады — тізімді көрсетуден бұрын. Жалған дабылдар алынып тасталады, қате сілтемелер түзетіледі, қабылданбағандары жазылады — келесі жүгірісте қайта шықпауы үшін.

Prioritize. Табылғандар «рычаг» бойынша реттеледі: әсерді еңбек сыйымдылығына бөліп, сенімділікпен өлшеу. Қайсысы жоспарға айналатынын өзіңіз таңдайсыз.

Plan. Әр таңдалған мәселе үшін plans/ қалтасына бөлек markdown файл, қоса индекс: басымдық реті және тәуелділік графы.

Жоспарлар неге орындалады

Бұл — README-нің ең практикалық бөлігі. Жоспар ең әлсіз ықтимал орындаушыға арналып жазылады: кеңес беру сессиясын көрмеген, әлдеқайда шағын болуы мүмкін модельге. Оны үш қасиет қамтамасыз етеді:

• Өз-өзіне жеткіліктілік. Нақты жолдар, ағымдағы код үзінділері, үлгі файлымен берілген конвенциялар, тексерілген командалар.
• Тексеру қақпалары. Әр қадам командамен және күтілетін шығыспен аяқталады — дайындық критерийі машинамен тексеріледі.
• Қатаң шекаралар. Айқын «аяқтан тыс» тізімдері және STOP шарттары: нақты жағдай жоспарға сәйкес келмесе, шағын модель өз бетімен импровизацияламайды.

Сонымен қатар әр жоспар қай git-коммитке қарсы жазылғанын белгілейді — орындаушы алдымен кодтың жылжып кетпегенін тексереді.

Командалар

/improve                        толық аудит → басымдық → жоспарлар
/improve quick                  арзан жүріс: ыстық нүктелер мен топ табылғандар
/improve deep                   мұқият: әр пакет, әр санат
/improve security               бағытталған аудит (perf, tests, bugs те бар)
/improve branch                 тек ағымдағы тармақ өзгерткенін тексеру
/improve next                   даму бағыты бойынша ұсыныстар
/improve plan <сипаттама>       аудитсіз: бір тапсырманың ТТ-сы
/improve review-plan <файл>     бар жоспарды сынау және нақтылау
/improve execute <жоспар>       арзан орындаушыны іске қосу + жұмысын тексеру
/improve reconcile              бэклогты жаңарту: тексеру, бұғаттан шығару, есептен шығару
/improve ... --issues           жоспарларды GitHub issue ретінде жариялау

execute бөлек атап өтуге тұрарлық: арзан субагентті оқшауланған git worktree-де іске қосады, жоспарды береді, содан кейін нәтижені тимлид сияқты тексереді — әр дайындық критерийін қайта іске қосады, скоуптың сақталуын тексереді, diff-ті мақсатпен салыстырады. Қорытынды: approve (біріктіру бәрібір өз қолыңызда), қайта өңдеуге жіберу (ең көбі екі айналым) немесе бұғаттап, жоспарды нақтылау.

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

Практикадағы пайдасы

«Қымбат модель ойлайды, арзан модель істейді» деген ой — агенттік әзірлеудегі еңбек бөлінісі. Арзан модельмен тәжірибелердің көбі сәтсіз болады, өйткені тапсырма дұрыс қойылмаған. Мұнда сапа ТТ-дан келеді: егер жоспар өз-өзіне жеткілікті әрі тексерілетін болса, орындаушыға үлкен контекст те, қымбат модель де қажет емес — нақты нұсқаулық керек.

Екінші әсер: аудит бір реттік іс болудан қалады. Табылғандар мен бас тартулар жазылады, reconcile кейін оларға қайта оралады: не орындалды, не жылжыды, не бұғаттан шықты. Техникалық қарыз бэклогы біреудің жадында емес, репозиторийде тұрады.

Біздің стекке қалай сыйысуы мүмкін

Ашық айтайық: бұл жобаны біз өндіріске енгізген жоқпыз. Төмендегінің бәрі README мен репозиторийге сүйенген талдау, өз тәжірибемізден алынған есеп емес.

Сайт пен CRM әзірлеуі. Біздің стек — фронтта Astro мен Next.js, бэкендте Python мен PHP. Өзгерістер алдында /improve branch қисынды: «бәрін қайта жазу» емес, тек ағымдағы тармақтың өзгерісін тексеру. Қауіпсіздік үшін /improve security қалыпты ревьюға қосымша, ал тәуелділік сканерінің орнын баспайды.

Контент зауыты. Сол қағида кодтан тыс жерде де жұмыс істейді: мықты модель мақалаға немесе конвейер өзгерісіне егжей-тегжейлі ТТ жазады, күнделікті орындау арзан агенттерге кетеді. «Тексерілетін қақпалары бар өз-өзіне жеткілікті жоспар» деген талап тапсырманы қоюды да тәртіпке салады.

Мониторинг. Мұнда шатаспау керек: improve кодқа қарайды, сервер конфигурациясына емес. Оның security санаты nginx, PHP, ядро мен тәуелділіктердегі CVE-лерді бақылауды алмастырмайды — бұл екі бөлек контур, екеуі де керек.

Орнату алдында ескеретін жайттар: Agent Skills форматын қолдайтын агент керек (npx skills add shadcn/improve); жоба жас, соңғы белсенділігі 2026 жылдың қыркүйегінде, сондықтан мінез-құлқы өзгеруі мүмкін; ең бастысы — бұл әзірлеу құралы, бизнес-аудит емес. Ол N+1 сұраныс пен қайталанған конфигурация қайда екенін айтады — сату моделін өзгерту керек пе, жоқ па, оны айтпайды.

Репозиторий: github.com/shadcn/improve

📞 +7 (906) 311-77-69 · ✉ hello@automata.sale · 💬 Telegram: @automatasale · 🌐 automata.sale

ИП Урядов Евгений Евгеньевич · ИНН 645112058391 · ОГРНИП 312645301900058 Ресей, Беларусь және Қазақстан бойынша жұмыс істейміз