Когда это нужноWhen to reach for itКоли це потрібно
Нетривиальная работа, которая проходит через исследование, планирование, выполнение и ревью: функциональность, реструктуризация, отчёт, пересмотр контракта, весь жизненный цикл тикета или ревью.Non-trivial work that crosses research, planning, doing and review: a feature, a restructuring, a report, a contract revision, a ticket's whole lifecycle or a review.Нетривіальна робота, що проходить крізь дослідження, планування, виконання та рев'ю: функціональність, реструктуризація, звіт, перегляд контракту, весь життєвий цикл тікета або рев'ю.
Требования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)
- Запускает вспомогательных агентовStarts helper agentsЗапускає допоміжних агентів
- Работает сWorks withПрацює з
- Сделано для Claude Code; другие агенты адаптируютBuilt for Claude Code; other agents adapt itЗроблено для Claude Code; інші агенти адаптують
- Где выполняются шаги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
.claude/agents/rd-lead.md
Прежде чем начатьBefore you startПерш ніж почати
Параллельные читатели безопасны, пишущие - нет: непересекающиеся файлы - не изоляция, а команда контроля версий над всем деревом у одного писателя может откатить чужие несохранённые правки. rd-lead берёт на себя такие команды, сборку и индекс между волнами либо даёт каждому писателю свой checkout. Если файлы откатились, сначала перечитайте диск. См. параллельную запись.Parallel readers are safe, parallel writers are not: disjoint files are not isolation, and one writer's whole-tree version-control command can revert the others' uncommitted work. rd-lead owns those commands, and build and index ones, between waves, or gives each writer its own checkout. If files keep reverting, re-read from disk first. See parallel writers.Паралельні читачі безпечні, ті, що пишуть, - ні: непересічні файли - не ізоляція, а команда контролю версій над усім деревом в одного з них може відкотити чужі незбережені правки. rd-lead бере на себе такі команди, збірку та індекс між хвилями або дає кожному, хто пише, власний checkout. Якщо файли відкотилися, спершу перечитайте диск. Див. паралельний запис.
ШагиStepsКроки
- Сначала убедитесь, что заполнители в файле агента (название проекта, язык чата, язык артефактов, логгер, слои архитектуры, лимит размера, каталог планов, каталог для черновиков, зоны только для чтения) заполнены под ваш проект.First make sure the placeholders in its file (project name, chat language, artifact language, logger, architecture layers, size budget, plan directory, scratch directory, read-only zones) are filled in for your project.Спершу переконайтеся, що заповнювачі у файлі агента (назва проєкту, мова чату, мова артефактів, логер, шари архітектури, ліміт розміру, каталог планів, каталог для чернеток, зони лише для читання) заповнені під ваш проєкт.
- Выберите, как его использовать. Он доступен как субагент на выбор. Чтобы сделать его агентом всей сессии, запустите Claude Code как
claude --agent rd-lead: это заменяет системный промпт Claude Code по умолчанию его инструкцией, и каждый ход идёт на сильном уровне. Включается только по вашему решению, поэтомуsettings.jsonиз kit его не задаёт.Choose how to use it. It is a selectable subagent. To make it the whole session's agent, start Claude Code withclaude --agent rd-lead: that replaces Claude Code's default system prompt with its brief and runs every turn on the strong tier. It is an opt-in, which is why the kit'ssettings.jsondoes not set it.Оберіть, як його використовувати. Він доступний як субагент на вибір. Щоб зробити його агентом усієї сесії, запустіть Claude Code якclaude --agent rd-lead: це замінює типовий системний промпт Claude Code його інструкцією, і кожен хід іде на сильному рівні. Вмикається лише з вашого рішення, томуsettings.jsonіз kit його не задає. - Опишите задачу так, как поставили бы её коллеге: функциональность, реструктуризация, отчёт, тикет, который надо продвинуть, или изменение на ревью. Сначала он классифицирует запрос: мелкая правка уходит в
/quick, узкий и понятный баг - в/fix, а всё, где есть дизайн-решения или новые абстракции, - в конвейер спек. Разрешения читать, искать, собирать и проверять он не спрашивает.Describe the job as you would to a colleague: a feature, a restructuring, a report, a ticket to advance or a change to review. It classifies the request first: a trivial edit goes to/quick, a narrow and well-understood bug to/fix, and anything with design decisions or new abstractions into the spec pipeline. It does not ask permission to read, search, build or check.Опишіть завдання так, як поставили б його колезі: функціональність, реструктуризація, звіт, тікет, який треба просунути, або зміна на рев'ю. Спершу він класифікує запит: дрібна правка йде в/quick, вузький і зрозумілий баг - у/fix, а все, де є дизайн-рішення чи нові абстракції, - у конвеєр спек. Дозволу читати, шукати, збирати й перевіряти він не питає. - Он исследует, прежде чем действовать: сначала карта репозитория, затем спека или план, затем поиск символов через grep или ваш индекс кода, и только потом сам код. Если причина или картина неясны, он запускает
/researchи сохраняет находки для работы по тикету. Путь, символ или API он не выдумывает.It researches before it acts: the repo map first, then the spec or plan, then a symbol search with grep or your code index, then the code itself. When the cause or the landscape is unclear it runs/researchand saves the findings for ticket-bound work. It never guesses a path, a symbol or an API.Він досліджує, перш ніж діяти: спершу карта репозиторію, потім спека чи план, потім пошук символів через grep або ваш індекс коду, і лише тоді сам код. Якщо причина чи картина неясні, він запускає/researchі зберігає знахідки для роботи за тікетом. Шлях, символ чи API він не вигадує. - Прежде чем строить то, что увидит пользователь, он снимает неоднозначность через
/ui-clarify. К вам он выносит только решения, меняющие поведение, данные или структуру; неясное место, видимость или запасной вариант он обсуждает с вами, а не угадывает.Before building anything a user perceives, it resolves the ambiguity with/ui-clarify. It brings you only the decisions that change behaviour, data or structure; unclear placement, visibility or fallback is raised with you, not guessed.Перш ніж будувати те, що побачить користувач, він знімає неоднозначність через/ui-clarify. До вас він виносить лише рішення, що змінюють поведінку, дані чи структуру; незрозуміле місце, видимість чи запасний варіант він обговорює з вами, а не вгадує. - Для функциональности и существенных изменений он проходит конвейер
/spec,/spec-tech,/spec-dev,/spec-check: сначала стратегические решения (проблема, цели, ограничения), потом тактические (файлы, сигнатуры, порядок). Каждый шаг плана заканчивается статической проверкой, а не расплывчатым «работает правильно».For features and substantial changes it works the pipeline/spec,/spec-tech,/spec-dev,/spec-check: strategic decisions (problem, goals, constraints) first, tactical ones (files, signatures, order) after. Every planned step ends in a static check, never in a vague "works correctly".Для функціональності та суттєвих змін він проходить конвеєр/spec,/spec-tech,/spec-dev,/spec-check: спершу стратегічні рішення (проблема, цілі, обмеження), потім тактичні (файли, сигнатури, порядок). Кожен крок плану завершується статичною перевіркою, а не розпливчастим «працює правильно». - Он передаёт работу там, где это окупается, агентам solution-researcher, implementer и doc-writer. Перед волной веерного запуска он оценивает число агентов и стоимость, держит малый потолок, просит явного «добро» сверх него, сначала ищет и лишь потом проверяет. Вернувшийся отчёт - лишь утверждение: он перепроверяет его из собственного чистого состояния и сам доделывает последнюю фазу, если её обрезали.It delegates where that pays, to solution-researcher, implementer and doc-writer. Before a fan-out wave it estimates agent count and cost, keeps a small ceiling, asks for an explicit GO above it and finds first, verifies second. A returned report is a claim: it re-validates from its own clean state and finishes any truncated trailing phase itself.Він передає роботу там, де це окупається, агентам solution-researcher, implementer та doc-writer. Перед хвилею віяльного запуску він оцінює кількість агентів і вартість, тримає малу стелю, просить явного «добро» понад нею, спершу шукає й лише потім перевіряє. Повернутий звіт - лише твердження: він перевіряє його з власного чистого стану й сам доробляє останню фазу, якщо її обрізали.
- Свои и входящие изменения он смотрит через
/critique: сначала корректность, пути ошибок и безопасность ресурсов, затем безопасность, дисциплина слоёв, покрытие тестами, приёмы из правил против мусора и качество комментариев. Там, где важно поведение, он запускает/prove. Проверка заканчивается как pass, defect, could not verify или not applicable, и последние два результата никогда не выдаются за первые два.It reviews its own and incoming changes with/critique: correctness, error paths and resource safety first, then security, layer discipline, test coverage, anti-slop patterns and comment quality. Where behaviour matters it runs/prove. A check ends as pass, defect, could not verify or not applicable, and the last two are never reported as the first two.Свої та вхідні зміни він дивиться через/critique: спершу коректність, шляхи помилок і безпека ресурсів, далі безпека, дисципліна шарів, покриття тестами, прийоми з правил проти сміття та якість коментарів. Там, де важлива поведінка, він запускає/prove. Перевірка закінчується як pass, defect, could not verify або not applicable, і останні два результати ніколи не видають за перші два.
Что вы должны увидетьWhat you should seeЩо ви маєте побачити
Запрос доведён до проверенной работы самым лёгким подходящим путём. Каждый заявленный результат агент проверил сам, каждая проверка названа как pass, defect, could not verify или not applicable, а спрашивали вас только о решениях, которые меняют поведение, данные или структуру.The request is carried to verified work by the lightest path that fits. Each claimed deliverable has been checked by the agent itself, every check is reported as pass, defect, could not verify or not applicable, and you were asked only about decisions that change behaviour, data or structure.Запит доведено до перевіреної роботи найлегшим придатним шляхом. Кожен заявлений результат агент перевірив сам, кожну перевірку названо як pass, defect, could not verify або not applicable, а питали вас лише про рішення, що змінюють поведінку, дані чи структуру.
СоветыTipsПоради
- Берите более узкого агента, если задача чисто исследовательская (solution-researcher), это полностью описанное изменение (implementer) или текст (doc-writer). Так сказано в описании самого агента.Prefer a narrower agent when the task is purely investigative (solution-researcher), a fully specified change (implementer) or prose (doc-writer). The agent's own description says so.Беріть вужчого агента, якщо завдання суто дослідницьке (solution-researcher), це повністю описана зміна (implementer) або текст (doc-writer). Так сказано в описі самого агента.
- Для мелкой работы этот агент не нужен:
/quickзакрывает мелкую правку,/fix- узкий баг, а/specокупается только при настоящих дизайн-решениях. Самrd-leadсначала выбирает более дешёвый путь.Small work does not need this agent:/quickcovers a trivial edit and/fixa narrow bug, and/speconly pays when real design decisions exist.rd-leaditself picks the cheaper route first.Для дрібної роботи цей агент не потрібен:/quickзакриває дрібну правку,/fix- вузький баг, а/specокупається лише за справжніх дизайн-рішень. Самrd-leadспершу обирає дешевший шлях. - Объёмные доказательства уходят одноразовому субагенту, который возвращает только короткий вердикт, так что артефакты не оседают в контексте ведущего. Прежде чем действовать по находке, он отдаёт скептику её дословную формулировку, а при расколе голосов читает материал сам. Правила расходов: стоимость и веерный запуск.Bulky evidence goes to a throwaway subagent that returns only a compact verdict, so the artifacts stay out of the lead's context. Before acting on a finding it hands a skeptic the verbatim claim, and on a split vote it reads the material itself. Cost rules: cost and fan-out.Об'ємні докази йдуть одноразовому субагентові, який повертає лише короткий вердикт, тож артефакти не осідають у контексті ведучого. Перш ніж діяти за знахідкою, він віддає скептикові її дослівне формулювання, а за розколу голосів читає матеріал сам. Правила витрат: вартість і віяльний запуск.
- Он не запускает проверку, забывая про её вердикт, и не опрашивает её по кругу. Он ждёт условия, о котором может просигналить среда выполнения, либо просит работу записать вердикт в файл-маркер и одной строкой говорит, чего ждёт.It never fires off a check and forgets its verdict, and it never polls for one. It waits on a condition the runtime can signal, or has the work write its verdict to a marker file, and says in one line what it is waiting for.Він не запускає перевірку, забуваючи про її вердикт, і не опитує її по колу. Він чекає на умову, про яку може просигналити середовище виконання, або просить роботу записати вердикт у файл-маркер і одним рядком каже, чого чекає.
- Чат идёт на языке, который вы задали в заполнителе языка чата; файлы, код, документы, логи и коммиты - на языке из заполнителя языка артефактов. В работе по тикету он читает заголовок
**Status:**и никогда не выводит статус из имени файла.Chat runs in the language you set in the chat-language placeholder; files, code, docs, logs and commits in the one you set in the artifact-language placeholder. On ticket work it reads the**Status:**header and never infers status from the filename.Чат іде мовою, яку ви задали в заповнювачі мови чату; файли, код, документи, логи й коміти - мовою із заповнювача мови артефактів. У роботі за тікетом він читає заголовок**Status:**і ніколи не виводить статус з імені файлу. - Если ваша среда поддерживает постоянную память агента, он записывает только неочевидное и долговечное, но не то, что и так видно в репозитории или в
git log. См. память агента.If your runtime supports persistent agent memory, it records only what is non-obvious and durable, never what the repo orgit logalready shows. See agent memory.Якщо ваше середовище підтримує постійну пам'ять агента, він записує лише неочевидне й довговічне, але не те, що й так видно в репозиторії чи вgit log. Див. пам'ять агента.
Связанные функцииRelated functionsПов'язані функції
- Разобраться, как что-то устроено, прежде чем писать спекуInvestigate how something works before you write a specЗ'ясувати, як щось працює, перш ніж писати спекуАгент только для чтения собирает файлы, приёмы, ограничения и риски области и возвращает отчёт с доказательствами. Он ничего не правит.A read-only agent maps the files, patterns, constraints and risks of an area and returns an evidence-based report. It edits nothing.Агент лише для читання збирає файли, прийоми, обмеження та ризики галузі й повертає звіт із доказами. Він нічого не правит.
- Поручить запланированную работу исполнителю, который держится планаHave a planned change built exactly as the plan saysДоручити заплановану роботу виконавцю, що тримається плануИсполнитель среднего уровня выполняет шаг плана, исправление с известной причиной или тесты по структуре проекта и отчитывается:
expected | actual.A mid-tier maker executes a plan step, a fix with a known cause or tests in your project's structure, and reports each check asexpected | actual.Виконавець середнього рівня виконує крок плану, виправлення з відомою причиною чи тести за структурою проєкту й звітує:expected | actual. - Превратить технические заметки в понятные, дружелюбные доки и тексты интерфейсаTurn technical notes into clear, friendly docs and UI copyПеретворити технічні нотатки на зрозумілі, дружні доки й тексти інтерфейсуАгент среднего уровня пишет и переписывает документацию, README, справку, онбординг, заметки к релизу и тексты интерфейса дружелюбно, сохраняя технические факты.A mid-tier agent writes or rewrites docs, README, help, onboarding, release notes and interface strings in a friendly voice, with every technical fact kept.Агент середнього рівня пише чи переписує документацію, README, довідку, онбординг, нотатки до релізу та рядки інтерфейсу дружнім тоном, зберігаючи всі технічні факти.
- Провести тикет по жизненному циклу с проверкой на каждом шагеMove a ticket through the lifecycle with a gate at every stepПровести тікет життєвим циклом із перевіркою на кожному кроціТикет - это один Markdown-файл со строкой статуса. Каждый навык требует входной статус и выдаёт выходной, поэтому этап нельзя пропустить на глаз.A ticket is one Markdown file with a status line. Each skill requires an entry status and produces an exit status, so no stage is skipped on a hunch.Тікет - це один Markdown-файл із рядком статусу. Кожна навичка вимагає вхідний статус і видає вихідний, тож етап не можна пропустити на око.
- Запустить нескольких пишущих агентов, не потеряв работуRun several writing agents without losing workЗапустити кількох агентів, що пишуть, не втративши роботиДайте каждому пишущему агенту свою рабочую копию или отдайте команды над всем деревом одному владельцу, чтобы stash, reset или checkout не стёрли молча чужие правки.Give each writing agent its own checkout, or give one owner the tree-wide commands, so no stash, reset or checkout silently erases another agent's edits.Дайте кожному агентові, що пише, власну робочу копію або віддайте команди над усім деревом одному власникові, щоб stash, reset чи checkout не стерли мовчки чужі правки.