Когда это нужноWhen to reach for itКоли це потрібно
Вы раньше внесли kit в проект и теперь скачали более новый либо решили убрать kit из проекта.You merged the kit into a project earlier and have now downloaded a newer one, or you have decided to take the kit out of the project.Ви раніше внесли kit у проєкт і тепер завантажили новіший або вирішили прибрати kit із проєкту.
ТребованияRequirementsВимоги
- Где доступноAvailable inДе доступно
- Каждая загрузка kitEvery download of the kitКожне завантаження kit
- К чему обращаетсяWhat it touchesДо чого звертається
- Читает файлы проектаReads the files of your projectЧитає файли проєкту
- Правит файлы проектаEdits files in your projectЗмінює файли проєкту
- Запускает команды (проверки, git)Runs commands (checks, git)Запускає команди (перевірки, git)
- Работает с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
README.md,merge-prompt.txt
Прежде чем начатьBefore you startПерш ніж почати
Обновление держится на базе сравнения. Не удаляйте старую папку kit, пока обновление не закончено: без неё агент может только провести новое слияние, где каждый уже имеющийся у вас файл kit считается дубликатом или конфликтом, а не новым. Удаление стирает файлы: удаляйте только то, что в списке, и ничего из того, что вы переписали под себя.An upgrade is only as good as its base. Keep the older kit folder until the upgrade is done: without it the agent can only run a fresh merge, in which every kit file you already have counts as a duplicate or a conflict, never as new. Removal deletes files, so delete only what is on the list, and nothing you edited into your own.Оновлення тримається на базі порівняння. Не видаляйте стару теку kit, доки оновлення не завершено: без неї агент може лише провести нове злиття, де кожен наявний у вас файл kit вважається дублікатом або конфліктом, а не новим. Видалення стирає файли: видаляйте лише те, що в списку, і нічого з того, що ви переписали під себе.
ШагиStepsКроки
- Найдите метку. Промпт слияния записал в файл правил одну строку:
Adopted from universal-agent-kit <date>, где дата взята изVERSIONkit - однострочной даты сборки, которая есть в каждом скачанном kit. Если вы вносили kit вручную, добавьте эту строку сами. Обновление начинается с неё.Find your marker. The merge prompt wrote one line into your rules file:Adopted from universal-agent-kit <date>, the date taken from the kit'sVERSION, a one-line build date that every downloaded kit carries. If you merged by hand, add that line yourself. An upgrade starts from it.Знайдіть мітку. Промпт злиття записав у файл правил один рядок:Adopted from universal-agent-kit <date>, де дату взято зVERSIONkit - однорядкової дати збірки, яка є в кожному завантаженому kit. Якщо ви вносили kit вручну, додайте цей рядок самі. Оновлення починається з нього. - Распакуйте новый kit рядом со старым, тем, из которого вы вносили. Затем вставьте агенту
merge-prompt.txtнового kit, дописавMODE: UPGRADEи путь к старой копии. БезMODE: UPGRADEпромпт проводит новое слияние.Unzip the newer kit beside the older one, the kit you merged from. Then paste the newer kit'smerge-prompt.txtinto your agent withMODE: UPGRADEand the path of the older copy. WithoutMODE: UPGRADEthe prompt runs a fresh merge.Розпакуйте новий kit поруч зі старим, тим, з якого ви вносили. Потім вставте агентуmerge-prompt.txtнового kit, дописавшиMODE: UPGRADEі шлях до старої копії. БезMODE: UPGRADEпромпт проводить нове злиття. - Агент сначала читает
VERSIONнового kit,VERSIONстарого kit и строкуAdopted fromв вашем файле правил. Если ваша строка не совпадает сVERSIONстарого kit, он говорит об этом и останавливается: сравнение шло бы от неверной базы.The agent first reads the newer kit'sVERSION, the older kit'sVERSIONand theAdopted fromline in your rules file. If your line does not match the older kit'sVERSION, it says so and stops: the comparison would be against the wrong base.Агент спершу читаєVERSIONнового kit,VERSIONстарого kit і рядокAdopted fromу вашому файлі правил. Якщо ваш рядок не збігається зVERSIONстарого kit, він каже про це й зупиняється: порівняння йшло б від хибної бази. - Инвентаризация, только чтение. Агент сравнивает старый и новый kit файл за файлом: добавлено, удалено, переименовано (таблица переименований лежит в
docs/REPLACES.md), изменено. Для каждого изменённого файла он находит, где это содержимое живёт в вашем проекте: в скопированном файле или в блоках правил, влитых в ваш файл правил.Inventory, read-only. The agent compares the older kit with the newer one file by file: added, removed, renamed (the rename table is indocs/REPLACES.md) and changed. For each changed file it finds where that content lives in your project: the copied file, or the rule blocks merged into your rules file.Інвентаризація, лише читання. Агент порівнює старий і новий kit файл за файлом: додано, видалено, перейменовано (таблиця перейменувань лежить уdocs/REPLACES.md), змінено. Для кожного зміненого файлу він знаходить, де цей вміст живе у вашому проєкті: у скопійованому файлі чи в блоках правил, влитих у ваш файл правил. - План, затем остановка. По каждому изменению агент показывает правку, которую внесёт в вашу копию. Где вы правили это место сами, он показывает обе версии, и выбираете вы. Файл kit, который удалён: удалить вашу копию он предлагает, только если вы её не правили. Для переименованного навыка или плейсхолдера он даёт план переименования. Пока вы не согласились, ничего не пишется.Plan, then a stop. For each change the agent shows the hunk it would apply to your copy. Where you edited that part yourself, it shows both versions and you choose. A kit file that was removed: it proposes deleting your copy only if you never edited it. A renamed skill or placeholder gets a rename plan. Nothing is written until you approve.План, потім зупинка. За кожною зміною агент показує правку, яку внесе у вашу копію. Де ви правили це місце самі, він показує обидві версії, і обираєте ви. Файл kit, який вилучено: видалити вашу копію він пропонує, лише якщо ви її не правили. Для перейменованої навички чи плейсхолдера він дає план перейменування. Доки ви не погодилися, нічого не пишеться.
- После вашего согласия агент применяет план по тем же правилам безопасности, что и новое слияние: сначала резервные копии, коммита нет. Он проводит ту же самопроверку, затем ставит в строке
Adopted fromдату изVERSIONнового kit, и следующее обновление начнётся уже с неё.After you approve, the agent applies the plan under the same safety rules as a fresh merge: backups first, no commit. It runs the same self-check, then sets theAdopted fromline to the date in the newer kit'sVERSION, so the next upgrade starts from it.Після вашої згоди агент застосовує план за тими самими правилами безпеки, що й нове злиття: спершу резервні копії, коміту немає. Він проводить ту саму самоперевірку, потім ставить у рядкуAdopted fromдату зVERSIONнового kit, і наступне оновлення почнеться вже з неї. - Чтобы убрать kit, удалите то, что он добавил, и больше ничего: папки навыков kit в
.claude/skills/;rd-lead.md,solution-researcher.md,implementer.mdиdoc-writer.mdв.claude/agents/; двенадцать файлов kit вdocs/, если вы не переписали их под себя.To take the kit out instead, delete what it added and nothing else: the kit's skill folders in.claude/skills/;rd-lead.md,solution-researcher.md,implementer.mdanddoc-writer.mdin.claude/agents/; the twelve kit files indocs/, unless you have edited them into your own.Щоб прибрати kit, видаліть те, що він додав, і більше нічого: теки навичок kit у.claude/skills/;rd-lead.md,solution-researcher.md,implementer.mdіdoc-writer.mdу.claude/agents/; дванадцять файлів kit уdocs/, якщо ви не переписали їх під себе. - Затем уберите правила, влитые в
AGENTS.md(или в ваш файл правил), две строки импорта@вCLAUDE.md, строкуAdopted fromи строки, взятые из.claude/settings.json.memory/удаляйте, только если в ней остались одни примеры: настоящие записи ваши.<PLAN_DIR>/и её тикеты - история вашего проекта, а не kit: их оставьте.Then take out the rules you merged intoAGENTS.md(or your own rules file), the two@import lines inCLAUDE.md, theAdopted fromline and the lines you took from.claude/settings.json. Removememory/only if it still holds the example entries: real memories are yours.<PLAN_DIR>/and its tickets are your project's history, not the kit's: keep them.Далі приберіть правила, влиті вAGENTS.md(або у ваш файл правил), два рядки імпорту@уCLAUDE.md, рядокAdopted fromі рядки, взяті з.claude/settings.json.memory/видаляйте, лише якщо в ній лишилися самі приклади: справжні записи ваші.<PLAN_DIR>/та її тікети - історія вашого проєкту, а не kit: їх лишіть.
Что вы должны увидетьWhat you should seeЩо ви маєте побачити
После обновления в ваши файлы попала только утверждённая вами разница, у каждого изменённого файла есть копия, а строка Adopted from несёт дату нового kit. После удаления то, что добавил kit, исчезло; ваши переписанные файлы, настоящие записи памяти и тикеты в <PLAN_DIR>/ остаются.After an upgrade, only the differences you approved reached your files, each changed file has a backup, and the Adopted from line carries the newer kit's date. After a removal, what the kit added is gone; your edited files, real memories and the tickets in <PLAN_DIR>/ stay.Після оновлення у ваші файли потрапила лише затверджена вами різниця, у кожного зміненого файлу є копія, а рядок Adopted from несе дату нового kit. Після видалення те, що додав kit, зникло; ваші переписані файли, справжні записи пам'яті й тікети в <PLAN_DIR>/ лишаються.
СоветыTipsПоради
- Нет старой копии, на которую можно указать? Тогда промпт проводит новое слияние, где каждый уже имеющийся у вас файл kit считается дубликатом или конфликтом, а не новым. Как читается такой план, описано в как влить kit в существующий проект.No older copy to point at? The prompt then runs a fresh merge in which every kit file you already have counts as a duplicate or a conflict, never as new. How that plan reads is in merge the kit into an existing project.Немає старої копії, на яку можна вказати? Тоді промпт проводить нове злиття, де кожен наявний у вас файл kit вважається дублікатом або конфліктом, а не новим. Як читається такий план, описано в як влити kit в наявний проєкт.
- Переименования приходят планом, а не автозаменой. Таблица в
docs/REPLACES.mdфиксирует, что переехало, например<MAX_LOC>стал<SIZE_BUDGET>, а навык verify стал/prove.<ID>переименовывайте в<ID_SCHEME>только там, где он называет настройку (см. как заполнить плейсхолдеры).Renames arrive as a plan, not as a find-and-replace. The table indocs/REPLACES.mdrecords what moved, for example<MAX_LOC>became<SIZE_BUDGET>and the skill verify became/prove. Rename<ID>to<ID_SCHEME>only where it names the setting (see fill the placeholders).Перейменування приходять планом, а не автозаміною. Таблиця вdocs/REPLACES.mdфіксує, що переїхало, наприклад<MAX_LOC>став<SIZE_BUDGET>, а навичка verify стала/prove.<ID>перейменовуйте на<ID_SCHEME>лише там, де він називає налаштування (див. як заповнити плейсхолдери). - Ваша строка и старый kit не сходятся? Агент остановится, а не станет гадать. Укажите ему тот kit, из которого вы действительно вносили.Your line and the older kit disagree? The agent stops instead of guessing. Point it at the kit you actually merged from.Ваш рядок і старий kit не сходяться? Агент зупиниться, а не гадатиме. Вкажіть йому той kit, з якого ви справді вносили.
- Нет репозитория? Обновление идёт по тем же правилам безопасности, что и новое слияние, поэтому вместо ветки точкой возврата служат его резервные копии. Для папки с документами перед началом скопируйте всю папку в надёжное место, как перед первым слиянием.No repository? An upgrade uses the same safety rules as a fresh merge, so the backups it makes are your restore point instead of a branch. For a folder of documents, copy the whole folder somewhere safe first, as for the first merge.Немає репозиторію? Оновлення йде за тими самими правилами безпеки, що й нове злиття, тому замість гілки точкою повернення правлять його резервні копії. Для теки з документами перед початком скопіюйте всю теку в надійне місце, як перед першим злиттям.
- Папка
examples/в kit только для чтения и никогда не копируется в проект, поэтому в списке удаления её нет.The kit'sexamples/folder is reference only and is never copied into a project, so it is not on the removal list.Текаexamples/у kit лише для читання і ніколи не копіюється в проєкт, тому в списку видалення її немає.
Связанные функцииRelated functionsПов'язані функції
- Влить kit в существующий проект, не потеряв свои файлыMerge the kit into an existing project without losing your filesВлити kit в наявний проєкт, не втративши свої файлиАгент описывает ваш проект, показывает план слияния и останавливается. Ничего не пишется до вашего согласия, а где kit и ваши файлы расходятся, побеждают ваши.The agent inventories your project, shows a merge plan and stops. Nothing is written until you approve, and where the kit and your files disagree, yours win.Агент описує ваш проєкт, показує план злиття й зупиняється. Нічого не пишеться до вашої згоди, а де kit і ваші файли розходяться, перемагають ваші.
- Поднять новый проект по методу kitSet up a new project on the kit's methodПідняти новий проєкт за методом kitОдин промпт поднимает новый или почти пустой проект по методу: файл правил, подходящие навыки и роли, рабочие папки и названная проверка.One prompt stands a fresh or near-empty project up on the method: a rules file, the skills and role briefs that fit, the working folders and a named check.Один промпт піднімає новий або майже порожній проєкт за методом: файл правил, відповідні навички й ролі, робочі теки та названа перевірка.
- Заполнить плейсхолдеры файла правил под свой проектFill the placeholders of the rules file for your projectЗаповнити плейсхолдери файлу правил під свій проєктЗаполните одиннадцать токенов первого яруса, нужных любому проекту, шесть токенов слоя кода только если проект собирается или запускается, и удалите правила без предмета.Fill the eleven tier-1 tokens every project needs, the six code-layer tokens only if the project builds or runs, and delete the rules that have no subject.Заповніть одинадцять токенів першого ярусу, потрібних усім, шість токенів шару коду лише якщо проєкт збирається чи запускається, і видаліть правила без предмета.
- Написать файл правил, который агент читает первымWrite the rules file your agent reads firstНаписати файл правил, який агент читає першимЗаполните плейсхолдеры
AGENTS.md, удалите ненужные проекту правила и правьте правила только в этом одном файле.Fill the placeholders ofAGENTS.md, delete the rules your project does not need, and edit the rules in that one file only.Заповніть плейсхолдериAGENTS.md, видаліть правила, які проєкту не потрібні, і правте правила лише в цьому одному файлі.