Когда это нужноWhen to reach for itКоли це потрібно
Вы скопировали kit в проект, и в AGENTS.md остались незаполненные плейсхолдеры, либо вы не уверены, какой из файлов, AGENTS.md или CLAUDE.md, править.You have copied the kit into a project and AGENTS.md still holds unfilled placeholders, or you are not sure which of AGENTS.md and CLAUDE.md to edit.Ви скопіювали kit у проєкт, і в AGENTS.md лишилися незаповнені плейсхолдери, або ви не певні, який із файлів, AGENTS.md чи CLAUDE.md, правити.
Требования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
AGENTS.md,CLAUDE.md
Прежде чем начатьBefore you startПерш ніж почати
Правьте правила только в AGENTS.md и никогда в CLAUDE.md: два файла правил расходятся. В CLAUDE.md стоит добавлять только то, что относится к Claude Code.Edit the rules in AGENTS.md only, never in CLAUDE.md: two rules files drift. What you add to CLAUDE.md should be specific to Claude Code.Правте правила лише в AGENTS.md і ніколи в CLAUDE.md: два файли правил розходяться. До CLAUDE.md варто додавати лише те, що стосується Claude Code.
ШагиStepsКроки
- Откройте
AGENTS.md. В его шапке сказано заполнить каждый плейсхолдер; список и готовые значения лежат вdocs/REPLACES.md. Каждый проект заполняет<PROJECT_NAME>,<CHAT_LANGUAGE>,<ARTIFACT_LANGUAGE>,<INDEX_DOC>,<WORK_ROOT>,<CHECK_CMD>,<PLAN_DIR>,<SCRATCH_DIR>,<SIZE_BUDGET>,<READONLY_ZONES>и<ID_SCHEME>.<ID>в их число не входит: это идентификатор одного тикета, и его подставляют для каждого тикета.OpenAGENTS.md. Its header asks you to fill every placeholder; the list and worked values are indocs/REPLACES.md. The ones every project fills are<PROJECT_NAME>,<CHAT_LANGUAGE>,<ARTIFACT_LANGUAGE>,<INDEX_DOC>,<WORK_ROOT>,<CHECK_CMD>,<PLAN_DIR>,<SCRATCH_DIR>,<SIZE_BUDGET>,<READONLY_ZONES>and<ID_SCHEME>.<ID>is not one of them: it is one ticket's id, filled per ticket.ВідкрийтеAGENTS.md. У його шапці сказано заповнити кожен плейсхолдер; список і готові значення лежать уdocs/REPLACES.md. Кожен проєкт заповнює<PROJECT_NAME>,<CHAT_LANGUAGE>,<ARTIFACT_LANGUAGE>,<INDEX_DOC>,<WORK_ROOT>,<CHECK_CMD>,<PLAN_DIR>,<SCRATCH_DIR>,<SIZE_BUDGET>,<READONLY_ZONES>і<ID_SCHEME>.<ID>до їхнього числа не входить: це ідентифікатор одного тікета, і його підставляють для кожного тікета. - Впишите в
<CHECK_CMD>одну команду, которая доказывает, что правка в порядке. Это единственный плейсхолдер, который нельзя оставлять пустым. «У нас нет проверок» почти всегда неверно, так что прочтитеdocs/PROJECT_SHAPES.md, прежде чем в это поверить.Fill<CHECK_CMD>with the one command that proves a change. It is the one placeholder nobody may leave empty. "We have no checks" is almost always false, so readdocs/PROJECT_SHAPES.mdbefore you believe it.Впишіть у<CHECK_CMD>одну команду, що доводить правильність правки. Це єдиний плейсхолдер, який не можна лишати порожнім. «У нас немає перевірок» майже завжди хибне, тож прочитайтеdocs/PROJECT_SHAPES.md, перш ніж у це повірити. - Решите, нужен ли вам слой кода:
<ARCH_LAYERS>,<BUILD_CMD>,<TEST_CMD>,<LINT_CMD>,<RUN_CMD>и<LOGGER>. Заполняйте их, только если проект собирается или запускается, а иначе удалите правила, которые на них опираются. Если проект про данные, тексты, право или операции,docs/PROJECT_SHAPES.mdобъясняет, что существительные правил значат в вашей работе, и какие правила удалить целиком.Decide on the code layer:<ARCH_LAYERS>,<BUILD_CMD>,<TEST_CMD>,<LINT_CMD>,<RUN_CMD>and<LOGGER>. Fill them only if your project builds or runs; otherwise delete the rules that use them. For data, writing, legal or operations work,docs/PROJECT_SHAPES.mdsays what the rules' nouns mean in your work and which rules to delete outright.Вирішіть, чи потрібен вам шар коду:<ARCH_LAYERS>,<BUILD_CMD>,<TEST_CMD>,<LINT_CMD>,<RUN_CMD>і<LOGGER>. Заповнюйте їх, лише якщо проєкт збирається або запускається, а інакше видаліть правила, що на них спираються. Якщо проєкт про дані, тексти, право чи операції,docs/PROJECT_SHAPES.mdпояснює, що іменники правил означають у вашій роботі, і які правила видалити повністю. - Прочитайте раздел 8, «Strict rules», с мыслью о своём проекте: никаких записей в корень проекта, лимит размера файла, тонкие точки входа, зоны только для чтения, которые не изменяются, резервная копия большого файла в каталог scratch перед крупной правкой. Оставьте то, что подходит, остальное удалите.Read section 8, "Strict rules", with your project in mind: no writes to the project root, a size budget per file, thin entry points, read-only zones that are never modified, a backup of a large file into the scratch directory before a big edit. Keep what fits and delete what does not.Прочитайте розділ 8, «Strict rules», з думкою про свій проєкт: жодних записів у корінь проєкту, ліміт розміру файлу, тонкі точки входу, зони лише для читання, які не змінюються, резервна копія великого файлу в каталог scratch перед великою правкою. Залиште те, що пасує, решту видаліть.
- Оставьте разделение ролей таким, как в kit.
AGENTS.mdхранит правила, и именно его вы правите.CLAUDE.md- точка входа для Claude Code: впишите<PROJECT_NAME>в его заголовок, сохраните импорт@AGENTS.md(и@memory/MEMORY.md, если используетеmemory/) и добавляйте только то, что относится именно к Claude Code.Leave the split of roles as the kit has it.AGENTS.mdholds the rules and is the file you edit.CLAUDE.mdis the Claude Code entry point: fill<PROJECT_NAME>in its heading, keep its@AGENTS.mdimport (and@memory/MEMORY.mdif you usememory/), and add only what is specific to Claude Code.Залиште розподіл ролей таким, як у kit.AGENTS.mdзберігає правила, і саме його ви правите.CLAUDE.md- точка входу для Claude Code: впишіть<PROJECT_NAME>у його заголовок, збережіть імпорт@AGENTS.md(і@memory/MEMORY.md, якщо користуєтесяmemory/) та додавайте лише те, що стосується саме Claude Code. - Уберите то, что не подходит. Удалите строки о навыках, которые вы не копировали: список в разделе 4 и любую другую строку, где такой навык назван, например
/parkв разделе 2,/ui-clarifyв разделе 8 или/surfacesв разделе 10. Удалите правило о тегах проверки в разделе 6, если ваши артефакты не оставляют следа, который можно найти grep'ом. Шапка говорит прямо: удалите любое правило, которое не применимо.Trim what does not apply. Delete the lines for skills you did not copy: the list in section 4, and any other line that names one, such as/parkin section 2,/ui-clarifyin section 8 or/surfacesin section 10. Delete the verification-tag rule in section 6 if your artifacts produce no trace you can grep. The header says it plainly: delete any rule that does not apply.Приберіть те, що не пасує. Видаліть рядки про навички, яких ви не копіювали: список у розділі 4 і будь-який інший рядок, де таку навичку названо, наприклад/parkу розділі 2,/ui-clarifyу розділі 8 або/surfacesу розділі 10. Видаліть правило про теги перевірки в розділі 6, якщо ваші артефакти не лишають сліду, який можна знайти grep'ом. Шапка каже прямо: видаліть будь-яке правило, що не застосовне. - Поддерживайте файл в рабочем виде. Когда гейт раз за разом ловит один и тот же дефект, закройте источник: добавьте соответствующий запрет в этот файл, к запрещённым шаблонам раздела 9, и подкрепите его в навыке, который этот дефект порождает. Детектор останавливает человека один раз, а агент воспроизводит шаблон при каждой генерации.Keep the file honest as you work. When a gate keeps catching the same defect, close the source: add the matching DON'T to this file, among the forbidden patterns of section 9, and reinforce it in the skill that emits the defect. A detector stops a human once, but the agent re-emits the pattern on every generation.Підтримуйте файл у робочому стані. Коли гейт раз у раз ловить той самий дефект, закрийте джерело: додайте відповідну заборону в цей файл, до заборонених шаблонів розділу 9, і підкріпіть її в навичці, що цей дефект породжує. Детектор зупиняє людину один раз, а агент відтворює шаблон під час кожної генерації.
- Прежде чем добавлять поверх kit новое правило, гейт, навык или агента, прочтите
docs/AUTHORING.md: пишите его против сбоя, который вы действительно наблюдали, назовите отговорку, которую он должен закрыть, и дайте емуdescription, начинающийся с триггера.Before you add a new rule, gate, skill or agent on top of the kit, readdocs/AUTHORING.md: author it against a failure you actually observed, name the excuse it must close, and give it a trigger-firstdescription.Перш ніж додавати поверх kit нове правило, гейт, навичку чи агента, прочитайтеdocs/AUTHORING.md: пишіть його проти збою, який ви справді спостерігали, назвіть відмовку, яку він має закрити, і дайте йомуdescription, що починається з тригера.
Что вы должны увидетьWhat you should seeЩо ви маєте побачити
AGENTS.md, где каждый плейсхолдер-настройка заполнен или его правило удалено, <CHECK_CMD>, который агент может выполнить, только те правила, что подходят проекту, и CLAUDE.md, который импортирует этот файл, а не пересказывает его.An AGENTS.md whose setting placeholders are all filled or whose rules are deleted, a <CHECK_CMD> your agent can run, only the rules that fit your project, and a CLAUDE.md that imports it instead of restating it.AGENTS.md, де кожен плейсхолдер-налаштування заповнений або його правило видалено, <CHECK_CMD>, який агент може виконати, лише ті правила, що пасують проєкту, і CLAUDE.md, який імпортує цей файл, а не переказує його.
СоветыTipsПоради
- Список навыков в разделе 4 сам ничего не маршрутизирует: самый дешёвый уровень остаётся невыбранным, пока что-то не выберет его в момент решения. Хук маршрутизации помогает лишь той части случаев, что проходит через его событие, так что сначала посчитайте её. См. как обеспечить правило хуком.The skills list in section 4 routes nothing by itself: the cheapest tier goes unchosen unless something picks it at the moment of decision. A routing hook helps only the population that passes through its event, so count that first. See enforce a rule with a hook.Список навичок у розділі 4 сам нічого не маршрутизує: найдешевший рівень лишається невибраним, доки щось не обере його в момент рішення. Хук маршрутизації допомагає лише тій частці випадків, що проходить крізь його подію, тож спершу порахуйте її. Див. як забезпечити правило хуком.
- Раздел 1 разводит языки: чат идёт на
<CHAT_LANGUAGE>, а файлы, код, документы, логи и коммиты, как и комментарии в коде, пишутся на<ARTIFACT_LANGUAGE>. Две настройки, потому что говорить и сдавать работу - разные задачи. Там же задан тон: сухо, кратко, просто, без воды и без итогового пересказа правки.Section 1 fixes the split of languages: chat in<CHAT_LANGUAGE>, while files, code, docs, logs and commits are written in<ARTIFACT_LANGUAGE>, as are code comments. Two settings, because talking and delivering are different jobs. The same section sets the tone: dry, concise, plain, with no filler and no trailing summary of the change.Розділ 1 розводить мови: чат ведеться мовою<CHAT_LANGUAGE>, а файли, код, документи, логи й коміти, як і коментарі в коді, пишуться мовою<ARTIFACT_LANGUAGE>. Два налаштування, бо говорити й здавати роботу - різні завдання. Там само задано тон: сухо, стисло, просто, без води й без підсумкового переказу правки. - Готовые значения для разных видов проектов лежат в
docs/REPLACES.md, где есть и таблица того, что переименовано с ранних копий kit. Те же плейсхолдеры встречаются в навыках и агентах под.claude/. См. справочник по плейсхолдерам.Worked values per kind of project are indocs/REPLACES.md, which also has a table of what was renamed since earlier copies of the kit. The same placeholders recur in the skills and agents under.claude/. See the placeholder reference.Готові значення для різних видів проєктів лежать уdocs/REPLACES.md, де є й таблиця того, що перейменовано з ранніх копій kit. Ті самі плейсхолдери трапляються в навичках і агентах під.claude/. Див. довідник із плейсхолдерів. - Раздел 11 велит агенту читать
memory/MEMORY.mdв начале сессии. Это закоммиченный слой, общий для команды; личные предпочтения идут в собственную память среды выполнения для каждого пользователя, и один и тот же факт не хранится в обеих. См. память агента.Section 11 has the agent readmemory/MEMORY.mdat session start. That is the committed, team-shared layer; personal preferences go to the runtime's own per-user memory, never the same fact in both. See agent memory.Розділ 11 велить агентові читатиmemory/MEMORY.mdна початку сесії. Це закомічений шар, спільний для команди; особисті вподобання йдуть у власну пам'ять середовища виконання для кожного користувача, і той самий факт не зберігається в обох. Див. пам'ять агента. - Раздел 10 - краткая форма дисциплины после правки: записывайте
expected: X | actual: Yдля каждой проверки, ничего не заявляйте без свежих доказательств, а для новой видимой возможности трогайте каждую поверхность и каждую авторскую локаль в том же изменении через/surfaces. См. как доказать, что правка работает.Section 10 is the short form of the post-change discipline: recordexpected: X | actual: Yfor every check, claim nothing without fresh evidence, and for a new user-visible capability touch every surface and every authored locale in the same change with/surfaces. See prove a change works.Розділ 10 - стисла форма дисципліни після правки: записуйтеexpected: X | actual: Yдля кожної перевірки, нічого не заявляйте без свіжих доказів, а для нової видимої можливості торкайтеся кожної поверхні й кожної авторської локалі в тій самій зміні через/surfaces. Див. як довести, що правка працює. - Что
CLAUDE.mdдобавляет для Claude Code: навыки лежат в.claude/skills/<name>/SKILL.md, агенты - в.claude/agents/, у каждого закреплён уровень модели, аclaude --agent rd-leadназначает rd-lead агентом всей сессии: это добровольный режим, он заменяет системный промпт по умолчанию. Права заданы в.claude/settings.json, где запрет Bash не является границей безопасности.WhatCLAUDE.mdadds for Claude Code: skills live in.claude/skills/<name>/SKILL.md, agents in.claude/agents/each pinned to a model tier, andclaude --agent rd-leadmakes the lead the whole session's agent, an opt-in that replaces the default system prompt. Permissions are in.claude/settings.json, where a Bash deny rule is not a security boundary.ЩоCLAUDE.mdдодає для Claude Code: навички лежать у.claude/skills/<name>/SKILL.md, агенти - у.claude/agents/, у кожного закріплено рівень моделі, аclaude --agent rd-leadпризначає rd-lead агентом усієї сесії: це добровільний режим, він замінює системний промпт за замовчуванням. Права задано в.claude/settings.json, де заборона Bash не є межею безпеки. - Заполненный фрагмент этого файла, с настройками разделов 1, 5, 7 и 8 для воображаемого проекта, лежит в папке
examples/kit только для справки. Его не копируют в проект: каждое значение в нём принадлежит тому проекту. См. разобранный пример.A filled excerpt of this file, with the settings of sections 1, 5, 7 and 8 filled in for an imaginary project, sits in the kit'sexamples/folder as reference only. It is never copied into a project, because every value in it is that project's. See the worked example.Заповнений фрагмент цього файлу, з налаштуваннями розділів 1, 5, 7 і 8 для уявного проєкту, лежить у теціexamples/kit лише для довідки. Його не копіюють у проєкт: кожне значення в ньому належить тому проєкту. Див. розібраний приклад.
Связанные функцииRelated functionsПов'язані функції
- Заполнить плейсхолдеры файла правил под свой проект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.Зіставте слова методу з вашим видом роботи, знайдіть перевірку, яка у вас уже є, і видаліть правила шару коду, яким нічого застосовувати.
- Поднять новый проект по методу 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.Один промпт піднімає новий або майже порожній проєкт за методом: файл правил, відповідні навички й ролі, робочі теки та названа перевірка.
- Написать правило, навык или агента, которые меняют поведениеWrite a rule, skill or agent that changes behaviourНаписати правило, навичку чи агента, що змінюють поведінкуПишите правило, только когда агент сбился без него: зафиксируйте сбой и оправдание, напишите минимум, закройте лазейки, а при повторе сделайте гейт.Write a rule only after an agent has failed without it: capture the failure and its excuse, write the minimal rule, close the loopholes, make it a gate if it recurs.Пишіть правило лише після того, як агент збився без нього: зафіксуйте збій і виправдання, напишіть мінімальне правило, закрийте лазівки, а за повтору переведіть у гейт.
- Изучить метод по одному законченному небольшому тикету и заполненному файлу правил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 показує один невеликий тікет у завершеному вигляді та заповнений уривок файлу правил. Лише для читання: у проєкт її не копіюють.