Разделение: copilot-instructions.md (правила) + DEVELOPMENT.md (порядок правок)

2026-07-12 08:43:42 +04:00
parent cc2f627de2
commit 4c3f9d4e49
2 changed files with 129 additions and 97 deletions
@@ -0,0 +1,104 @@
+# Порядок действий при изменении кода
+
+**Читать перед ЛЮБОЙ правкой.**
+
+---
+
+## ⛔ ЗАПРЕЩЕНО
+
+1. Менять код без «делай»
+2. Действовать по догадкам («я бы сделал так», «можно попробовать»)
+3. Удалять файлы/папки без разрешения
+4. «Улучшать» рабочий код без прямого разрешения
+5. Использовать `sed`
+6. Откладывать commit/push «на потом»
+7. Игнорировать проверку синтаксиса перед push
+
+---
+
+## ✅ ПОРЯДОК ПРИ ЛЮБОМ ИЗМЕНЕНИИ
+
+### Шаг 1 — План
+```
+Описать что меняем → получить «делай»
+```
+
+### Шаг 2 — Правка
+Вносим изменения. Только то, что обговорено. Никакой самодеятельности.
+
+### Шаг 3 — Проверка синтаксиса
+```bash
+python3 -c "import py_compile; py_compile.compile('путь/к/файлу.py', doraise=True)"
+```
+**КАЖДЫЙ изменённый .py файл.**
+
+### Шаг 4 — Проверка импорта
+```bash
+cd /home/naeel/nubes/drhider && python3 -c "from drhider import obfuscate_files, LLMClient; print('OK')"
+```
+
+### Шаг 5 — Проверить соседей
+После `replace_string_in_file` — прочитать соседние строки, убедиться что не затёр соседнюю функцию/класс.
+
+### Шаг 6 — commit + push (СРАЗУ)
+```bash
+cd /home/naeel/nubes/drhider
+git add -A
+git commit -m "подробное описание что и зачем"
+git push
+```
+**Без исключений. Никаких накоплений.**
+
+### Шаг 7 — Документировать
+Записать в `History/` что сделано:
+- Отдельный `.md` файл
+- Что планировалось → что сделано → в чём ошибся
+
+### Шаг 8 — Redeploy
+Зайти в UI Штурвала → Redeploy `drhider`.
+
+---
+
+## 🔧 Команды в терминале — всегда с таймаутами
+
+```bash
+curl --max-time 30 ...
+ssh -o ConnectTimeout=10 ...
+timeout 10 grep ... file.txt
+```
+
+---
+
+## 📦 Проверка ВСЕХ файлов разом
+
+```bash
+cd /home/naeel/nubes/drhider
+python3 -c "
+import py_compile, os
+for root, dirs, files in os.walk('.'):
+    for f in files:
+        if f.endswith('.py'):
+            py_compile.compile(os.path.join(root, f), doraise=True)
+            print(f'OK: {os.path.join(root, f)}')
+"
+```
+
+---
+
+## 🏷️ Версионирование
+
+Версия в `site/app.py` (переменная `VERSION`).
+Менять при любом изменении кода, влияющем на поведение.
+
+---
+
+## 📝 Пример хорошего коммита
+
+```
+git commit -m "generators: добавил generate_snils — генератор фиктивных СНИЛС
+
+- Новый файл drhider/generators/snils.py
+- Добавлен паттерн в config.py → ENTITY_PATTERNS
+- Добавлен в generators/__init__.py → ENTITY_GENERATORS
+- bump VERSION 2.0.0 → 2.0.1"
+```