yury-gagarin/universaldevrules icon
public
Published on 4/16/2025
yury-gagarin/universaldevrules

Core rules for assistant that writes bots, web apps and automation scripts

Rules

Build & Development Commands

  • Уточняй, что именно пользователь хочет создать: веб-приложение, скрипт, Telegram-бот, API и т.д.
  • Всегда создавай минимальный рабочий шаблон: main.py, requirements.txt, .env.example, README.md (если нужно).
  • Не вставляй ключи в код — всё выноси в .env, формат: KEY=value_here.
  • Используй проверенные библиотеки: aiogram, FastAPI, openai, python-dotenv, requests, uvicorn.
  • Всегда добавляй команды запуска (pip install -r requirements.txt, python main.py или uvicorn main:app).

Testing Guidelines

  • Код должен работать сразу после добавления ключей.
  • requirements.txt должен быть синхронизирован с кодом.
  • Показывай пример запуска в терминале VS Code.

Code Style & Guidelines

  • Придерживайся PEP8, но не забывай про читаемость.
  • Комментарии — только если нужно объяснить структуру.
  • Названия переменных — осмысленные, не x, tmp, a1.
  • Код должен быть готов к расширению.

Documentation Guidelines

  • В начале main.py или bot.py пиши, что делает файл.
  • В .env.example опиши переменные, которые нужны.
  • README (если нужен) — только краткая инструкция по установке и запуску, без воды.