Когда это нужноWhen to reach for itКоли це потрібно
Новый проект, почти пустая папка или личный локальный проект без Git. Проект, у которого уже есть свой файл правил и свои соглашения, идёт другим путём: влить kit в существующий проект.A new project, a near-empty folder or a personal local project without Git. A project that already has its own rules file and conventions goes the other way: merge the kit into an existing project.Новий проєкт, майже порожня тека або особистий локальний проєкт без Git. Проєкт, у якого вже є власний файл правил і свої домовленості, йде іншим шляхом: влити 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)
- Ищет в интернетеLooks things up on the webШукає в інтернеті
- Работает с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
Согласие с планом разрешает агенту писать в папку проекта. В папке без Git откатиться некуда, поэтому перед большой правкой скопируйте всю папку в надёжное место: эта копия и есть ваша точка возврата.Approving the plan lets the agent write into the project folder. In a folder without Git there is no history to roll back to, so copy the whole folder somewhere safe before you approve a big change: that copy is your restore point.Згода з планом дозволяє агенту писати в теку проєкту. У теці без Git відкотитися нікуди, тож перед великою правкою скопіюйте всю теку в надійне місце: ця копія і є вашою точкою повернення.
ШагиStepsКроки
- Откройте агента в папке проекта и дайте ему разобрать проект штатной командой: /init в Claude Code или её аналог в вашем инструменте. Так у агента появятся файл правил и базовая карта проекта ещё до того, как придёт kit.Open your agent in the project folder and let it map the project with its built-in codebase-init command: /init in Claude Code, or the equivalent in your tool. That gives the agent a rules file and a basic map of the project before the kit arrives.Відкрийте агента в теці проєкту й дайте йому розібрати проєкт штатною командою: /init у Claude Code або її аналог у вашому інструменті. Так в агента з'являться файл правил і базова мапа проєкту ще до того, як прийде kit.
- На главной странице откройте раздел «Как внедрить», часть «A · Новый или почти пустой проект», и скопируйте промпт для нового проекта. На всех языковых версиях страницы он написан по-английски.On the landing page open the section 'How to adopt', part 'A · A new or near-empty project', and copy the prompt for a new project. The prompt is in English on every language version of the page.На головній сторінці відкрийте розділ «Як впровадити», частину «A · Новий або майже порожній проєкт», і скопіюйте промпт для нового проєкту. На всіх мовних версіях сторінки його написано англійською.
- Вставьте его агенту. Он скачает
universal-agent-kit.zipво временную или черновую папку, распакует в папкуuniversal-agent-kit/и прочитает сначалаuniversal-agent-kit/README.md, затемuniversal-agent-kit/docs/PROJECT_SHAPES.md. Если в его среде нельзя скачивать файлы, он остановится и попросит положить архив в рабочую папку.Paste it into the agent. It downloadsuniversal-agent-kit.zipinto a temp or scratch directory, unpacks it to auniversal-agent-kit/folder and readsuniversal-agent-kit/README.mdfirst, thenuniversal-agent-kit/docs/PROJECT_SHAPES.md. If it cannot download files in its environment, it stops and asks you to place the archive in the workspace.Вставте його агенту. Він завантажитьuniversal-agent-kit.zipу тимчасову або чернетку теку, розпакує в текуuniversal-agent-kit/і прочитає спершуuniversal-agent-kit/README.md, потімuniversal-agent-kit/docs/PROJECT_SHAPES.md. Якщо в його середовищі не можна завантажувати файли, він зупиниться й попросить покласти архів у робочу теку. - Промпт просит четыре вещи: файл правил в том виде, который читает ваш инструмент (например,
AGENTS.md,CLAUDE.md, правило Cursor илиGEMINI.md); файлы навыков и роли, подходящие такому проекту; папки для планов и черновиков и папку памяти с индексом; одну команду, которая доказывает, что правка не сломала работу. Для кода агент ещё выберет команды сборки, тестов, линтера и запуска или предложит стек.The prompt asks for four things: a rules file in the form your tool reads (for exampleAGENTS.md,CLAUDE.md, a Cursor rule orGEMINI.md); the skill files and role briefs that fit this kind of project; a plan directory, a scratch directory and a memory folder with its index; and the one command that proves a change is sound. For code it also picks the build, test, lint and run commands, or proposes a stack.Промпт просить чотири речі: файл правил у тому вигляді, який читає ваш інструмент (наприклад,AGENTS.md,CLAUDE.md, правило Cursor чиGEMINI.md); файли навичок і ролі, що пасують такому проєкту; теки для планів і чернеток та теку пам'яті з індексом; одну команду, яка доводить, що правка не зламала роботу. Для коду агент ще обере команди збірки, тестів, лінтера й запуску або запропонує стек. - Промпт заканчивается просьбой сначала показать план и ничего не создавать до вашего согласия. Прочитайте план, попросите правки. Найдите в нём команду проверки:
<CHECK_CMD>- единственный токен, который нельзя оставить пустым.The prompt ends by asking for the plan first and for nothing to be created until you approve. Read the plan and ask for changes. Look for the check command in it:<CHECK_CMD>is the one placeholder nobody may leave empty.Промпт закінчується проханням спершу показати план і нічого не створювати до вашої згоди. Прочитайте план, попросіть правки. Знайдіть у ньому команду перевірки:<CHECK_CMD>- єдиний токен, який не можна лишати порожнім. - После вашего согласия агент создаёт файлы. Файл правил заполнен тем, что в проекте уже есть, а остальное закрыто разумными значениями по умолчанию. Прочитайте, что он выбрал для каждого плейсхолдера, и поправьте; что должен содержать каждый токен, описано в разделе как заполнить плейсхолдеры.After you approve, the agent creates the files. The rules file fills in what already exists in the project and uses sensible defaults for the rest. Read what it chose for each placeholder and correct it; fill the placeholders says what each token should hold.Після вашої згоди агент створює файли. Файл правил заповнений тим, що в проєкті вже є, а решту закрито розумними значеннями за замовчуванням. Прочитайте, що він обрав для кожного плейсхолдера, і поправте; що має містити кожен токен, описано в розділі як заповнити плейсхолдери.
В проекте есть файл правил для вашего инструмента, подходящие навыки и роли, папка планов, папка черновиков, папка памяти с индексом и названная команда проверки, и всё это создано после того, как вы утвердили план.The project has a rules file for your tool, the skills and role briefs that fit it, a plan directory, a scratch directory, a memory folder with its index and a named check command, all created after you approved the plan.У проєкті є файл правил для вашого інструмента, відповідні навички й ролі, тека планів, тека чернеток, тека пам'яті з індексом і названа команда перевірки, і все це створено після того, як ви затвердили план.
СоветыTipsПоради
- Не готовы ко всему? Возьмите
AGENTS.md(иCLAUDE.mdдля Claude Code, без строки импорта памяти), всюdocs/,.claude/skills/quick/и.claude/skills/fix/. Документы ничего не стоят, пока на них не сослалось правило, а когда взяты все, ссылки остаются верными./specдобавьте, когда в задаче впервые появятся настоящие решения,memory/- когда пересказывать одно и то же станет больно.Not ready for the full set? TakeAGENTS.md(plusCLAUDE.mdfor Claude Code, minus its memory import line), the wholedocs/folder,.claude/skills/quick/and.claude/skills/fix/. The docs cost nothing until a rule points at one, and taking them all keeps every pointer true. Add/specwhen a task first carries real design decisions,memory/once re-explaining things hurts.Не готові до всього? ВізьмітьAGENTS.md(іCLAUDE.mdдля Claude Code, без рядка імпорту пам'яті), усюdocs/,.claude/skills/quick/і.claude/skills/fix/. Документи нічого не коштують, доки на них не посилається правило, а коли взято всі, посилання лишаються слушними./specдодайте, коли в задачі вперше з'являться справжні рішення,memory/- коли переказувати те саме стане боляче. - Затем сделайте так, чтобы файл правил называл только то, что вы взяли. Найдите в
AGENTS.md/с именем навыка и удалите или перепишите каждую строку про навык, которого вы не брали: список в разделе 4 и упоминания/park,/ui-clarify,/surfaces,/proveи/specв других местах. Файл правил, отсылающий к отсутствующему навыку, отправляет агента его искать.Then make the rules file name only what you shipped. SearchAGENTS.mdfor/followed by a skill name and delete or reword every line that names a skill you did not take: the list in section 4, and the mentions of/park,/ui-clarify,/surfaces,/proveand/specelsewhere. A rules file that routes to a skill that is not there sends the agent looking for it.Потім зробіть так, щоб файл правил називав лише те, що ви взяли. Знайдіть вAGENTS.md/з іменем навички й видаліть або перепишіть кожен рядок про навичку, якої ви не брали: список у розділі 4 та згадки/park,/ui-clarify,/surfaces,/proveі/specв інших місцях. Файл правил, що відсилає до відсутньої навички, змушує агента її шукати. - Нет репозитория, только папка документов? kit работает так же, меняется лишь страховка. Сначала скопируйте всю папку в надёжное место: эта копия - точка возврата, а сравнение с ней показывает, что изменилось с прошлого раза.
/gitпропустите, строкиgitиз.claude/settings.jsonудалите, а слово «commit» в правилах читайте как «сохранить копию с датой».No repository, a folder of documents? The kit works the same; only the safety net changes shape. Copy the whole folder somewhere safe first: that copy is your restore point, and comparing against it shows what changed since last time. Skip/git, delete thegitlines from.claude/settings.jsonand read 'commit' in the rules as 'keep a dated copy'.Немає репозиторію, лише тека документів? Kit працює так само, змінюється лише страховка. Спершу скопіюйте всю теку в надійне місце: ця копія - точка повернення, а порівняння з нею показує, що змінилося від минулого разу./gitпропустіть, рядкиgitіз.claude/settings.jsonвидаліть, а слово «commit» у правилах читайте як «зберегти копію з датою». - Вручную в Claude Code: скопируйте
.claude/skills/*и.claude/agents/*, положитеAGENTS.mdиCLAUDE.mdв корень репозитория, заполните плейсхолдеры вAGENTS.md, аdocs/*скопируйте в папкуdocs/там же: правила ссылаются наdocs/<NAME>.mdбуквально. В уже имеющийсяCLAUDE.mdдостаточно добавить две строки импорта@.memory/и проверенный.claude/settings.jsonнеобязательны.By hand in Claude Code: copy.claude/skills/*and.claude/agents/*, putAGENTS.mdandCLAUDE.mdat the repo root and fill the placeholders inAGENTS.md, and copydocs/*into adocs/folder there, because the rules citedocs/<NAME>.mdliterally. An existingCLAUDE.mdonly needs the two@import lines.memory/and a reviewed.claude/settings.jsonare optional.Вручну в Claude Code: скопіюйте.claude/skills/*і.claude/agents/*, покладітьAGENTS.mdіCLAUDE.mdу корінь репозиторію, заповніть плейсхолдери вAGENTS.md, аdocs/*скопіюйте в текуdocs/там же: правила посилаються наdocs/<NAME>.mdбуквально. До наявногоCLAUDE.mdдосить додати два рядки імпорту@.memory/і перевірений.claude/settings.jsonнеобов'язкові. - Другой инструмент? Большинство читают
AGENTS.mdнативно. Навыки лежат в открытом формате Agent Skills: одни инструменты берут их прямо из.claude/skills/, другие - из.agents/skills/(скопируйте папку или сделайте ссылку). Адаптацией остаются только агенты: свои агенты, режимы или преамбулы системного промпта. Таблица по инструментам, на 2026-10, - вkit/README.md.Another tool? Most agent tools readAGENTS.mdnatively. The skills are in the open Agent Skills format: some tools load them straight from.claude/skills/, others from.agents/skills/(copy or link the folder). Only the agents stay an adaptation: custom agents, modes or system-prompt preambles. The table per tool, as of 2026-10, is inkit/README.md.Інший інструмент? Більшість читаютьAGENTS.mdнативно. Навички лежать у відкритому форматі Agent Skills: одні інструменти беруть їх прямо з.claude/skills/, інші - з.agents/skills/(скопіюйте теку або зробіть посилання). Адаптацією лишаються тільки агенти: власні агенти, режими чи преамбули системного промпту. Таблиця за інструментами, на 2026-10, - уkit/README.md. - Если проект - не код, промпт всё равно подходит. Какие правила отбросить, читайте в разделе как подогнать метод под работу, которая не код.If the project is not code, the prompt still applies. Read fit the method to work that is not code to see which rules to drop.Якщо проєкт - не код, промпт усе одно підходить. Які правила відкинути, читайте в розділі як підігнати метод під роботу, що не є кодом.
- Чтобы увидеть заполненный файл правил и законченный тикет до начала, прочитайте
examples/из kit: только для чтения, в проект не копируется. См. рабочий пример. Позже вышел более новый kit? Перевести проект на него.To see a filled rules file and a finished ticket before you start, read the kit'sexamples/: reference only, never copied into a project. See the worked example. A newer kit later? Move the project to it.Щоб побачити заповнений файл правил і завершений тікет до початку, прочитайтеexamples/із kit: лише для читання, у проєкт не копіюється. Див. робочий приклад. Згодом вийшов новіший 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 і ваші файли розходяться, перемагають ваші.
- Заполнить плейсхолдеры файла правил под свой проект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.Заповніть одинадцять токенів першого ярусу, потрібних усім, шість токенів шару коду лише якщо проєкт збирається чи запускається, і видаліть правила без предмета.
- Подогнать метод под работу, которая не кодFit the method to work that is not codeПідігнати метод під роботу, що не є кодомСопоставьте слова метода с вашим видом работы, найдите проверку, которая у вас уже есть, и удалите правила слоя кода, которым нечего применять.Map the method's nouns to your kind of work, find the check you already have, and delete the code-layer rules that have nothing to apply to.Зіставте слова методу з вашим видом роботи, знайдіть перевірку, яка у вас уже є, і видаліть правила шару коду, яким нічого застосовувати.
- Написать файл правил, который агент читает первым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, видаліть правила, які проєкту не потрібні, і правте правила лише в цьому одному файлі. - Сохранить то, чему агент научился, до следующей сессииKeep what the agent learns from one session to the nextЗберегти те, чого агент навчився, до наступної сесіїПапка с обычными Markdown-файлами: агент читает её в начале сессии и пополняет по ходу работы, поэтому одну и ту же поправку не приходится повторять.A folder of plain Markdown files the agent reads at the start and writes to as it learns, so the same correction is never needed twice.Тека зі звичайними Markdown-файлами: агент читає її на початку сесії й доповнює в ході роботи, тож одну й ту саму поправку не доводиться повторювати.