AIKraft Agents

Gentleman-Programming/gentle-ai

Gentle-AI настраивает AI coding agents, которые вы уже используете: Claude Code, Cursor, OpenCode, Codex, Pi и другие. Выберите постоянную память, Spec-Driven Development, кураторские навыки, MCP-серверы, персоны и опциональный ограниченный обзор. Открытый исходный код, без привязки к конкретному ag

Агенты⭐ 8 440Goпоследний релиз: v4.3.1
Открыть на GitHub ↗Сайт проекта ↗

Что это за инструмент

Gentle-AI — это инструмент-конфигуратор, который настраивает уже установленные AI-агенты для написания кода (Claude Code, Cursor, OpenCode, Codex, Pi), превращая их из разовых чат-ботов в полноценную инженерную среду.

Зачем нужен

Решает проблему отсутствия контекста и памяти у AI-агентов между сессиями. Инструмент добавляет постоянную память, систему навыков, маршрутизацию моделей и опциональную проверку результатов, обеспечивая согласованное поведение агентов на разных машинах и в разных проектах.

Что можно реализовать

  • Настройка Claude Code или Cursor для работы с сохранением контекста и решений между перезапусками сессий.
  • Внедрение единых стандартов и «персон» для AI-агентов в команде для обеспечения консистентности кода.
  • Использование Spec-Driven Development (SDD) для структурированного планирования задач перед написанием кода.
  • Интеграция MCP-серверов и кастомных навыков в существующие среды разработки без замены самого агента.

Ключевые возможности

  • Поддержка множества агентов: Claude Code, Cursor, OpenCode, Codex, Pi и других.
  • Engram™ — система персистентной памяти, сохраняющая контекст и решения между сессиями.
  • Spec-Driven Development (SDD) и Receipt-Driven Development (RDD) для контроля качества и верификации изменений.
  • Отсутствие блокировки вендора (no agent lock-in): инструмент только конфигурирует, но не устанавливает агенты.
  • Кроссплатформенность: поддержка macOS, Linux и Windows.

👤 Кому подойдёт: Разработчики, ежедневно использующие AI-кодинговые агенты, и команды, стремящиеся к стандартизации поведения AI в процессе разработки.

Релизы

v4.3.1minor
🕐 9 дн назад · релиз на GitHub ↗

Gentle Shell v4.3.1: установка и обновления с сохранением состояния на Linux, macOS и Windows, новый адаптер GitHub Copilot CLI.

  • Added: Gentle Shell теперь устанавливается, управляется и обновляется через TUI на Linux, macOS и Windows с сохранением состояния оператора.
  • Added: В каталог агентов добавлен адаптер для GitHub Copilot CLI.
  • Added: Подтверждение ревью теперь продвигает проверенную границу, начиная следующее ревью с этой точки.
  • Fixed: Исправлена регрессия обновления на Windows, из-за которой существующие установки Gentle Shell могли скрываться.
v4.2.0minor
🕐 21 дн назад · релиз на GitHub ↗

v4.2.0: маршрутизация Gentle Shell в провайдере, коммиты по слайсам, фиксы Windows и условных делегирований.

  • Added: Блок маршрутизации Gentle Shell (ODD) включен в контракт провайдера v1.4.0 как единый источник для workflow Pi.
  • Added: Внедрена практика коммитов по обзорным слайсам (~400 строк) и удержание мелких задач в инлайне без делегирования.
  • Fixed: Триггеры делегирования теперь работают только по именованным условиям, а независимый верификатор запускается только для рискованных задач.
  • Fixed: Исправлена работа режима review на Windows: устранены ошибки на SMB-шарах и при использовании длинных локальных путей.
  • Fixed: Устранено попадание артефактов CodeGraph и тестовых черновиков в доставляемые диффы, а также улучшены сообщения об отказе транспорта.
v4.1.1patch
🕐 25 дн назад · релиз на GitHub ↗

Hotfix v4.1.1: исправление рассинхрона сумм Go-модуля, код идентичен v4.1.0.

  • Fixed: Исправлена ошибка проверки контрольных сумм при установке напрямую с GitHub.
  • Fixed: Релиз v4.1.1 привязан к тому же коммиту, что и v4.1.0, обеспечивая согласованность данных.
  • Новых функций и изменений интерфейса не добавлено.
  • Контракт провайдера сохранен на уровне 1.3.0, ломающих изменений нет.
