Universal Agent Kit. Скачать kit (.zip)Download kit (.zip)Завантажити kit (.zip)

ПрактикаPracticeПрактика Внедрение и адаптацияAdopt and adaptВпровадження й адаптація

Подогнать метод под работу, которая не кодFit the method to work that is not codeПідігнати метод під роботу, що не є кодом

kit вырос из программной работы, но предполагает всего пять вещей, и среди них нет компилятора. docs/PROJECT_SHAPES.md - таблица перевода: она говорит, что слова метода значат в работе с данными, текстами, юридической и операционной работе, какие правила переносятся без изменений, каким нужен местный аналог и какие стоит удалить.The kit was distilled from software, yet it assumes only five things and none of them is a compiler. docs/PROJECT_SHAPES.md is the translation table: it says what the method's nouns mean in data work, writing, legal work and operations, which rules carry over unchanged, which need a local equivalent and which to delete.Kit виріс із програмної роботи, але припускає лише п'ять речей, і серед них немає компілятора. docs/PROJECT_SHAPES.md - таблиця перекладу: вона каже, що слова методу означають у роботі з даними, текстами, юридичній та операційній роботі, які правила переносяться без змін, яким потрібен місцевий аналог і які варто видалити.

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

Проект из отчётов, наборов данных, документов, договоров или регламентов либо шаг после копирования kit, где вы решаете, что удалить. Читайте и для кодовой базы: та же таблица позволяет вести по методу те её части, что не код.A project made of reports, datasets, documents, contracts or runbooks, or the step after copying the kit in where you decide what to delete. Read it for a codebase too: the same table lets you run the method on the parts that are not code.Проєкт зі звітів, наборів даних, документів, договорів чи регламентів або крок після копіювання kit, де ви вирішуєте, що видалити. Читайте й для кодової бази: та сама таблиця дає змогу вести за методом ті її частини, що не є кодом.

ТребованияRequirementsВимоги

Где доступноAvailable inДе доступно
Каждая загрузка kitEvery download of the kitКожне завантаження kit
К чему обращаетсяWhat it touchesДо чого звертається
  • Читает файлы проектаReads the files of 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/PROJECT_SHAPES.md
Прежде чем начатьBefore you startПерш ніж почати

Три честных ограничения. Там, где ничего нельзя проверить механически, метод вырождается в чек-лист с хорошими манерами. Для одного сплошного документа с одним автором механика тикетов - лишняя нагрузка. Если работа не состоит из файлов, kit сказать нечего: сначала запишите её, тогда это станет проектом.Three honest limits. Where nothing can be checked mechanically, the method degrades to a checklist with good manners. For one flowing document with one author, the ticket machinery is overhead. Where the work is not files, the kit has nothing to say: write it down first, and then it is a project.Три чесні обмеження. Там, де нічого не можна перевірити механічно, метод вироджується в чекліст із гарними манерами. Для одного суцільного документа з одним автором механіка тікетів - зайве навантаження. Якщо робота не складається з файлів, kit нічого не скаже: спершу запишіть її, тоді це стане проєктом.

