From a59f09e2f0ac2cf01ec767c5f51586f0bf1c33d0 Mon Sep 17 00:00:00 2001 From: DCCONSTRUCTIONS Date: Sat, 18 Apr 2026 20:04:24 +0300 Subject: [PATCH] =?UTF-8?q?=D0=90=D0=A0=D0=A5=20-=20=D0=9C=D0=95=D0=96?= =?UTF-8?q?=D0=9F=D0=A0=D0=9E=D0=95=D0=9A=D0=A2=D0=9D=D0=90=D0=AF=20=D0=9A?= =?UTF-8?q?=D0=9E=D0=9C=D0=9C=D0=A3=D0=9D=D0=98=D0=9A=D0=90=D0=A6=D0=98?= =?UTF-8?q?=D0=AF:=20=D1=80=D0=B5=D0=B3=D0=BB=D0=B0=D0=BC=D0=B5=D0=BD?= =?UTF-8?q?=D1=82=20=D1=8D=D1=82=D0=B0=D0=BF=D0=BE=D0=B2=20=D0=B8=20=D0=B8?= =?UTF-8?q?=D0=BC=D0=B5=D0=BD=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D1=8F=20=D0=BA?= =?UTF-8?q?=D0=BE=D0=BC=D0=BC=D0=B8=D1=82=D0=BE=D0=B2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 70 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 70 insertions(+) create mode 100644 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..88cf988 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,70 @@ +# Правила работы агента + +## Общий принцип + +Работа ведется этапами. + +После завершения каждого смыслового этапа агент: +- кратко фиксирует, что сделано +- предлагает пользователю название коммита +- ждет явного подтверждения на коммит +- только после подтверждения выполняет `git commit` + +Коммиты не должны идти бессистемным потоком. + +Каждый коммит должен визуально читаться по заголовку и сразу показывать: +- какой это слой изменений +- к какому направлению относится этап +- что именно сделано на этом этапе + +## Формат названия коммита + +Формат: + +```text +<ТИП> - МЕЖПРОЕКТНАЯ КОММУНИКАЦИЯ: <НАЗВАНИЕ ЭТАПА> +``` + +## Типы коммитов + +Использовать верхний уровень по смыслу изменений: + +- `UI` — если изменения в интерфейсе, текстах, навигации, отображении, UX +- `ФУНКЦИИ` — если изменения в прикладной логике, API, действиях, синхронизации, обработчиках +- `АРХ` — если изменения в архитектуре, структуре данных, инфраструктурных правилах, каркасе реализации + +Если этап затрагивает несколько слоев, выбирать доминирующий. + +## Правило предложения коммита + +После каждого завершенного этапа агент должен предлагать пользователю готовое название коммита. + +Пример: + +```text +UI - МЕЖПРОЕКТНАЯ КОММУНИКАЦИЯ: переименование модуля во внутренний контур +``` + +Пользователь отвечает подтверждением в духе: +- `коммитить` +- `да, коммить` +- `ок, коммит` + +Только после этого агент делает коммит. + +## Примеры + +```text +UI - МЕЖПРОЕКТНАЯ КОММУНИКАЦИЯ: переименование модуля во внутренний контур +ФУНКЦИИ - МЕЖПРОЕКТНАЯ КОММУНИКАЦИЯ: создание запроса в целевой проект +ФУНКЦИИ - МЕЖПРОЕКТНАЯ КОММУНИКАЦИЯ: синхронизация статусов источника и цели +АРХ - МЕЖПРОЕКТНАЯ КОММУНИКАЦИЯ: каркас source-target связи +АРХ - МЕЖПРОЕКТНАЯ КОММУНИКАЦИЯ: регламент этапов и именования коммитов +``` + +## Дополнение + +Если пользователем не сказано иное: +- не делать `amend` +- не переписывать историю +- не объединять несколько отдельных этапов в один коммит постфактум