v4.1.0minorbreaking
🕐 25 дн назад · релиз на GitHub ↗

Пропорциональный ревью, делегирование оркестратора, установка Gentle Shell и отключение внешних плагинов OpenCode.

  • Added: Ревью теперь пропорционально риску: автоматический запуск только для high-risk изменений, агент выбирает линзы.
  • Added: Оркестратор делегирует задачи по обоснованным причинам, а не только из-за их размера.
  • Added: Появились кандидаты на установку Gentle Shell для Linux, Windows 11 и macOS.
  • Added: Добавлен опциональный режим установки оркестратора Claude Code с изолированными модулями.
  • Deprecated: Полностью удалена поддержка установки внешних плагинов сообщества для OpenCode.
  • Fixed: Обновлен контракт провайдера до 1.3.0, восстановлена работоспособность Windows Full Suite.
v4.0.0majorbreaking
🕐 1 мес назад · релиз на GitHub ↗

Gentle AI v4.0.0: переход на ODD, модуль /v4, OpenCode V2 и исправление Windows.

  • Breaking: SDD и OpenSpec удалены, единственным рабочим процессом стал ODD.
  • Breaking: Путь Go-модуля изменён на /v4, что требует обновления зависимостей.
  • Added: OpenCode V2 получил поддержку плагинов, SDK и нативный ревью.
  • Added: Pi теперь использует встроенную поддержку MCP.
  • Fixed: Windows Full Suite успешно прошёл все проверки.
v3.7.0minor
🕐 1 мес назад · релиз на GitHub ↗

v3.7.0: настройка моделей агентов и ревьюеров в Claude Code, OpenCode и Codex; исправление конфликтов блокировок.

  • Added: Добавлена настройка нативных моделей агентов и ревьюеров для Claude Code, OpenCode и Codex, включая поддержку GPT-6.
  • Fixed: Исправлено поведение при конфликтах блокировок: точное воспроизведение результатов теперь корректно сходитесь, а не выдает ложный таймаут.
  • Added: Улучшена работа выбора моделей в Claude Code и Codex, в том числе в терминалах с уменьшенной высотой.
  • Обновите установленные активы моделей и агентов, выполнив команду gentle-ai sync после обновления.
v3.6.1patch
🕐 1 мес назад · релиз на GitHub ↗

Исправление конфликтов инструментов Pi, улучшение диагностики OpenCode и уточнение документации.

  • Fixed: Устранён конфликт инструментов: удалён сторонний пакет ask_user_question, мешавший загрузке Gentle Pi.
  • Fixed: Улучшена диагностика ошибок OpenCode: теперь сообщения точнее описывают причину сбоя запуска.
  • Added: Уточнена документация по настройке Gentle Shell и маршрутизации задач в ODD.
  • После обновления обязательно выполните gentle-ai sync для синхронизации активов.
v3.6.0minor
🕐 1 мес назад · релиз на GitHub ↗

Добавлена изоляция директории агента через PI_CODING_AGENT_DIR и исправлены ошибки хуков на Windows.

  • Added: Появилась поддержка переменной окружения PI_CODING_AGENT_DIR для изоляции директории агента Pi без изменения ~/.pi.
  • Fixed: Хук UserPromptSubmit для Claude Code на Windows стал совместим с PowerShell, устраняя ошибки при обновлении.
  • Fixed: Исправлена ошибка дублирования канонического хука при его удалении и последующем добавлении.
  • Fixed: Команды uninstall и restore теперь корректно отображают справку по флагах --help.
v3.5.0minor
🕐 1 мес назад · релиз на GitHub ↗

По умолчанию включено receipt-driven развитие, добавлена запись времени последней успешной синхронизации и улучшена валидация PR.

  • Added: Receipt-driven development включен по умолчанию для всех новых установок.
  • Added: Команда gentle-ai sync теперь сохраняет время последней успешной синхронизации.
  • Added: Валидация PR поддерживает строгие ссылки на задачи без автоматического закрытия.
  • Fixed: Исправлены ошибки тестирования Windows и сериализация записей состояния.
  • Fixed: Улучшена обработка отказов провайдеров с указанием конкретных причин.
v3.4.0minorbreaking
🕐 1 мес назад · релиз на GitHub ↗

