Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions .agents/skills/aek-parallel-work/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
---
name: aek-parallel-work
description: "Coordinate multiple agents on independent subtasks with clear ownership and integrated validation. Use for parallel implementation or independent investigation and review; skip small or tightly coupled tasks."
---

# Координация нескольких агентов

Используй доступные средства делегирования в пределах полномочий задачи. До запуска оцени независимость частей и ожидаемую пользу с учётом передачи контекста, проверки и объединения. Если работа мала, тесно связана или делегирование недоступно, выполни её последовательно. Подключение навыка не требует запуска агентов, установки инструментов или изменения настроек.

- **За общий результат отвечает один координатор.** Основной агент держит цель, границы и краткий план, распределяет работу, разрешает противоречия и принимает результат. Число исполнителей выбирай по независимым задачам и доступным ресурсам; не назначай фиксированные модели и роли без необходимости. Исполнитель не создаёт новых агентов без решения координатора.
- **У каждой подзадачи есть проверяемый договор.** Передай цель, нужный контекст и исходное состояние, разрешённые файлы или ресурсы, зависимости, критерии готовности и способ проверки. Явно различай исследование только для чтения и разрешение на правки. Делегирование не расширяет полномочия на commit, публикацию, данные и внешние действия. При общей среде сообщи исполнителям, что чужие изменения нельзя откатывать.
- **Параллельная запись имеет границы.** Для независимых правок используй отдельные worktree либо непересекающиеся области с явным владельцем. Общие файлы и операции Git в одном checkout оставь одному ответственному; зависимую работу начинай после согласования нужного контракта. Worktree не изолирует базы данных, порты, секреты и внешние сервисы: раздели используемые ресурсы либо выполняй затрагивающие их действия последовательно. При конфликте границ останови конфликтующие записи и уточни разделение.
- **Передача результата завершает владение работой.** Исполнитель возвращает выводы или изменения с указанием их расположения, выполненные проверки, ограничения и блокеры. При блокере он не расширяет задачу самостоятельно. До передачи области другому исполнителю или интеграции убедись, что прежний исполнитель больше её не меняет. Используй доступные уведомления и ожидание вместо частого опроса; при смене цели сообщи об этом затронутым исполнителям.
- **Объединённый результат проверяет координатор.** Изучи фактические изменения и доказательства проверок, разреши расхождения с требованиями и проверь взаимодействие частей после объединения. Отчёт исполнителя и зелёные отдельные тесты не подтверждают общий сценарий. Принятые проверки повторяй только при изменении проверяемого состояния, новом риске или противоречащем результате. Если часть работы не проверена, назови её явно.

Не добавляй отдельный планировщик, обязательные отчёты или постоянную документацию ради делегирования. Не обещай ускорение и экономию без измерений: качество результата, время, расход токенов и вмешательства пользователя оценивай отдельно, а недоступные показатели оставляй неизвестными.
3 changes: 2 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Agent Engineering Kit

Engineering guidelines for Codex: short everyday instructions and focused skills for data safety, code changes, and user interfaces.
Engineering guidelines for Codex: short everyday instructions and focused skills for data safety, code changes, user interfaces, and parallel agent work.

## Get started

Expand All @@ -18,6 +18,7 @@ The instructions are written in Russian. Adapt them to your language and project
| [aek-data-safety](.agents/skills/aek-data-safety/SKILL.md) | Storage, import/export, migrations, sync, retries, and recovery. |
| [aek-change-safety](.agents/skills/aek-change-safety/SKILL.md) | Module boundaries, public contracts, behavior replacement or removal, and recurring defects. |
| [aek-user-interface](.agents/skills/aek-user-interface/SKILL.md) | New or substantial GUI changes, user flows, action states, and layout. |
| [aek-parallel-work](.agents/skills/aek-parallel-work/SKILL.md) | Independent subtasks, agent ownership, and validation after integration; skip small or tightly coupled work. |

Codex reads global and project `AGENTS.md` instructions at the start of a session. It first sees skill names and descriptions, then reads a skill's full instructions when it selects that skill. A link alone does not load a file. Automatic skill selection is not guaranteed: select a skill in the app or name it explicitly, for example `$aek-data-safety Change the export format`. Skills keep project-specific formats and decisions in the project; they do not replace them. See the official [AGENTS.md guide](https://learn.chatgpt.com/docs/agent-configuration/agents-md) and [skills guide](https://learn.chatgpt.com/docs/build-skills).

Expand Down
1 change: 1 addition & 0 deletions personal/AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,5 +5,6 @@
- При создании интерфейса выбирай композицию по задачам пользователя и особенностям продукта. Используй привычные элементы, когда они уместны, без механического повторения шаблона. Сохраняй существующую визуальную систему, если нет оснований её менять.
- Не создавай документы, процессы и инфраструктуру без конкретной пользы. До значимого изменения читай действующие решения затронутой области, а не всю историю проекта. Изменённое долгосрочное решение кратко сохраняй в одном существующем подходящем месте: что выбрано, зачем и где смотреть. Проектные особенности не превращай в общие правила; временное исследование не становится постоянной документацией. Приватному контексту нужен доступный и восстанавливаемый источник: одно игнорирование в Git его не защищает.
- Обратимые локальные решения принимай самостоятельно. Уточняй выбор, если он существенно меняет результат, данные, совместимость или стоимость поддержки. Выполни задачу, проверь результат и остановись; не расширяй её до незапрошенного аудита или рефакторинга.
- До значимого изменения определи ожидаемый результат, границы задачи и способ проверки по требованиям и действующим контрактам. Для многошаговой работы держи краткий актуальный план; отдельный документ нужен только тогда, когда помогает продолжению или передаче задачи.
- Сохраняй чужие незакоммиченные изменения, приватный контекст и файлы с неизвестным назначением. Самостоятельно очищай только созданные тобой для текущей задачи воспроизводимые временные файлы и результаты сборки, проверив состав и границы удаления. Commit, push, merge, публикация, удаление пользовательских или уникальных данных и другие внешние или труднообратимые действия требуют явных полномочий. Для удаления значимых данных и миграций нужна проверенная возможность восстановления. Массовая очистка непроверенных каталогов не разрешена.
- Отличай проверенные факты от предположений. Кратко сообщай результат и существенные ограничения проверки; не выдавай подготовку или локальный тест за подтверждённую работу в реальной среде.
1 change: 1 addition & 0 deletions scripts/check.py
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@
".agents/skills/aek-data-safety/SKILL.md",
".agents/skills/aek-change-safety/SKILL.md",
".agents/skills/aek-user-interface/SKILL.md",
".agents/skills/aek-parallel-work/SKILL.md",
)


Expand Down
Loading