ШагиStepsКроки

  1. Пересчитайте пять вещей, которые предполагает метод: рабочая папка с историей, к которой можно откатиться; артефакты; единицы работы с честным статусом; проверки; агент, умеющий читать и писать ваши файлы. Если есть четыре из пяти, метод работает, а дыру вы почувствуете ровно там, где помогла бы недостающая вещь. Если три, сначала заведите четвёртую. Нет истории? Копируйте папку перед большой правкой.Count the five things the method assumes: a workspace with history you can roll back, artifacts, work items with a true status, checks, and an agent that can read and write the workspace. With four of five the method still works and you feel the gap where the missing one would have helped. With three, build the fourth first. No history? Copy the folder before a big change.Перелічіть п'ять речей, які припускає метод: робоча тека з історією, до якої можна відкотитися; артефакти; одиниці роботи з чесним статусом; перевірки; агент, що вміє читати й писати ваші файли. Якщо є чотири з п'яти, метод працює, а дірку ви відчуєте рівно там, де мала допомогти відсутня річ. Якщо три, спершу заведіть четверту. Немає історії? Копіюйте теку перед великою правкою.
  2. Найдите свой столбец в таблице словаря: софт, данные и аналитика, тексты и документация, юридическое и комплаенс, операции и админ. В нём слова метода в вашей работе: рабочая папка, артефакт, карта, дешёвая, средняя и дорогая проверка, «готово». Заполните свой столбец и держите его в репозитории. Это десять минут, и новичок или агент сможет сопоставить правило с вашей реальностью.Find your column in the vocabulary table: software, data and analysis, writing and documentation, legal and compliance, or operations and admin. It gives the method's words in your work: the workspace, an artifact, the map, a cheap, a middling and an expensive check, and 'done'. Fill in your own column and keep it in the repo. It takes ten minutes and lets a newcomer or an agent map a rule to your reality.Знайдіть свій стовпець у таблиці словника: софт, дані та аналітика, тексти й документація, юридичне та комплаєнс, операції та адмін. У ньому слова методу у вашій роботі: робоча тека, артефакт, карта, дешева, середня й дорога перевірка, «готово». Заповніть свій стовпець і тримайте його в репозиторії. Це десять хвилин, і новачок чи агент зможе зіставити правило з вашою реальністю.
  3. Найдите свою проверку, спросив себя: что было бы стыдно отправить? Каждый ответ - это проверка. Ищите сумму, которая должна сойтись с другой суммой; имя, которое должно существовать в другом месте; структуру, которая должна держаться; ссылку, которая должна разрешаться; сборку, которая должна получиться. Запишите её один раз командой или описанной процедурой и запускайте.Find your check by asking what you would be embarrassed to send. Each answer is a check. Look for a total that must match another total, a name that must exist elsewhere, a structure that must hold, a thing that must still resolve, a rendering that must succeed. Write it down once with a command or a stated procedure, then run it.Знайдіть свою перевірку, спитавши себе: що було б соромно відправити? Кожна відповідь - це перевірка. Шукайте суму, яка має зійтися з іншою сумою; ім'я, яке має існувати в іншому місці; структуру, що має триматися; посилання, що має розв'язуватися; збірку, що має вдатися. Запишіть її один раз командою або описаною процедурою й запускайте.
  4. Поставьте эту проверку в <CHECK_CMD> - единственный плейсхолдер, который обязан заполнить каждый проект. Токены слоя кода <BUILD_CMD>, <TEST_CMD>, <LINT_CMD> и <RUN_CMD> лишь уточняют его, для проектов, где эти четыре вещи различны. Все токены разобраны в разделе как заполнить плейсхолдеры.Put that check into <CHECK_CMD>, the one placeholder every project must fill. The code-layer tokens <BUILD_CMD>, <TEST_CMD>, <LINT_CMD> and <RUN_CMD> only refine it, for projects that have those four distinct things. Fill the placeholders walks through all of them.Поставте цю перевірку в <CHECK_CMD> - єдиний плейсхолдер, який мусить заповнити кожен проєкт. Токени шару коду <BUILD_CMD>, <TEST_CMD>, <LINT_CMD> і <RUN_CMD> лише уточнюють його, для проєктів, де ці чотири речі різні. Усі токени розібрано в розділі як заповнити плейсхолдери.
  5. Составьте свой список признаков мусора. docs/CODE_QUALITY.md называет приметы, которые агент выдаёт охотно, которые выглядят нормально и портят кодовую базу. Ваши зависят от ваших артефактов, например: текст, пересказывающий свой заголовок; число без источника; плейсхолдер, забытый в готовом документе; устаревшая ссылка. Собирайте список из того, что поймали на ревью, а не из воображения.Write your own quality list. docs/CODE_QUALITY.md names patterns an agent emits that look fine and rot a codebase. Yours are specific to your artifacts, for example text that restates its heading, a number with no source, a placeholder left in a finished document or a stale cross-reference. Build the list from what you caught in review, not from imagination.Складіть власний список ознак сміття. docs/CODE_QUALITY.md називає прикмети, які агент видає охоче, що виглядають нормально й псують кодову базу. Ваші залежать від ваших артефактів, наприклад: текст, що переказує свій заголовок; число без джерела; плейсхолдер, забутий у готовому документі; застаріле посилання. Збирайте список із того, що впіймали на рев'ю, а не з уяви.
  6. Превратите индекс кода в индекс вашего материала: словарь данных, библиотеку формулировок, реестр документов или таблицу источников. Три правила остаются: обращайтесь к нему до поиска, пересобирайте после изменений и замеряйте, как часто он отвечает.Turn the code index into an index of your material: a data dictionary, a clause library, a document register or a table of sources. The three rules stay the same: query it before searching, regenerate it after you change things, and measure how often it answers.Перетворіть індекс коду на індекс вашого матеріалу: словник даних, бібліотеку формулювань, реєстр документів чи таблицю джерел. Три правила лишаються: звертайтеся до нього до пошуку, перезбирайте після змін і міряйте, як часто він відповідає.
  7. Удалите то, чему нечего применять. Слои и направление зависимостей (<ARCH_LAYERS>), тонкие точки входа, фасад логирования (<LOGGER>), метки верификации (если ваши артефакты не выдают журнал, по которому можно искать) и ступень компиляции в лестнице уходят. Ваша лестница просто начинается со следующей ступени.Delete what has no subject. Layering and dependency direction (<ARCH_LAYERS>), thin entry points, the logging facade (<LOGGER>), verification tags unless your artifacts produce a log you can grep, and the compile rung of the ladder all go. Your ladder simply starts at the next rung up.Видаліть те, чому нічого застосовувати. Шари й напрям залежностей (<ARCH_LAYERS>), тонкі точки входу, фасад логування (<LOGGER>), мітки верифікації (якщо ваші артефакти не дають журналу, по якому можна шукати) і щабель компіляції в драбині йдуть. Ваша драбина просто починається з наступного щабля.
  8. Если у проекта несколько форм, не плодите своды правил. Держите один и позволяйте командам проверки различаться по областям, как docs/VALIDATION.md ограничивает проверку видом изменения.If the project has several shapes, do not fork the rulebook. Keep one and let the check commands differ by area, the way docs/VALIDATION.md scopes a gate by the kind of change.Якщо в проєкту кілька форм, не плодіть зводи правил. Тримайте один і дозволяйте командам перевірки відрізнятися за ділянками, як docs/VALIDATION.md обмежує перевірку видом зміни.