v3.4.0: хост-опосредованные роли pi, лимиты контекста, точная оценка рисков и удаление RTK.

  • Added: review assess теперь указывает точную причину проверки и готовую команду для перехода.
  • Added: Роли pi (refuter, validator) переведены в хост-опосредованный режим через materialize.
  • Added: Контекст ревьюера ограничен 200 KiB на роль до создания полномочий.
  • Breaking: Полностью удалена интеграция RTK Community Tool.
  • Fixed: Исправлены: OpenCode V1, лимит телеметрии, рост таблицы дедупликации, Windows Full Suite и другие.
v3.3.0minor
🕐 1 мес назад · релиз на GitHub ↗

Gentle AI v3.3.0: добавлена бета-поддержка OpenCode V2 с сохранением совместимости V1, без ломающих изменений.

  • Added: Добавлена версия-aware поддержка OpenCode V2 beta: автоматическое обнаружение, нативная конфигурация и управление плагинами.
  • Added: Сохранена полная обратная совместимость с установками OpenCode V1; границы возможностей версий стали явными.
  • Added: В CI добавлены фикстуры для проверки обеих веток интеграции (V1 и V2), контракт провайдера остаётся неизменным (1.2.0).
v3.2.1patch
🕐 1 мес назад · релиз на GitHub ↗

Исправлена обязательность делегирования через триггерную таблицу, маршрутизацию и защиту длинных сессий.

  • Fixed: Делегирование теперь обязательно: добавлена триггерная таблица, декларация маршрутов и защита от зависания длинных сессий.
  • Added: Добавлена документация: зафиксированы результаты функций и доказательства маршрутизации/ревью для каждой задачи.
v3.1.0minor
🕐 1 мес назад · релиз на GitHub ↗

ODD-задачи теперь закрываются work-unit коммитами с нативной оценкой риска и цепочками PR; без ломающих изменений.

  • Added: Каждая задача ODD завершается work-unit коммитом, фиксирующим поведение, тесты и документацию.
  • Added: Внедрена нативная оценка риска: высоко-рисковые коммиты ревьюятся сразу, средние — в рамках PR-слайсов.
  • Added: Стратегия доставки с цепочками pull requests теперь применяется к органической разработке (ODD).
  • Fixed: Обновлена документация: ODD представлена как отдельный цикл, исправлены описания SDD Verify и Archive.
v3.0.2patch
🕐 1 мес назад · релиз на GitHub ↗

Исправлены скрипты установки, теперь они корректно устанавливают модуль v3, а не устаревший v2.

  • Fixed: Скрипты install.sh и install.ps1 теперь корректно устанавливают пакет из модуля /v3, исправляя ошибку установки устаревшей версии v2.9.1.
  • Fixed: Добавлен регрессионный тест, который проверяет мажорную версию через go.mod и предотвратит подобные ошибки миграции в будущем.
  • Путь модуля остается /v3, контракт провайдера зафиксирован на версии 1.2.0, новых функций или ломающих изменений нет.
v3.0.0majorbreaking
🕐 1 мес назад · релиз на GitHub ↗

ODD стал обязательным протоколом по умолчанию; SDD упрощен, RDD вынесен в отдельный режим; исправлены утечки артефактов и тесты.

  • Added: Organic Driven Development (ODD) стал обязательным протоколом по умолчанию для всех поддерживаемых рантаймов.
  • Added: Внедрено единое управление функциями с зеркалом Engram и обязательным режимом TDD при реализации.
  • Breaking: Receipt-driven development (RDD) удален из жизненного цикла SDD, оставшись как отдельный пользовательский переключатель.
  • Breaking: Упрощен SDD: исследования и верификация стали опциональными, снята необходимость аттестации при архивировании.
  • Fixed: Исправлены утечки глобальных артефактов агентов в рабочую директорию, убраны лишние навыки из пресета и исправлен тест на Windows.
v2.9.1patch
🕐 1 мес назад · релиз на GitHub ↗

Hotfix v2.9.1: исправлен отказ делегирования SDD в Claude Code и зависание согласия в OpenCode.

  • Fixed: В Claude Code восстановлена работа делегирования sdd-*: защита теперь проверяет транскрипт сессии, а не подделываемые записи PostToolUse.
  • Fixed: В OpenCode исправлено зависание согласия при использовании схемы вопроса с multiple, но без custom.
  • Fixed: Удалено уязвимое хранилище записей и очистка SessionEnd; сканер транскрипта теперь игнорирует слишком длинные строки.
  • Fixed: Инструкции OpenCode стали aware к схеме: неиспользуемые элементы управления пропускаются, а не блокируют процесс.
