Функции в этом руководствеFunctions in this guideФункції в цьому посібнику
- Поднять новый проект по методу 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.Один промпт піднімає новий або майже порожній проєкт за методом: файл правил, відповідні навички й ролі, робочі теки та названа перевірка.
- Влить 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.Заповніть одинадцять токенів першого ярусу, потрібних усім, шість токенів шару коду лише якщо проєкт збирається чи запускається, і видаліть правила без предмета.
- Написать файл правил, который агент читает первым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, видаліть правила, які проєкту не потрібні, і правте правила лише в цьому одному файлі. - Изучить метод по одному законченному небольшому тикету и заполненному файлу правилLearn the method from one finished small ticket and a filled rules fileВивчити метод за одним завершеним невеликим тікетом і заповненим файлом правилПапка
examples/в kit показывает один небольшой тикет в законченном виде и заполненный фрагмент файла правил. Только для чтения: в проект её не копируют.The kit'sexamples/folder shows one small ticket in its finished state and a filled excerpt of a rules file. Reference only: read it, never copy it into a project.Текаexamples/у kit показує один невеликий тікет у завершеному вигляді та заповнений уривок файлу правил. Лише для читання: у проєкт її не копіюють. - Внести мелкую правку без церемонийMake a one-line edit without ceremonyВнести дрібну правку без церемонійОпечатка, константа или подпись исправлены за одно предложение: без спеки и без сборки.A typo, a constant or a label changed in one sentence's worth of work: no spec, no build gate.Одруківку, константу чи підпис виправлено за одне речення: без спеки й без збірки.
- Исправить узкий баг без церемонийFix a narrow bug without ceremonyВиправити вузький баг без церемонійБаг с понятной причиной исправлен в корне: минимальная правка, одна локальная проверка, отчёт в три строки, без спеки.A bug with a known cause is fixed at the root: smallest change, one local check, a three-line report, no spec.Баг зі зрозумілою причиною виправлено в корені: мінімальна правка, одна локальна перевірка, звіт у три рядки, без спеки.
- Перевести проект на более новый kit или убрать kit обратноMove an adopted project to a newer kit, or take the kit out againПеревести проєкт на новіший kit або прибрати kit назадОтдайте агенту новый
merge-prompt.txtсMODE: UPGRADE: после вашего согласия он применит только разницу. Или удалите то, что добавил kit, и больше ничего.Give your agent the newermerge-prompt.txtwithMODE: UPGRADE: after your approval it applies only the difference. Or delete what the kit added, and nothing else.Віддайте агенту новийmerge-prompt.txtізMODE: UPGRADE: після вашої згоди він застосує лише різницю. Або видаліть те, що додав kit, і більше нічого.
ШагиStepsКроки
- Выберите путь по тому, что уже лежит в папке. Новая или почти пустая папка идёт одним промптом: поднять новый проект. Проект со своими файлами, правилами или
.claude/идёт через промпт слияния: влить kit в существующий проект, где при расхождении побеждают ваши файлы. В обоих случаях агент сначала показывает план и ничего не пишет, пока вы его не утвердите.Choose the path by what is already in the folder. A new or near-empty folder takes one prompt: set up a new project. A project with its own files, rules or.claude/takes the merge prompt: merge the kit into an existing project, where your files win any disagreement. Either way the agent shows a plan first and writes nothing until you approve it.Оберіть шлях за тим, що вже лежить у теці. Нова або майже порожня тека йде одним промптом: підняти новий проєкт. Проєкт зі своїми файлами, правилами чи.claude/іде через промпт злиття: влити kit у наявний проєкт, де за розбіжності перемагають ваші файли. В обох випадках агент спершу показує план і нічого не пише, доки ви його не затвердите. - Подготовьте страховку до того, как что-либо утверждать. Git-репозиторий даёт промпту слияния новую ветку для работы. Нет репозитория, у вас папка документов? kit работает так же, меняется лишь страховка: сначала скопируйте всю папку в надёжное место, эта копия и есть ваша точка возврата, а промпт слияния вместо ветки использует свои резервные копии и говорит об этом в плане.
/gitпропустите, строкиgitиз.claude/settings.jsonудалите.Set the safety net before you approve anything. A git repository gives the merge prompt a new branch to work on. With no repository, as in a folder of documents, the kit works the same and only the safety net changes: copy the whole folder somewhere safe first, because that copy is your restore point, and the merge prompt falls back to its own backups and says so in the plan. Skip/gitand delete thegitlines from.claude/settings.json.Підготуйте страховку, перш ніж щось затверджувати. Git-репозиторій дає промптові злиття нову гілку для роботи. Немає репозиторію, у вас тека документів? Kit працює так само, змінюється лише страховка: спершу скопіюйте всю теку в надійне місце, ця копія і є вашою точкою повернення, а промпт злиття замість гілки використовує власні резервні копії й каже про це в плані./gitпропустіть, рядкиgitіз.claude/settings.jsonвидаліть. - Прочитайте план, прежде чем его утверждать. Найдите в нём команду проверки
<CHECK_CMD>- единственный плейсхолдер, который нельзя оставить пустым; поставьте на неё самую дешёвую настоящую проверку из тех, что есть сегодня, и улучшайте потом. В плане слияния прочтите ещё каждый пункт с пометкой DUPLICATE или CONFLICT и каждый плейсхолдер, который агент не смог определить: он остаётся своим токеном<PLACEHOLDER>, а неTODO. Попросите правки и только потом утверждайте.Read the plan before you approve it. Look for the check command,<CHECK_CMD>, the one placeholder nobody may leave empty; point it at the cheapest real check you have today and improve it later. In a merge plan, also read every item marked DUPLICATE or CONFLICT and every placeholder the agent could not resolve: it stays as its<PLACEHOLDER>token, neverTODO. Ask for changes, then approve.Прочитайте план, перш ніж його затверджувати. Знайдіть у ньому команду перевірки<CHECK_CMD>- єдиний плейсхолдер, який не можна лишати порожнім; поставте на неї найдешевшу справжню перевірку з тих, що є сьогодні, і покращуйте потім. У плані злиття прочитайте ще кожен пункт із позначкою DUPLICATE або CONFLICT і кожен плейсхолдер, який агент не зміг визначити: він лишається своїм токеном<PLACEHOLDER>, а неTODO. Попросіть правки й лише потім затверджуйте. - Проверьте вписанное агентом; что должен содержать каждый токен, описано в разделе как заполнить плейсхолдеры. Первый ярус, одиннадцать токенов, нужен любому проекту. В нём
<CHAT_LANGUAGE>(язык чата),<ARTIFACT_LANGUAGE>(язык файлов, документов, логов и коммитов) и<ID_SCHEME>(схема идентификаторов тикетов, один раз, напримерT0042; не<ID>, тот заполняется по тикету). Второй ярус, шесть токенов, - слой кода, для проекта, который собирается или запускается. Не оставляйте токен пустым и не выдумывайте значение: где kit велит, пишитеnoneилиn/a.Check what the agent put in each placeholder; fill the placeholders says what each token should hold. Tier 1, eleven tokens, is for every project. It includes<CHAT_LANGUAGE>(how the agent talks to you),<ARTIFACT_LANGUAGE>(the language of files, docs, logs and commits) and<ID_SCHEME>(the ticket id scheme, filled once, for exampleT0042; not<ID>, which is filled per ticket). Tier 2, six tokens, is the code layer, only for a project that builds or runs. Never leave a token empty or invent a value: writenoneorn/awhere the kit says so.Перевірте вписане агентом; що має містити кожен токен, описано в розділі як заповнити плейсхолдери. Перший ярус, одинадцять токенів, потрібен кожному проєкту. У ньому<CHAT_LANGUAGE>(мова чату),<ARTIFACT_LANGUAGE>(мова файлів, документів, логів і комітів) та<ID_SCHEME>(схема ідентифікаторів тікетів, один раз, наприкладT0042; не<ID>, той заповнюється за тікетом). Другий ярус, шість токенів, - шар коду, для проєкту, який збирається чи запускається. Не лишайте токен порожнім і не вигадуйте значення: де kit велить, пишітьnoneчиn/a. - Удалите то, чему нечего применять. Если проект не собирается и не запускается, удалите правила слоя кода, а не заполняйте их выдуманными значениями, и удалите каждую строку про навык, которого вы не брали. Прочитайте строгие правила в файле правил, держа в голове свой проект, и оставьте только подходящее. Правила держите в одном месте: правьте
AGENTS.md, аCLAUDE.md- лишь точка входа для Claude Code, которая его импортирует.Delete what has no subject. If the project does not compile or run, delete the code-layer rules instead of filling them with made-up values, and delete every line that names a skill you did not take. Read the strict rules in the rules file with your own project in mind and keep only what fits. Keep the rules in one place: editAGENTS.md, whileCLAUDE.mdis only the Claude Code entry point that imports it.Видаліть те, чому нічого застосовувати. Якщо проєкт не збирається й не запускається, видаліть правила шару коду, а не заповнюйте їх вигаданими значеннями, і видаліть кожен рядок про навичку, якої ви не брали. Прочитайте суворі правила у файлі правил, маючи на думці свій проєкт, і залиште лише потрібне. Правила тримайте в одному місці: правтеAGENTS.md, аCLAUDE.md- лише точка входу для Claude Code, яка його імпортує. - Посмотрите на законченный пример, прежде чем писать своё. В папке
examples/kit лежат один небольшой тикет в законченном виде и заполненный фрагмент файла правил: видно, как выглядят заполненные значения. Только для чтения: читайте, но в проект не копируйте. По порядку их разбирает рабочий пример.Look at a finished example before you write your own. The kit'sexamples/folder holds one small ticket in its finished state and a filled excerpt of a rules file, so you can see what filled values look like. It is reference only: read it, never copy it into the project. The worked example takes you through it in order.Подивіться на завершений приклад, перш ніж писати своє. У теціexamples/kit лежать один невеликий тікет у завершеному вигляді та заповнений уривок файлу правил: видно, як виглядають заповнені значення. Лише для читання: читайте, але в проєкт не копіюйте. По порядку їх розбирає робочий приклад. - Сначала потратьте kit на правку в одну строку. Опишите её одной строкой, например
/quick fix typo in the Save button label, и/quickвнесёт изменение, запустит самую маленькую подходящую проверку и отчитается одним предложением. Спека не создаётся, сборка не запускается. Если правка не настолько мелкая, он откажется, назвав причину и подходящую команду.Spend the kit on a one-line edit first. Describe it in one line, for example/quick fix typo in the Save button label, and/quickmakes the change, runs the smallest check that fits and reports in one sentence. No spec is created and no build gate runs. If the edit is not that small, it refuses with the reason and names the command that fits.Спершу витратьте kit на правку в один рядок. Опишіть її одним рядком, наприклад/quick fix typo in the Save button label, і/quickвнесе зміну, запустить найменшу відповідну перевірку й звітує одним реченням. Спека не створюється, збірка не запускається. Якщо правка не така дрібна, він відмовиться, назвавши причину й відповідну команду. - Затем возьмите узкий баг, причину которого понимаете:
/fix list scroll position jumps to top after returning from detail./fixназывает первопричину до того, как тронет код, вносит самую маленькую правку, которая её устраняет, проверяет результат локально и отчитывается тремя строками: причина, правка, проверка. Если правка требует проектных решений или разрастается больше чем до нескольких файлов, он останавливается и отправляет вас в/spec.Then try a narrow bug whose cause you understand:/fix list scroll position jumps to top after returning from detail./fixnames the root cause before it touches code, makes the smallest change that removes it, checks the result locally and reports in three lines: cause, fix, validation. If the fix needs design decisions or grows past a handful of files, it stops and sends you to/spec.Потім візьміть вузький баг, причину якого розумієте:/fix list scroll position jumps to top after returning from detail./fixназиває першопричину, перш ніж торкнеться коду, вносить найменшу правку, що її усуває, перевіряє результат локально й звітує трьома рядками: причина, правка, перевірка. Якщо правка потребує проєктних рішень або розростається більше ніж до кількох файлів, він зупиняється й відправляє вас до/spec. - Тяжёлые части добавляйте, только когда задача их заслужила.
/specподключите, когда в задаче впервые появятся настоящие проектные решения, аmemory/- когда пересказывать одно и то же станет больно. Когда проверка раз за разом ловит один и тот же дефект, добавьте соответствующий запрет в раздел 9 файла правил. Вышел более новый kit? Переведите проект на него и не удаляйте старую папку kit, пока это не закончено. Дальше: фича от идеи до результата и мелкие правки.Add the heavier parts only when a task earns them. Add/specwhen a task first carries real design decisions, andmemory/once re-explaining things starts to hurt. When a check keeps flagging the same defect, add the matching DON'T to section 9 of the rules file. A newer kit later? Move the project to it and keep the older kit folder until that is done. Next: a feature from idea to result and small changes.Важчі частини додавайте, лише коли задача їх заслужила./specпідключіть, коли в задачі вперше з'являться справжні проєктні рішення, аmemory/- коли переказувати те саме стане боляче. Коли перевірка раз у раз ловить той самий дефект, додайте відповідну заборону в розділ 9 файлу правил. Вийшов новіший kit? Переведіть проєкт на нього і не видаляйте стару теку kit, доки це не завершено. Далі: фіча від ідеї до результату і дрібні правки.
Что вы должны увидетьWhat you should seeЩо ви маєте побачити
В проекте один файл правил, где каждый плейсхолдер-настройка заполнен или правило удалено, названная команда проверки и одна законченная мелкая задача с отчётом в предложение или в три строки. Вы видели заполненный пример и знаете, какие тяжёлые части добавлять и когда.The project has one rules file with every setting placeholder filled or its rule deleted, a named check command, and one finished small task reported in a sentence or three lines. You have seen a filled example, and you know which heavier parts to add, and when.У проєкті один файл правил, де кожен плейсхолдер-налаштування заповнено або правило видалено, названа команда перевірки й одна завершена дрібна задача зі звітом в одне речення чи в три рядки. Ви бачили заповнений приклад і знаєте, які важчі частини додавати і коли.