Заполнить плейсхолдеры файла правил под свой проектFill the placeholders of the rules file for your projectЗаповнити плейсхолдери файлу правил під свій проєкт

Когда это нужноWhen to reach for itКоли це потрібно

Сразу после копирования kit в проект или когда перед вами план слияния с таблицей предложенных значений. Также при переходе с более ранней копии kit: см. перевести проект на более новый kit.Right after copying the kit into a project, or when a merge plan with a table of proposed values is on your desk. Also when you upgrade from an earlier copy of the kit: see move to a newer kit.Одразу після копіювання kit у проєкт або коли перед вами план злиття з таблицею запропонованих значень. Також під час переходу з ранішої копії 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Змінює файли проєкту

Работает с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/REPLACES.md, docs/REPLACES_RU.md

СоветыTipsПоради

• <CHECK_CMD> - самая ценная строка файла. Если вам кажется, что в проекте нет ничего механического, сначала прочитайте как подогнать метод под работу, которая не код: там пять форм, которые проверка принимает там, где ничего не компилируется, и большинство проектов уже запускает одну из них руками.<CHECK_CMD> is the most valuable line in the file. If you think your project has nothing mechanical to run, read fit the method to work that is not code first: it lists five shapes a check takes in work that never compiles, and most projects already run one by hand.<CHECK_CMD> - найцінніший рядок файлу. Якщо вам здається, що в проєкті немає нічого механічного, спершу прочитайте як підігнати метод під роботу, що не є кодом: там п'ять форм, яких набуває перевірка там, де нічого не компілюється, і більшість проєктів уже запускає одну з них руками.
• <INDEX_DOC> - это не только то, что читают, но и то, что поддерживают: с него начинается порядок исследования агента, и устаревшая карта стоит неверного поворота в каждой задаче. <SIZE_BUDGET> - эвристика «файл делает слишком много», а не закон. Ставьте её там, где начинает ворчать ваше собственное ревью.<INDEX_DOC> is something to maintain, not only to read: the agent's research order starts there, so a stale map costs a wrong turn on every task. <SIZE_BUDGET> is a heuristic for 'this file does too many things', not a law. Set it where your own review starts complaining.<INDEX_DOC> - це не лише те, що читають, а й те, що підтримують: з нього починається порядок дослідження агента, і застаріла мапа коштує хибного повороту в кожній задачі. <SIZE_BUDGET> - евристика «файл робить забагато», а не закон. Ставте її там, де починає буркотіти ваше власне рев'ю.
• Четыре командных токена уточняют <CHECK_CMD>, а не заменяют его. Правила kit берут самую узкую проверку, доказывающую именно эту правку, и заполненные пять токенов позволяют агенту выбрать компиляцию вместо полной сборки.The four command tokens refine <CHECK_CMD>, they do not replace it. The kit's rules reach for the narrowest check that proves the change, so having all five filled is what lets an agent pick a compile over a full build.Чотири командні токени уточнюють <CHECK_CMD>, а не замінюють його. Правила kit беруть найвужчу перевірку, що доводить саме цю правку, і заповнені п'ять токенів дають агенту змогу обрати компіляцію замість повного складання.
• Если у вас более ранняя копия: <SRC_ROOT> теперь <WORK_ROOT>, а <MAX_LOC> теперь <SIZE_BUDGET>; автозамена по заполненной копии закрывает оба. У <CHECK_CMD> старого значения нет: запишите самую дешёвую проверку, которую вы и так делаете руками. <ARTIFACT_LANGUAGE> тоже новый: значение English сохраняет прежнее поведение.Coming from an earlier copy: <SRC_ROOT> is now <WORK_ROOT> and <MAX_LOC> is now <SIZE_BUDGET>, and a find-and-replace over your filled copy covers both. <CHECK_CMD> has no old value: write down the cheapest check you already run by hand. <ARTIFACT_LANGUAGE> is new too: English keeps the old behaviour.Якщо у вас ранніша копія: <SRC_ROOT> тепер <WORK_ROOT>, а <MAX_LOC> тепер <SIZE_BUDGET>; автозаміна по заповненій копії закриває обидва. У <CHECK_CMD> старого значення немає: запишіть найдешевшу перевірку, яку ви й так робите руками. <ARTIFACT_LANGUAGE> теж новий: значення English зберігає колишню поведінку.
• Настройка <ID> стала <ID_SCHEME>. Переименовывайте её только там, где она называет настройку, и никогда глобально, потому что навыки используют <ID> на каждый тикет. Если прежнее слияние вписало в навыки фиксированный идентификатор вроде T0042, верните туда <ID>.The setting <ID> became <ID_SCHEME>. Rename it only where it names the setting, never globally, since the skills use <ID> per ticket. If an earlier merge wrote a fixed id such as T0042 into the skills, put <ID> back.Налаштування <ID> стало <ID_SCHEME>. Перейменовуйте його лише там, де воно називає налаштування, і ніколи глобально, бо навички використовують <ID> на кожен тікет. Якщо попереднє злиття вписало в навички фіксований ідентифікатор на кшталт T0042, поверніть туди <ID>.
• Старые навыки verify и review теперь /prove и /critique, потому что старые имена перекрывали команды самой среды, а .claude/commands/ стал .claude/skills/. Скопируйте .claude/skills/ из нового kit, заполните его плейсхолдеры и удалите старые файлы .claude/commands/, иначе старые имена продолжат перекрывать команды среды.The old skills verify and review are now /prove and /critique, because the old names shadowed commands the runtime ships, and .claude/commands/ became .claude/skills/. Copy .claude/skills/ from the new kit, fill its placeholders and delete the old .claude/commands/ files, or the old names keep shadowing the runtime's own.Старі навички verify і review тепер /prove та /critique, бо старі імена перекривали команди самого середовища, а .claude/commands/ став .claude/skills/. Скопіюйте .claude/skills/ із нового kit, заповніть його плейсхолдери й видаліть старі файли .claude/commands/, інакше старі імена й далі перекриватимуть команди середовища.
• В docs/REPLACES.md есть готовые значения по видам проектов (софт, данные и аналитика, тексты и документация, юридическое и операционное) и по стекам для слоя кода. docs/REPLACES_RU.md - русское издание того же документа; если команда читает по-английски, его можно не брать.docs/REPLACES.md carries worked values per kind of project, for software, data and analysis, writing and docs, legal and ops, and per stack for the code layer. docs/REPLACES_RU.md is the Russian edition of the same document; skip it unless your team reads Russian.У docs/REPLACES.md є готові значення за видами проєктів (софт, дані й аналітика, тексти й документація, юридичне та операційне) і за стеками для шару коду. docs/REPLACES_RU.md - російське видання того самого документа; якщо команда читає англійською, його можна не брати.

Связанные функцииRelated functionsПов'язані функції

• Подогнать метод под работу, которая не код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 of AGENTS.md, delete the rules your project does not need, and edit the rules in that one file only.Заповніть плейсхолдери AGENTS.md, видаліть правила, які проєкту не потрібні, і правте правила лише в цьому одному файлі.
• Влить 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.Один промпт піднімає новий або майже порожній проєкт за методом: файл правил, відповідні навички й ролі, робочі теки та названа перевірка.
• Доказать, что правка работает, прежде чем объявлять её готовойProve a change works before calling it doneДовести, що правка працює, перш ніж оголошувати її готовоюВозьмите самую дешёвую проверку, которая доказывает именно эту правку, запишите ожидаемое и фактическое и называйте шаг готовым, только прочитав результат.Pick the lowest check that proves this change, write down expected and actual, and call the step done only after you have read the result.Візьміть найдешевшу перевірку, що доводить саме цю правку, запишіть очікуване й фактичне та називайте крок готовим, лише прочитавши результат.