v2.9.0minor
🕐 1 мес назад · релиз на GitHub ↗

RTK как опциональный инструмент сообщества и исправления SDD-ledger, синхронизации и OpenCode.

  • Added: RTK (Rust Token Killer) добавлен как опциональный инструмент сообщества для сжатия вывода команд.
  • Fixed: Исправлены тупиковые ситуации в SDD attempt ledger, связанные с восстановлением после неудачных исправлений.
  • Fixed: gentle-ai sync теперь поддерживает симлинки в директории конфигурации агентов.
  • Fixed: Улучшена обработка результатов обзора OpenCode, включая семантическое декодирование задач.
  • Fixed: Engram protocol уточнен для восстановления при неоднозначных проектах.
v2.8.2minor
🕐 1 мес назад · релиз на GitHub ↗

Добавлены инструменты сообщества (RTK), исправлены телеметрия Claude и префлайт opencode.

  • Added: Добавлен контракт источника и безопасное получение RTK для community-tools.
  • Fixed: Исправлена коллизия защиты идентичности во время выполнения в community-tools.
  • Fixed: Исправлена телеметрия: теперь корректно и без дубликатов отправляется использование Claude Code Stop.
  • Fixed: Исправлен префлайт opencode: сохранена проверка SDD для инструментов с runtime-опциями.
v2.8.1patch
🕐 1 мес назад · релиз на GitHub ↗

Исправлена телеметрия: добавлено распознавание семейств моделей, уточнены паттерны ID и поддержка ревизий Claude.

  • Fixed: Телеметрия теперь корректно атрибутирует модели рантайма по публичным паттернам семейств.
  • Fixed: Уточнён паттерн идентификатора модели: исключена неоднозначность и добавлена поддержка ревизий Claude в CLI-тестах.
  • Fixed: Оптимизирована передача префиксов семейств: добавлено документирование и удаление общих токенов семейств.
v2.8.0minor
🕐 1 мес назад · релиз на GitHub ↗

Gentle AI v2.8.0: усилен контроль ревью, улучшена надежность SDD и видимость телеметрии без ломающих изменений.

  • Added: Усилен контроль жизненного цикла ревью: исключены неявные состояния и улучшена защита от устаревших или неверно направленных действий.
  • Added: Уточнены права и пути восстановления SDD: строго определена ответственность при сбоях, прерываниях и возобновлении работы.
  • Added: Улучшена диагностика и видимость работы рантайма: упрощен анализ активных операций и атрибуции субагентов.
  • Fixed: Исправлены и укреплены процессы установки, обновления, определения платформы и удаления в поддерживаемых средах.
v2.7.0minor
🕐 1 мес назад · релиз на GitHub ↗

Gentle AI v2.7.0: анонимная телеметрия, оценка рисков изменений, автокомпозиция SDD-спецификаций и исправления жизненного цикла ревью.

  • Added: Внедрена анонимная телеметрия: сбор минимальных метрик (версия, ОС, тип CPU, количество синхронизаций) с возможностью полного отключения через переменные окружения или команду.
  • Added: Добавлена оценка рисков изменений (assess) до начала работы, позволяющая агентам адаптировать глубину проверки в зависимости от уровня опасности правок.
  • Added: Автоматизировано формирование финальной спецификации в SDD-архиве через команду sdd-archive-compose, исключающее необходимость ручного слияния.
  • Fixed: Устранены тупиковые ситуации в жизненном цикле ревью: улучшена обработка недоступных ролей, неопределенных вердиктов валидаторов и рассинхрона с новыми коммитами.
v2.6.0majorbreaking
🕐 2 мес назад · релиз на GitHub ↗

v2.6.0: интеграция Claude Code и Pi, исправление SDD-статуса, архивирование изменений и обновление контрактов.

  • Added: Добавлен хук stop-hook для Claude Code, обеспечивающий корректный запуск review-цикла.
  • Added: Для Pi внедрен контракт оркестрации через фасадные инструменты и обновлен пакет контрактов до 1.2.0.
  • Fixed: Исправлена ошибка в статусе SDD: теперь корректно публикуется digest untracked_inventory.
  • Added: Команда sdd status теперь явно указывает поле archived для завершенных изменений.
  • Breaking: Изменено поведение rollback бэкапа: сохранены нетипизированные записи, обновлен синтаксис sync.