Что вы должны увидетьWhat you should seeЩо ви маєте побачити

Ваш столбец таблицы словаря лежит в репозитории, самая дешёвая настоящая проверка названа в <CHECK_CMD>, а правила слоя кода, которым нечего применять в вашем проекте, удалены, а не приспособлены.Your own column of the vocabulary table is kept in the repo, the cheapest real check is named in <CHECK_CMD>, and the code-layer rules that have no subject in your project are deleted rather than adapted.Ваш стовпець таблиці словника лежить у репозиторії, найдешевшу справжню перевірку названо в <CHECK_CMD>, а правила шару коду, яким нічого застосовувати у вашому проєкті, видалено, а не пристосовано.

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

  • В любом столбце верхняя ступень лестницы обычно за человеком. Это нормальный случай, а не слабость: проверка человеком, которой ещё не было, - не зачёт, а ожидание. См. как доказать правку самой низкой подходящей ступенью.In every column the top rung of the ladder is usually a human. That is the normal case, not a weakness: a human check that has not happened yet is not a pass, it is a pending one. See prove a change with the lowest rung that fits.У будь-якому стовпці верхній щабель драбини зазвичай за людиною. Це нормальний випадок, а не слабкість: перевірка людиною, якої ще не було, - не залік, а очікування. Див. як довести правку найнижчим відповідним щаблем.
  • Зачем записывать проверку: в эталонном корпусе kit правило с механической проверкой за спиной выполнялось примерно в 99% случаев, то же правило прозой - в 1-8%. Этой цифре всё равно, из чего сделаны ваши артефакты.Why write the check down: in the kit's reference corpus a directive with a mechanical check behind it was followed about 99% of the time, the same directive as prose 1-8%. The figure does not care what your artifacts are made of.Навіщо записувати перевірку: в еталонному корпусі kit правило з механічною перевіркою за спиною виконувалося приблизно у 99% випадків, те саме правило прозою - в 1-8%. Цій цифрі байдуже, з чого зроблені ваші артефакти.
  • Без перевода переносятся в любой столбец: исследование перед действием, разделение «что» и «как», проверяемые фазы, статус из реальности, доказательства вместо рассказов, память между сессиями, учёт расходов и fan-out, параллельная работа над общими файлами и правило, написанное против замеченного сбоя.These carry over unchanged in every column: research before acting, splitting what from how, verifiable phases, status that comes from reality, evidence instead of narration, memory across sessions, cost and fan-out, parallel work on shared files, and authoring a rule against an observed failure.Без перекладу переносяться в будь-який стовпець: дослідження перед дією, розділення «що» і «як», перевірні фази, статус із реальності, докази замість розповідей, пам'ять між сесіями, облік витрат і fan-out, паралельна робота над спільними файлами та правило, написане проти поміченого збою.

Термины на этой страницеTerms on this pageТерміни на цій сторінці

Поиск по порталуSearch the portalПошук по порталу