Gentleman-Programming/gentle-ai

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

Агенты⭐ 7 082Goпоследний релиз: v3.4.0
Открыть на 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 в процессе разработки.

Релизы

v3.4.0minorbreaking
🕐 2 дн назад · релиз на 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
🕐 2 дн назад · релиз на 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
🕐 3 дн назад · релиз на GitHub ↗

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

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

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

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

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

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

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

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

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

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

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

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

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

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