Когда это нужноWhen to reach for itКоли це потрібно
Вы собираетесь запустить сразу нескольких агентов или начать долгий прогон по многим тикетам, и агенты у вас под рукой одним вызовом.You are about to spawn several agents at once, or to start a long run over many tickets, and the agents are one call away.Ви збираєтеся запустити одразу кількох агентів або почати довгий прогін по багатьох тікетах, і агенти у вас під рукою одним викликом.
ТребованияRequirementsВимоги
- Где доступноAvailable inДе доступно
- Каждая загрузка kitEvery download of the kitКожне завантаження kit
- К чему обращаетсяWhat it touchesДо чого звертається
- Ничего, кроме чатаNothing beyond the chatНічого, окрім чату
- Работает сWorks withПрацює з
- Любой агент, который читает и пишет ваши файлыAny agent that reads and writes your filesБудь-який агент, що читає й пише ваші файли
- Где выполняются шагиWhere the steps happenДе виконуються кроки
- Чат вашего агента и ваши собственные файлы. Ни то ни другое не интерфейс этого сайта, поэтому шаги описаны текстом, а не скриншотами.Your agent's chat and your own files. Neither is an interface of this site, so the steps are text and not screenshots.Чат вашого агента і ваші власні файли. Ні те, ні інше не є інтерфейсом цього сайту, тому кроки описано текстом, а не скриншотами.
- Где это лежит в kitWhere it lives in the kitДе це лежить у kit
docs/COST.md
Прежде чем начатьBefore you startПерш ніж почати
Никогда не возобновляйте молча прогон, убитый лимитом. Параллельный запуск, оборванный лимитом, оставляет частичные непроверенные результаты: сообщите, что завершилось, а что нет, и потом решайте. Не замазывайте пробел и не объявляйте работу готовой.Never silently resume a run that a limit killed. A limit-killed fan-out leaves partial, unverified results: report what completed and what did not, then decide. Do not paper over the gap and call it done.Ніколи не поновлюйте мовчки прогін, убитий лімітом. Паралельний запуск, обірваний лімітом, лишає часткові неперевірені результати: повідомте, що завершилося, а що ні, і тоді вирішуйте. Не замазуйте прогалину й не оголошуйте роботу готовою.
ШагиStepsКроки
- По умолчанию выполняйте работу в основной сессии. Субагент стоит полного запуска контекста плюс его собственные токены, а его отчёт - утверждение, которое придётся перепроверять. Запускайте его только ради параллелизма по независимым вопросам, изоляции громоздких свидетельств или свежего контекста, который не стоит тащить основному потоку. Для быстрого поиска grep на месте лучше запущенного читателя.Work inline by default. A subagent costs a full context spin-up plus its own tokens, and its report is a claim you must re-validate. Spawn one only for parallelism over independent questions, isolation of bulky evidence, or a fresh context the main thread should not carry. For a quick lookup, an inline grep beats a spawned reader.За замовчуванням виконуйте роботу в основній сесії. Субагент коштує повного запуску контексту плюс його власні токени, а його звіт - твердження, яке доведеться перевіряти. Запускайте його лише заради паралелізму за незалежними питаннями, ізоляції громіздких свідчень чи свіжого контексту, який не варто тягти основному потоку. Для швидкого пошуку grep на місці кращий за запущеного читача.
- Оцените число агентов и примерную стоимость в токенах. Несколько читателей обходятся дёшево, а дюжина пишущих агентов, каждый из которых тащит громоздкие свидетельства, - нет.Estimate the agent count and the rough token cost. A handful of readers is cheap; a dozen writers each dragging bulky evidence is not.Оцініть кількість агентів і приблизну вартість у токенах. Кілька читачів обходяться дешево, а десяток пишучих агентів, кожен з яких тягне громіздкі свідчення, - ні.
- Держите небольшой потолок по умолчанию, около 6-8 агентов на прогон. Выше него берите явное GO: назовите число, стоимость и причину, по которой меньшим числом не обойтись. Привяжите потолок к реальным общим лимитам вашей среды - лимитам частоты, бюджетам токенов, потолкам одновременных агентов - и запишите одним числом, один раз.Keep a small default ceiling, about 6-8 agents per run. Above it, get an explicit GO: state the count, the cost, and why fewer will not do. Set the ceiling to your runtime's real shared limits, such as rate limits, token budgets and concurrent-agent caps, as one number stated once.Тримайте невелику стелю за замовчуванням, близько 6-8 агентів на прогін. Вище неї беріть явне GO: назвіть кількість, вартість і причину, чому меншою кількістю не обійтися. Прив'яжіть стелю до реальних спільних лімітів вашого середовища - лімітів частоти, бюджетів токенів, стель одночасних агентів - і запишіть одним числом, один раз.
- Разделите работу на стадии: сначала найти, потом проверить. Не запускайте веер проверок по находкам, которые вы не дедуплицировали, иначе заплатите за проверку одного и того же трижды.Stage the work: find first, then verify. Do not fan out verification over findings you have not deduplicated, or you pay to check the same thing three times.Розділіть роботу на стадії: спершу знайти, потім перевірити. Не запускайте віяло перевірок за знахідками, які ви не дедуплікували, інакше заплатите за перевірку одного й того самого тричі.
- Давайте каждому субагенту только те инструменты, что нужны его работе. Исследователю, который только читает, - чтение и поиск, но не правку; исполнителю - редактор, но не ключи развёртывания. Объявляйте список во frontmatter роли, как это делает
solution-researcherв kit: в Claude Code описание роли без списка наследует все инструменты сессии, а подключённый сервер инструментов может поднимать собственный процесс и контекст для каждого агента, который его несёт.Give each subagent only the tools its job needs. A read-only investigator gets read and search, never edit; an implementer gets the editor, not the deploy keys. Declare the list in the role's frontmatter, as the kit'ssolution-researcherdoes: in Claude Code a role brief with no list inherits every tool the session has, and an attached tool server can spin up its own process and context for each agent that carries it.Давайте кожному субагенту лише ті інструменти, що потрібні його роботі. Дослідникові, який тільки читає, - читання й пошук, але не правку; виконавцеві - редактор, але не ключі розгортання. Оголошуйте список у frontmatter ролі, як це робитьsolution-researcherу kit: у Claude Code опис ролі без списку успадковує всі інструменти сесії, а підключений сервер інструментів може піднімати власний процес і контекст для кожного агента, який його несе. - Маршрутизируйте по уровню. Простые механические навыки вроде
/quickи/caveman-commitидут на небольшой дешёвой модели;/spec,/spec-check,/critiqueи оркестратор rd-lead остаются на сильной. Называйте уровень в месте вызова: запуск без закреплённого уровня берёт значение сессии по умолчанию, самое дорогое, и каждому агенту, которого вы определяете, задавайте явный уровень. Kit закрепляет уровень у четырёх своих агентов, но не у навыков.Route by tier. Mechanical leaf skills such as/quickand/caveman-commitrun on a small cheap model;/spec,/spec-check,/critiqueand the rd-lead orchestrator stay on a strong one. Name the tier at the call site, because a spawn with no pinned tier takes the session default, the most expensive one, and give every agent you define an explicit tier. The kit pins its four agents but not its skills.Маршрутизуйте за рівнем. Прості механічні навички на кшталт/quickі/caveman-commitідуть на невеликій дешевій моделі;/spec,/spec-check,/critiqueта оркестратор rd-lead лишаються на сильній. Називайте рівень у місці виклику: запуск без закріпленого рівня бере значення сесії за замовчуванням, найдорожче, і кожному агентові, якого ви визначаєте, задавайте явний рівень. Kit закріплює рівень у чотирьох своїх агентів, але не в навичок. - Держите контекст коротким. Между несвязанными задачами начинайте с чистого листа через compact или clear. Сырые артефакты вроде полных логов сборки и выгрузок grep выносите в каталог scratch и ссылайтесь на них по пути. Для пакета, который идёт без присмотра, сбросом должна служить граница процесса: драйвер вне сессии запускает каждый элемент в новом безголовом процессе.Keep the context short. Between unrelated tasks, start fresh with compact or clear. Offload raw artifacts such as full build logs and grep dumps to the scratch directory and reference them by path. For an unattended batch, make the process boundary the reset: a driver outside the session runs each item in a fresh headless process.Тримайте контекст коротким. Між непов'язаними завданнями починайте з чистого аркуша через compact або clear. Сирі артефакти на кшталт повних логів збірки та вивантажень grep виносьте в каталог scratch і посилайтеся на них за шляхом. Для пакета, що йде без нагляду, скиданням має слугувати межа процесу: драйвер поза сесією запускає кожен елемент у новому безголовому процесі.
- Не работайте по принципу «запустил и забыл» и не опрашивайте в цикле. Не сообщайте то, что вы лишь предполагаете в результате запущенной проверки. Ждите условия, о котором ваша среда умеет сигнализировать, или пусть фоновая работа пишет вердикт туда, где читатель может по нему ветвиться, и никогда в код выхода. Если опрос неизбежен, опрашивайте с той частотой, с которой дело действительно меняется, и одной строкой говорите, чего ждёте.Never fire and forget a check, and never poll for it. Do not report what you assume a launched check said. Wait on a condition your runtime can signal, or have the background work write its verdict where a reader can branch on it, never in its exit code. If you must poll, poll at the rate the thing actually changes, and say in one line what you are waiting for.Не працюйте за принципом «запустив і забув» і не опитуйте в циклі. Не повідомляйте те, що ви лише припускаєте в результаті запущеної перевірки. Чекайте на умову, про яку ваше середовище вміє сигналізувати, або нехай фонова робота пише вердикт туди, де читач може за ним розгалужуватися, і ніколи в код виходу. Якщо опитування неминуче, опитуйте з тією частотою, з якою річ справді змінюється, і одним рядком кажіть, чого чекаєте.
Что вы должны увидетьWhat you should seeЩо ви маєте побачити
Перед волной - записанная строка с числом агентов, примерной стоимостью и GO, если число выше потолка. После неё - отчёт о том, что завершилось, а что нет.Before the wave, a written line with the agent count, the rough cost, and a GO if the count is above the ceiling. After it, a report of what completed and what did not.Перед хвилею - записаний рядок із кількістю агентів, приблизною вартістю і GO, якщо кількість вища за стелю. Після неї - звіт про те, що завершилося, а що ні.
СоветыTipsПоради
- Не оптимизируйте видимую половину. В эталонном корпусе кэшированный ввод (контекст, перечитываемый на каждом ходу) составлял ~72% счёта, постоянно загружаемая преамбула ~23%, а всё, что написал агент, ~12%. Краткость - рычаг задержки, а не стоимости: проход, сокративший преамбулу свода правил на 2,5%, сдвинул счёт на 0,23%.Do not optimise the visible half. In the reference corpus, cached input (context re-read on every turn) was ~72% of the bill, the always-loaded preamble ~23%, and everything the agent wrote ~12%. Brevity is a latency lever, not a cost lever: one pass that cut the rulebook preamble by 2.5% moved the bill by 0.23%.Не оптимізуйте видиму половину. В еталонному корпусі кешований ввід (контекст, що перечитується на кожному ході) становив ~72% рахунку, завжди завантажувана преамбула ~23%, а все, що написав агент, ~12%. Стислість - важіль затримки, а не вартості: прохід, що скоротив преамбулу зводу правил на 2,5%, зрушив рахунок на 0,23%.
- Контекст проигрывается заново, а не читается один раз: каждый ход пересылает всё, что было раньше, так что длинный контекст - это подписка, оплачиваемая на каждом ходу. Обосновывайте чистый старт стоимостью, которую можно измерить, а не качеством ответов, пока вы не измерили, что качество падает с ростом контекста.Context is replayed, not read once: every turn re-sends everything before it, so a long context is a subscription paid per turn. Argue starting fresh on cost, which you can measure, not on answer quality unless you have measured quality degrading with context size.Контекст програється заново, а не читається один раз: кожен хід пересилає все, що було раніше, тож довгий контекст - це підписка, яку сплачують на кожному ході. Обґрунтовуйте чистий старт вартістю, яку можна виміряти, а не якістю відповідей, поки ви не виміряли, що якість падає зі зростанням контексту.
- В Claude Code свежий процесс безнадзорного прогона - это безголовый запуск
claude -pс неинтерактивным режимом прав, например--permission-mode dontAsk, который отклоняет всё, что потребовало бы вопроса, так что элемент не зависнет на вопросе, на который некому ответить. Куда писать вердикт фоновой проверки, сказано в лестнице проверок.In Claude Code the fresh process of an unattended run is a headlessclaude -prun with a non-interactive permission mode, for example--permission-mode dontAsk, which denies whatever would have prompted, so an item cannot hang on a question nobody is there to answer. The verdict of a backgrounded check goes where a reader can find it, per the validation ladder.У Claude Code свіжий процес безнаглядного прогону - це безголовий запускclaude -pз неінтерактивним режимом прав, наприклад--permission-mode dontAsk, який відхиляє все, що потребувало б питання, тож елемент не зависне на питанні, на яке нікому відповісти. Куди писати вердикт фонової перевірки, сказано в драбині перевірок. - Маршрутизацию по навыкам настраиваете вы, kit этого не делает. Во frontmatter навыка можно назвать модель там, где среда это учитывает (в Claude Code документировано поле
model), поэтому убедитесь по записи самой сессии, что оно сработало. Kit не заявляет экономии: разбивка по уровням - показатель вывода, а счёт часто определяет кэшированный ввод.Per-skill routing is something you configure; the kit does not do it for you. A skill's frontmatter can name a model where your runtime honours one (Claude Code documents amodelfield), so confirm from the session's own record that it took effect. The kit claims no saving: a tier split is an output figure, while cached input often dominates the bill.Маршрутизацію за навичками налаштовуєте ви, kit цього не робить. У frontmatter навички можна назвати модель там, де середовище це враховує (у Claude Code задокументовано полеmodel), тож переконайтеся за записом самої сесії, що воно спрацювало. Kit не заявляє заощадження: розбивка за рівнями - показник виводу, а рахунок часто визначає кешований ввід. - Цифры в
docs/COST.md- наблюдения на одном эталонном корпусе, машине или проекте, а не константы. Прежде чем верить собственному измерению, дедуплицируйте по идентификатору запроса, обходите вложенные сессии субагентов, определяйте жёсткий сбой инструмента по флагу ошибки среды, а не по регулярному выражению над результатом, и никогда не считайте потребление по имени инструмента.The figures indocs/COST.mdare observations from one reference corpus, machine or project, not constants. Before you trust your own measurement, deduplicate by request id, walk nested subagent sessions, classify a hard tool failure by the runtime's error flag and not by a regex over the result, and never count consumption by tool name.Цифри вdocs/COST.md- спостереження на одному еталонному корпусі, машині чи проєкті, а не константи. Перш ніж вірити власному вимірюванню, дедуплікуйте за ідентифікатором запиту, обходьте вкладені сесії субагентів, визначайте жорсткий збій інструмента за прапорцем помилки середовища, а не за регулярним виразом над результатом, і ніколи не рахуйте споживання за назвою інструмента. - Урезание процесса - не рычаг скорости. За измеренное двухнедельное окно гейты и бухгалтерия вокруг них составили 27,5% вызовов инструментов и 16,8% времени по часам, так что снятие всех гейтов даёт выигрыш около 1,2x. Оставьте гейт, который себя оправдывает, а скорость покупайте короткими ходами: задержка хода следует за тем, что модель пишет, а не за тем, что читает.Cutting the process is not a speed lever. Over a measured two-week window the gates and the bookkeeping around them were 27.5% of tool calls and 16.8% of wall time, so removing every gate caps the gain near 1.2x. Keep a gate that earns its place and buy speed with shorter turns: turn latency tracks what the model writes, not what it reads.Урізання процесу - не важіль швидкості. За виміряне двотижневе вікно гейти та бухгалтерія навколо них становили 27,5% викликів інструментів і 16,8% часу за годинником, тож зняття всіх гейтів дає виграш близько 1,2x. Лишіть гейт, що себе виправдовує, а швидкість купуйте короткими ходами: затримка ходу йде за тим, що модель пише, а не за тим, що читає.
- Подбирайте глубину проверки по цене ошибки в находке. Правка опечатки в одну строку заслуживает grep; утверждение о безопасности или сохранности данных заслуживает независимых скептиков, каждый из которых разбирает названный механизм. Одинаковые усилия на то и другое - так ревью становится медленным, а потом его пропускают.Match verification to the cost of the finding being false. A one-line typo fix earns a grep; a security or data-safety claim earns independent skeptics who each address the named mechanism. The same effort on both is how a review gets slow, then gets skipped.Добирайте глибину перевірки за ціною помилки в знахідці. Правка одруківки в один рядок заслуговує на grep; твердження про безпеку чи збереження даних заслуговує на незалежних скептиків, кожен з яких розбирає названий механізм. Однакові зусилля на те й те - так рев'ю стає повільним, а потім його оминають.
- Команда, которая может пережить таймаут переднего плана вашей среды, идёт в фоне; та, что укладывается в него, идёт на переднем плане, потому что фон добавляет ход плюс ожидание. Число берите у среды, не выдумывайте своё. Плагины, серверы инструментов и коннекторы проверяйте по измеренному использованию, а не по тому, насколько полезными они звучат: каждый оплачивается в каждой сессии.A command that can outlive your runtime's foreground timeout runs in the background; one that finishes inside it runs in the foreground, because backgrounding adds a turn plus the waiting. Take the number from the runtime, never pick your own. Audit plugins, tool servers and connectors by measured use, not by how useful they sound: each one is paid on every session.Команда, що може пережити таймаут переднього плану вашого середовища, іде у фоні; та, що вкладається в нього, іде на передньому плані, бо фон додає хід плюс очікування. Число беріть у середовища, не вигадуйте своє. Плагіни, сервери інструментів і конектори перевіряйте за виміряним використанням, а не за тим, наскільки корисними вони звучать: кожен оплачується в кожній сесії.
- Нескольким агентам на одном дереве нужна блокировка, которая ставит в очередь, а не отказывает; одному пишущему за раз она не нужна. Kit не поставляет скрипта блокировки, так что вводите шаблон в тот раз, когда два агента впервые столкнутся, а не раньше. См. параллельные пишущие агенты.Several agents on one tree need a lock that queues instead of refusing; one writer at a time needs none. The kit ships no lock script, so adopt the pattern the first time two agents contend, not before. See parallel writers.Кільком агентам на одному дереві потрібне блокування, яке ставить у чергу, а не відмовляє; одному пишучому за раз воно не потрібне. Kit не постачає скрипта блокування, тож вводьте шаблон того разу, коли два агенти вперше зіткнуться, а не раніше. Див. паралельні пишучі агенти.
Связанные функцииRelated functionsПов'язані функції
- Поручить нетривиальную работу ведущему агентуHand a non-trivial job to a lead agentДоручити нетривіальну роботу ведучому агентовіОдин ведущий агент ведёт запрос от первого чтения до проверенной работы: оценивает задачу, выбирает самый лёгкий подходящий путь и передаёт части другим агентам.One lead agent takes a request from first read to verified work: it classifies the job, picks the lightest path that fits and hands parts to other agents.Один ведучий агент веде запит від першого читання до перевіреної роботи: оцінює завдання, обирає найлегший придатний шлях і передає частини іншим агентам.
- Запустить нескольких пишущих агентов, не потеряв работуRun several writing agents without losing workЗапустити кількох агентів, що пишуть, не втративши роботиДайте каждому пишущему агенту свою рабочую копию или отдайте команды над всем деревом одному владельцу, чтобы stash, reset или checkout не стёрли молча чужие правки.Give each writing agent its own checkout, or give one owner the tree-wide commands, so no stash, reset or checkout silently erases another agent's edits.Дайте кожному агентові, що пише, власну робочу копію або віддайте команди над усім деревом одному власникові, щоб stash, reset чи checkout не стерли мовчки чужі правки.
- Запустить независимые поиски параллельно и проверить результатRun independent lookups in parallel and check what comes backЗапустити незалежні пошуки паралельно й перевірити результатЗапускайте независимые поиски и помощников, которые только читают, вместе, пройдя бюджетный шлюз, а то, что вернула волна, пусть перепроверит оркестратор.Start independent searches and read-only helpers together once the budget gate is passed, and let the orchestrator re-validate what the wave returns.Запускайте незалежні пошуки й помічників, що лише читають, разом, пройшовши бюджетний шлюз, а те, що повернула хвиля, нехай перевірить оркестратор.
- Пустить работу без присмотра циклом свежих процессовRun unattended work as a loop of fresh processesПустити роботу без нагляду циклом свіжих процесівДрайвер вне сессии отдаёт по одному рабочему элементу свежему headless-процессу, а состояние хранится в файлах, поэтому каждый элемент начинается с пустого контекста.A driver outside the session feeds one work item at a time to a fresh headless process, with state kept in files, so each item starts on an empty context.Драйвер поза сесією віддає по одному робочому елементу свіжому headless-процесу, а стан зберігається у файлах, тож кожен елемент починається з порожнього контексту.
- Разобрать очередь тикетов без вашего участия и получить один отчёт в концеDrain the ticket queue unattended and get one report at the endРозібрати чергу тікетів без вашої участі й отримати один звіт наприкінціБерёт тикет с наивысшим приоритетом из тех, что агент может двигать сам, прогоняет конвейер, повторяет, а всё, что требует человека, откладывает в один отчёт.Picks the highest-priority ticket the agent can move alone, runs the pipeline on it, repeats, and defers everything that needs a human to one report.Бере тікет із найвищим пріоритетом серед тих, що агент може рухати сам, проганяє конвеєр, повторює, а все, що потребує людини, відкладає в один звіт.