GitWhy

Что такое GitWhy?

GitWhy — это «контекстный слой» для Git, который сохраняет и публикует обоснование AI-кода, привязывая его напрямую к коммитам, которые его сгенерировали. Цель — сделать промпты, решения и компромиссы доступными для ревью вместе с изменениями кода, а не оставлять эту информацию только в чате.

Он захватывает структурированный контекст (оригинальный промпт, обоснование, решения, отклонённые альтернативы) и привязывает его к коммитам. Продукт затем отображает сохранённое обоснование в pull request, чтобы ревьюеры видели, почему были сделаны изменения, а не только diff.

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

• Структурированные контексты «обоснования»: Хранит фиксированный формат, включая промпт, обоснование, решения, отклонённые альтернативы, файлы и коммиты, для консистентности результатов.
• Привязка к коммитам (git-нативная провенанс): Каждый сохранённый контекст привязан к точным коммитам, которые его произвели, так документация остаётся закреплённой за историей кода.
• Отображение в PR через gitwhy-bot: Публикует полное обоснование в pull request как комментарии к PR, делая контекст ревью доступным во время код-ревью.
• Синхронизация в облако и обмен: Синхронизирует сохранённые контексты в облако, чтобы команды могли делиться ими по организации.
• Поиск по сохранённым контекстам: Позволяет искать сохранённые обоснования по ключевым словам, домену или теме для быстрого нахождения прошлых решений.
• Работает с MCP-совместимыми агентами: Разработан для работы с любыми MCP-совместимыми агентами (страница явно упоминает Claude Code, Cursor, Windsurf и Cline).
• Терминальный UI для управления: Предоставляет интерактивный интерфейс терминала для просмотра, поиска и управления контекстами без браузера.

Как использовать GitWhy

1. Генерируйте код с MCP-совместимым агентом и убедитесь, что агент производит обоснование, которое нужно захватить.
2. Сохраните контекст обоснования, где GitWhy фиксирует структурированные элементы (промпт, обоснование, решения, отклонённые альтернативы, файлы и коммиты) и привязывает их к релевантным коммитам.
3. Синхронизируйте в облако (для командного обмена) и откройте pull request.
4. Ревью в PR: Бот GitWhy публикует сохранённое обоснование в pull request, чтобы ревьюеры могли прочитать базовые решения и компромиссы.

Сценарии использования

• Ревью PR для AI-изменений: Когда AI генерирует код, ревьюеры читают сохранённое обоснование и решения в комментарии PR, а не угадывают намерения по diff.
• Сбор знаний команды для повторяющихся дизайн-решений: Решения по аутентификации, БД и API можно хранить в дереве контекстов по домену/теме, помогая командам переиспользовать прошлую логику.
• Аудит «почему» за конкретными коммитами: Поскольку каждый контекст привязан к коммитам, разработчики могут отследить происхождение решения до точных изменений кода.
• Быстрый поиск при новой работе: Ищите сохранённые контексты по ключевым словам, домену или теме из терминала, агента или дашборда команды для быстрого нахождения релевантной логики.
• Мультиагентные workflows: Команды с разными MCP-совместимыми агентами могут захватывать и управлять обоснованиями в одном месте без единого чата.

FAQ

• Какую информацию GitWhy хранит для каждого контекста? Страница описывает структурированный формат, включая промпт, обоснование, решения, отклонённые альтернативы, файлы и коммиты.

• Как GitWhy связывает обоснование с кодом? Привязывает каждый сохранённый контекст к точным коммитам, которые его произвели.

• Где ревьюеры видят обоснование? Бот GitWhy публикует полное обоснование в pull request как комментарии к PR.

• Можно ли использовать без браузера? Да. Продукт включает интерактивный терминальный UI для просмотра, поиска и управления контекстами.

• Какие агенты поддерживаются? Сайт указывает, что работает с любыми MCP-совместимыми агентами и специально упоминает Claude Code, Cursor, Windsurf и Cline.

Альтернативы

• Обычные описания или комментарии PR: Команды могут вручную вставлять обоснование в текст PR, но это не сохраняет автоматически структурированную историю, привязанную к коммитам, о причинах изменений.
• Внешние системы документации (вики/базы знаний): Команды могут вести документацию решений отдельно, но она не связана по умолчанию с коммитами и не появляется автоматически в PR.
• Просмотр локальной истории логов/чатов: Чтение предыдущих логов чатов может дать контекст, но это менее удобно для поиска и обычно не связано с коммитами в истории репозитория.
• Универсальные инструменты code review с аннотациями: Инструменты, аннотирующие diff’ы, могут объяснять изменения, но здесь акцент на структурированном обосновании, привязанном к коммитам, и публикации в PR через gitwhy-bot, чего может не быть в общих инструментах ревью.