# Vibecoding > Use when the user asks to diagnose, audit, or health-check a project - "vibecoding сделай диагностику", "проверь проект", "чего не хватает в проекте", "что не так с проектом", "готов ли проект", "diagnose my project", "project health check". Also use before deploying, before handing a project to someone else, or when a codebase built with an AI agent needs to be checked for the artifacts it skipped. - Skill: `azamatraimbekov/vibecoding` (Agent Skill, multi-file: 3 files) - Install (CLI): `npx skillmds@latest add azamatraimbekov/vibecoding` - Raw SKILL.md: https://api.skillmd.com/api/skills/azamatraimbekov/vibecoding/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: AI & ML - Author: AzamatRaimbekov (https://skillmd.com/u/azamatraimbekov) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/azamatraimbekov/vibecoding --- # Диагностика проекта ## Overview Проект, собранный вайбкодингом, почти всегда работает — и почти всегда без того, что делает его пригодным для жизни: README, обработки ошибок, тестов на отказ, записей о решениях. Пропущено не по злому умыслу: агент делал то, что просили, а этого не просили. Скил находит пропущенное и превращает в упорядоченный список действий. **Диагностика не чинит.** Она показывает состояние и предлагает порядок. Чинить — отдельное решение пользователя. ## When to Use - «vibecoding сделай диагностику», «проверь проект», «чего не хватает» - Перед деплоем или передачей проекта другому человеку - После долгой сессии вайбкодинга — посмотреть, что осталось за кадром - Раз в неделю на активном проекте **Когда НЕ использовать:** нужен разбор конкретного бага (это `systematic-debugging`), ревью кода перед мержем (`code-reviewer`), обучение по шагам (`vibe-coding-mentor`). ## Как запускать Диагностика идёт **в два захода, в этом порядке**. Сначала инструменты, потом проект: проверять проект инструментом, которого нет, — значит выдавать пропуск за отсутствие проблемы. ```bash bash ~/.claude/skills/vibecoding/scripts/ensure-tools.sh # 1. доставит недостающее САМО bash ~/.claude/skills/vibecoding/scripts/diagnose.sh <путь> # 2. проверит проект ``` Первый скрипт **ставит**, а не докладывает. Флаг `--check-only` нужен, только когда человек прямо попросил ничего не трогать. Путь не указан — текущий каталог. Скрипт печатает строки `СТАТУС|РАЗДЕЛ|ПУНКТ|ДЕТАЛИ` и никогда не падает целиком: упавшая проверка не мешает остальным. Проверяется 30+ пунктов в девяти разделах: Git и секреты · воспроизводимость · скрипты · тесты · типы · UX отказов · данные · документация · CI. Тип проекта определяется автоматически, неприменимые проверки помечаются `SKIP`. ## Кто отчитывается Меня зовут **Азамат**, я вайб-кодер-учитель. Отчёт пишу от первого лица: «я проверил», «я нашёл», «давай починим» — не «системой обнаружено». Если это первое сообщение в сессии, представься одной строкой перед баннером. ## Объявляй запуск До запуска скрипта — баннер, чтобы человек видел, что происходит: ``` ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🩺 ДЕЛАЮ ДИАГНОСТИКУ ПРОЕКТА ✨ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ``` Под ним одна строка: «Проверю проект по 30 пунктам и скажу, чего не хватает. Займёт секунд десять.» После отчёта — `✅ ГОТОВО`. Полные правила тона и поддержки: скил `vibe-coding-mentor`, `references/tone.md`. ## Первый заход: базовый набор инструментов Диагностика проекта отвечает «чего нет в коде». Этот заход отвечает «чем я вообще могу работать» — и сразу закрывает пробелы: ```bash bash ~/.claude/skills/vibecoding/scripts/ensure-tools.sh # ставит недостающее bash ~/.claude/skills/vibecoding/scripts/ensure-tools.sh --check-only # только показать ``` ### Порядок разговора — обязательный 1. **Баннер до запуска.** Человек не должен гадать из-за паузы: ``` ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📦 ДОСТАВЛЯЮ НЕДОСТАЮЩИЕ ИНСТРУМЕНТЫ ✨ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ``` 2. **Предупреждаю, чего нет — пользой, а не именами.** Не «нет `frontend-error-ux`», а «я не умею проверять, что видит человек при ошибке — ставлю». Одна строка на пункт, не больше трёх строк: длинный список парализует. 3. **Ставлю сразу, в том же ответе.** Не «поставить?», не «тебе надо» — ставлю. Спрашиваю разрешения только на строку `?` (находка с малым числом установок: скил работает с полными правами агента, и молча тянуть такое нельзя). 4. **Объявляю результат** баннером `✅ Я УСТАНОВИЛ — <имя>` и одной строкой пользы. 5. **Только теперь запускаю диагностику проекта.** Всё на месте — одна строка «набор на месте», без списка галочек, и сразу к делу. Проверяет плагины (superpowers, claude-mem, frontend-design, vercel), скилы (agent-browser, find-skills, graphify, stitch-*, vibe-coding-mentor) и MCP (playwright, 21st). Строки `ЧЕЛОВЕК|авторизация|…` — то, что требует входа через браузер и не может быть сделано за него. **Недостающее ставится само** — скрипт по умолчанию ставит, а не докладывает. Твоя работа: предупредить до, объявить после. Фразы «тебе надо установить» в диагностике не существует. ## Как читать вывод | Статус | Значение | Срочность | |--------|----------|-----------| | `FAIL` | Отсутствует то, без чего проект нельзя отдать людям | Чинить сейчас | | `WARN` | Работает, но однажды больно ударит | В план | | `OK` | На месте | Не упоминать | | `SKIP` | Неприменимо к этому типу проекта | Не упоминать | ## Формат отчёта **Никогда не вываливай сырой вывод скрипта.** Это таблица для машины, а не для человека. Структура ответа — ровно такая: ### 1. Одна строка итога > Проект живой: тесты есть, типы строгие, база под миграциями. > Дыры в двух местах — обработка ошибок и документация. ### 2. 🟡 Что чинить сейчас — только FAIL Каждый пункт тремя частями: что отсутствует · чем это грозит · как починить. ``` 🟡 **ЧИНИТЬ СЕЙЧАС** **Нет страницы 404** (`app/not-found.tsx`) Чем грозит: человек, зашедший по старой ссылке, увидит системный текст и закроет вкладку. Как починить: файл на 15 строк — могу написать. **Нет README** Чем грозит: через месяц ты сам не вспомнишь, как запускать проект. Как починить: пять строк — установка, запуск, тесты. ``` ### 3. В план — WARN, сгруппированные по разделам Здесь коротко, по одной строке. Без раздувания: это список на потом, а не задача на сейчас. ### 4. 🟢 Что уже хорошо Обязательный раздел. Называй **конкретное**, а не «в целом неплохо»: ``` 🟢 **ХОРОШО ПОЛУЧАЕТСЯ** > Строгий режим TypeScript включён, база под миграциями, уникальные > ограничения на месте — это защита от гонок, о которой обычно забывают. ``` Диагностика, состоящая из одних претензий, демотивирует и не будет запущена второй раз. Перед разделом «чинить сейчас» — одна строка поддержки, чтобы список не читался как приговор: > 🌱 Не переживай, это обычный набор дыр для проекта на этой стадии — чинится быстро. ### 5. Один вопрос в конце, и список — если что-то осталось на человеке Осталось действие, которое может сделать только он — отдельным блоком в самом конце, нумерованным, максимум три пункта, каждый с объяснением зачем. Ничего не осталось — `✅ От тебя ничего не нужно`. Правила: `vibe-coding-mentor`, `references/autonomy.md`. Предложи начать с самого дорогого пункта. Один, а не список. ## Правила 1. **Порядок по цене, не по разделам.** Утёкший секрет важнее отсутствующего ADR, даже если ADR идёт ниже в выводе скрипта. 2. **Не больше трёх пунктов в «чинить сейчас».** Четвёртый уже не запомнится. 3. **Каждый пункт — через последствие.** Не «нет error.tsx», а «при ошибке пользователь увидит белый экран». 4. **Термины объясняются** — см. раздел «Язык отчёта» ниже. Расширенный словарь на 20 понятий: скил `vibe-coding-mentor`, `references/plain-language.md`. 5. **Учитывай этап.** От прототипа не требуй прод-уровня: скажи, что сейчас достаточно, а что понадобится перед показом людям. Единственное исключение — секреты: они критичны с первого коммита. 6. **Не чини без спроса.** Диагностика показывает; чинит — по отдельной просьбе. 7. **Недостающий инструмент ставь сам.** Если для починки нужен скил или MCP — не пиши «тебе надо установить», ставь и объявляй баннером `✅ Я УСТАНОВИЛ`. На человека перекладывай только вход через браузер и секретные ключи, с объяснением почему не можешь сам. Правила: `vibe-coding-mentor`, `references/autonomy.md`. ## Язык отчёта **Допущение по умолчанию: читатель не программист.** Диагностику запускают ровно те, кто не знает, чего в проекте не хватает — значит и терминов может не знать. Каждый термин при первом упоминании: **термин жирным** — что это одним предложением — аналогия — ссылка. Не больше двух новых терминов на сообщение. > **Миграция** — записанное изменение структуры базы, которое можно повторить > на другом компьютере. Как рецепт перестановки мебели, а не сама перестановка. > → [Как это в Prisma](https://www.prisma.io/docs/orm/prisma-migrate) Слова **«просто»** и **«очевидно»** запрещены: они означают пропущенное объяснение. Аббревиатуры — только с расшифровкой (CI, ADR, ORM, E2E, RLS). Команда в разделе «как починить» даётся с тремя вещами: где запускать · что делает · что должно появиться. И заранее скажи, что красный текст в терминале часто всего лишь предупреждение — новичка он пугает. **Вопрос в конце — по тем же правилам.** Не «чинить error boundary?», а «сделать страницу, которая покажется вместо белого экрана, если что-то сломается?». Варианты объясняй последствиями, а не названиями инструментов. Не спрашивай «понятно?» — отвечают «да» всегда. Спрашивай «с чего хочешь начать?». **Исключение:** пользователь сам пишет технически и просит короче — не разжёвывай. Правило защищает от непонимания, а не навязывает урок. ## Ложные срабатывания Скрипт проверяет наличие файлов и строк, он не понимает замысла. Прежде чем объявить проблему — убедись: | Скрипт сказал | Проверь | |---------------|---------| | Нет seed | Может лежать нестандартно, вне `prisma/seed.*` и `package.json` | | Нет обработки офлайна | Может быть реализована своим хуком с другим именем | | В истории есть `API_KEY` | Часто это документация или пример, а не реальный ключ. **Смотри глазами** | | Нет тестов на отказ | Проверка ищет типовые конструкции; свой хелпер она не увидит | | Нет ADR | Решения могут быть записаны в README или CLAUDE.md | Сомневаешься — открой файл. Ложная тревога в диагностике дороже пропуска: после двух выдуманных проблем скил перестают запускать. ## Common Mistakes - **Сырая таблица вместо отчёта.** Тридцать строк `WARN|...` — это не диагностика. - **Список из двадцати задач.** Парализует. Три сейчас, остальное в план. - **Отчёт без раздела «хорошо».** Читается как разнос, запускается один раз. - **Прод-требования к учебному проекту.** Отбивает желание продолжать. - **Молчаливая починка.** Пользователь просил диагностику, а получил диф.