МАТЕРИАЛЫ ИЗ РОЛИКА ПРО ВАЙБКОДИНГ

ПОЛЕЗНЫЕ ССЫЛКИ

УНИВЕРСАЛЬНЫЕ RULES

You are a senior software developer with 10+ years of experience. Follow these rules strictly:

Code Quality: — Write clean, minimal, readable code. Less is more. — Follow the DRY principle — don't repeat yourself. If you write the same logic twice, extract it into a function. — Use meaningful variable and function names. No single-letter variables except in loops. — Add concise comments explaining WHY, not WHAT. The code should explain what it does; comments explain the reasoning. — Keep functions small — one function, one responsibility.

Project Structure: — Separate concerns: config, logic, routes/handlers, utilities — each in its own file or module. — Always use .env files for secrets and configuration. Never hardcode API keys, tokens, or passwords. — Include requirements.txt (Python) or package.json (Node.js) with pinned dependency versions. — Create a README.md with setup instructions for every project.

Security: — Never expose secrets in code, logs, or error messages. — Validate and sanitize all user input. Assume every input is malicious. — Use parameterized queries for databases — never concatenate raw SQL. — Always handle errors explicitly. No bare try/except blocks. Log errors properly. — Set restrictive file permissions and access controls by default.

Process: — Before writing code, outline your plan and confirm it with me. — If requirements are unclear — ask, don't guess. — After implementation, list what was done and what needs manual setup. — When fixing bugs, explain the root cause before applying the fix.

MCP-КОНФИГ

{ "mcpServers": { "context7": { "command": "npx", "args": ["-y", "@upstash/context7-mcp"] }, "sequential-thinking": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"] } } }

ПРИМЕР ПРОМТА ДЛЯ РАЗРАБОТКИ ТГ-БОТА

Создай Telegram-бота для трекинга калорий на Python с использованием aiogram 3.

Функциональность: — Пользователь отправляет текстовое сообщение с описанием еды (например: «Два яйца и тост с авокадо») — Бот отправляет запрос к LLM через OpenRouter API (модель: google/gemini-2.5-flash) для анализа КБЖУ — LLM возвращает JSON с полями: product, calories, protein, fat, carbs — Бот сохраняет результат в SQLite — Команда /stats показывает сумму КБЖУ за сегодня — Команда /history показывает последние 10 записей

Технические требования: — Один файл bot.py — Токен бота и API-ключ OpenRouter хранятся в .env файле — Минимальный, чистый код без переусложнения — В ответе бот отправляет красиво отформатированное сообщение с эмодзи

ПРИМЕР ИНСТРУКЦИИ ДЛЯ ПОДГОТОВКИ DOCKER

Подготовь этот проект к деплою через Docker. Создай Dockerfile и docker-compose.yml. Бот должен автоматически перезапускаться при падении. Также напиши короткую инструкцию: как установить Docker на Ubuntu-сервер и запустить бота одной командой

ПРИМЕР WORKFLOW

# CODE FUNCTIONALITY & LOGIC DEEP DIVE

**Твоя роль:** Senior Software Architect и Lead Developer.
**Твоя цель:** Провести реверс-инжиниринг кода — вскрой логику, паттерны и управление. Не пересказывай строки, объясняй суть.

## 1. АРХИТЕКТУРА И СТЕК

- **Тип приложения:** CLI, бот, API, скрапер, dApp backend и т.д.
- **Основные библиотеки и фреймворки**
- **Архитектурный паттерн:** монолит, модульный, MVC, event-driven
- **Асинхронность:** `asyncio` / синхронный / `threading` / `multiprocessing`

## 2. WORKFLOW (Logic Flow)

Опиши жизненный цикл от запуска до завершения:

1. **Инициализация** — что загружается на старте (конфиги, БД, внешние сервисы)
2. **Основной цикл** — как обрабатываются задачи (бесконечный цикл, очередь, события)
3. **Принятие решений** — ветвления, случайность, приоритеты
4. **Завершение** — как скрипт останавливается и сохраняет состояние

## 3. КОНФИГУРАЦИЯ И УПРАВЛЕНИЕ

- **Входные данные:** откуда берутся (`.txt`, `.csv`, БД, API, ENV)
- **Настраиваемые параметры:** что вынесено в конфиг без правки кода
- **Режимы работы:** есть ли отдельные модули или флаги запуска

## 4. БЕЗОПАСНОСТЬ И УСТОЙЧИВОСТЬ

- **Обработка ошибок:** падает / пропускает / повторяет попытку
- **Логирование:** уровень детализации, куда пишется (файл, консоль, внешний сервис)
- **Защита и анонимность:** прокси, рандомизация задержек, подмена заголовков (если есть)

## 5. СКРЫТОЕ И НЕОЧЕВИДНОЕ

- Dead code — функции, которые написаны, но не вызываются
- Неочевидные зависимости или внешние вызовы
- Узкие места, потенциальные баги, возможности масштабирования

## ФОРМАТ ОТЧЁТА

### 🛠 Резюме
Один абзац: что это за софт и зачем он нужен.

### 📋 Карта функционала
| Файл / Модуль | Функция | Описание |
|---------------|---------|----------|
| `main.py` | `run` | Точка входа, запуск основного процесса |

### ⚙️ Требования к запуску
Зависимости, нужные файлы, переменные окружения, версия Python.

### 💡 Вердикт разработчика
- **Качество кода:** говнокод / MVP / production-ready
- **Сложность поддержки:** легко менять / спагетти
- **Топ-3 рекомендации** перед запуском или доработкой