AntiVibe
mohi-devhub/antivibeУчебный фреймворк для Claude Code: превращает AI-сгенерированный код в подробные образовательные объяснения. Раскрывает логику решений, паттерны и концепции — для разработчиков, которые хотят реально разобраться в коде.
Установка
git clone https://github.com/mohi-devhub/antivibe.gitREADME
AntiVibe
✨ Что такое AntiVibe?
AntiVibe — это учебный фреймворк объяснения кода, который превращает AI-сгенерированный код в образовательный контент. В отличие от обычных резюме кода, AntiVibe помогает понять:
- Что делает код (функциональность)
- Почему он написан именно так (архитектурные решения)
- Когда применять эти паттерны (контекст)
- Какие альтернативы существуют (более широкие знания)
⚡ Проблема: AI пишет код, разработчики копируют его, никто ничему не учится.
🛡️ Решение: AntiVibe объясняет логику, чтобы вы действительно понимали происходящее.
🎯 Возможности
| Возможность | Описание |
|---|---|
| Глубокий разбор | Генерация подробных учебных руководств по AI-коду |
| Карта концепций | Связь кода с базовыми принципами CS |
| Подборка ресурсов | Качественные ссылки на документацию, туториалы, видео |
| Учёт фаз | Группировка объяснений по фазам реализации |
| Авто-запуск | Опциональные хуки для автоматической генерации |
| Мультиязычность | Работает с любым языком и фреймворком |
🚀 Быстрый старт
Установка
# Клонировать репозиторий
git clone https://github.com/mohi-devhub/antivibe.git
# Установить как глобальный Claude Code skill
cp -r antivibe ~/.claude/skills/antivibeИспользование
/antivibe # Запустить глубокий разбор
"deep dive" # Проанализировать недавно написанный код
"learn from this code" # Сгенерировать учебное руководство
"explain what AI wrote" # Объяснить конкретные файлы
"understand what AI wrote" # Разобрать архитектурные решения
📁 Пример вывода
Запустите глубокий разбор и получите файл вида:
# Deep Dive: Authentication System
## Overview
This auth system uses JWT tokens with refresh token rotation...
## Code Walkthrough
### auth/service.ts
- **Purpose**: Token generation and validation
- **Key Components**:
- `generateTokens()`: Creates access/refresh tokens
- `verifyToken()`: Validates JWT signatures
## Concepts Explained
### JWT (JSON Web Tokens)
- **What**: Stateless authentication tokens...
- **Why**: Server doesn't need to store sessions...
- **When**: APIs, SPAs, microservices...
## Learning Resources
- [JWT.io](https://jwt.io): Official documentation
- [Auth0 Guide](https://auth0.com/blog): Best practicesСохранено в: deep-dive/auth-system-2026-04-10.md
🔧 Настройка
Хуки авто-запуска
Включите автоматическую генерацию глубокого разбора после завершения задачи:
# Скопировать хуки в ваш проект
cp framework/hooks/hooks.json your-project/.claude/hooks.json| Хук | Когда срабатывает | Сценарий использования |
|---|---|---|
SubagentStop | Завершение задачи | Обучение по фазам |
Stop | Конец сессии | Итоговое резюме сессии |
Настройка директории вывода
Отредактируйте scripts/generate-deep-dive.sh:
OUTPUT_DIR="your-folder" # По умолчанию: "deep-dive"
📂 Структура файлов
antivibe/
├── SKILL.md # Основное определение скилла
├── README.md # Этот файл
├── hooks/
│ └── hooks.json # Конфигурация авто-запуска
├── scripts/
│ ├── capture-phase.sh # Определение фаз реализации
│ ├── analyze-code.sh # Разбор структуры кода
│ ├── find-resources.sh # Поиск внешних ресурсов
│ └── generate-deep-dive.sh # Генерация markdown-вывода
├── agents/
│ └── explainer.md # Субагент для детального анализа
├── templates/
│ └── deep-dive.md # Шаблон вывода
├── reference/
│ ├── language-patterns.md # Паттерны для конкретных фреймворков
│ └── resource-curation.md # Подборка учебных ресурсов
└── docs/
├── PLAN.md # Документ планирования
└── setup.md # Подробное руководство по настройке
📚 Принципы
- Почему важнее что — всегда объяснять архитектурные решения
- Контекст важен — объяснять, когда и зачем применять паттерны
- Подборка ресурсов — качественные ссылки, а не случайные результаты
- Учёт фаз — группировка по фазам реализации
- Путь обучения — предлагать следующие шаги для углублённого изучения
- Карта концепций — связывать код с базовыми концепциями CS
🛠️ Поддерживаемые языки и фреймворки
- JavaScript/TypeScript: React, Node.js, Express
- Python: Django, FastAPI, Flask
- Go: стандартная библиотека, Gin, Echo
- Rust: стандартная библиотека, Actix
- Java: Spring Boot
- И другие — расширяемая система паттернов
🤝 Участие в разработке
Вклад приветствуется! Чтобы расширить AntiVibe:
- Добавьте паттерны в
reference/language-patterns.md - Добавьте ресурсы в
reference/resource-curation.md - Настройте шаблон в
templates/deep-dive.md
📖 Документация
- Руководство по настройке — подробная установка
- Формат скиллов — Claude Code skills
⚠️ Лицензия
MIT License — используйте, учитесь, делитесь.