chore(docs): уборка структуры — вся документация в docs/, краткий README, добавлен AGENTS.md

- AGENTS.md: правила проекта (структура доков, стек, статьи, деплой, git, openspec, проверки)
- README.md: сокращён до введения + указателей на docs/
- docs/: DEPLOY_INSTRUCTIONS, ROADMAP, PAPERMOD_PARAMS, QWEN, gitea-setup,
  Telegram_frontend, ssh_setup, archive/PROJECT_SUMMARY (из .qwen/)
- tools/: winscp_script.txt переехал из корня к deploy_sftp.py
- Makefile и deploy_sftp.py: ссылки на docs/DEPLOY_INSTRUCTIONS.md

docs/DEPLOY_INSTRUCTIONS.md

@@ -0,0 +1,109 @@
+# Инструкция по публикации сайта через SFTP
+
+## Описание
+
+Этот документ описывает процесс публикации сгенерированного сайта (папка `public`)
+на хостинге через SFTP. Решение кроссплатформенное и работает как на Unix-подобных
+системах (Linux/macOS), так и на Windows.
+
+> **ВАЖНО: деплой сайта выполняется ТОЛЬКО через `make deploy`.** Аккаунт Jino —
+> SFTP-only: удалённый запуск команд (rsync, ssh-exec) запрещён сервером
+> (ошибка `exec request failed on channel 0`). Прямой rsync на этот аккаунт
+> НЕ РАБОТАЕТ.
+
+## Учетные данные и параметры подключения
+
+- **Хост**: kpa39l.myjino.ru
+- **Порт SFTP**: 2222
+- **Пользователь**: kpa39l_dedinit
+- **Пароль**: -Zp4ep747t25
+- **Целевой путь**: /dedinit.ru (относительно корня аккаунта)
+
+## Установка зависимостей
+
+### Для Linux/macOS
+
+- **Python 3** (с venv/pip)
+- **Make** — для выполнения команд из Makefile
+- Пакет `paramiko` ставится автоматически в `.venv/` при первом `make deploy`
+  (таргет `venv`), либо вручную: `pip install paramiko`
+
+### Для Windows
+
+- **WinSCP** — установите с официального сайта (<https://winscp.net/>)
+- **Make** — можно установить через Chocolatey, MinGW или Git for Windows
+
+## Использование Makefile
+
+### Сборка сайта
+
+```bash
+make build
+```
+
+Команда генерирует сайт в папку `public/`.
+
+### Деплой сайта
+
+```bash
+# один раз экспортируем пароль SFTP (каждый раз в новой сессии)
+export SSHPASS='-Zp4ep747t25'
+make deploy
+```
+
+ЕДИНСТВЕННЫЙ способ публикации. Сначала собирает сайт, затем зеркалирует
+`public/` на сервер (`/dedinit.ru`) с удалением устаревших файлов
+(аналог `rsync --delete`):
+
+- **Unix**: `tools/deploy_sftp.py` (paramiko, SFTP + рекурсивный mirror)
+- **Windows**: WinSCP.com (скрипт `winscp_script.txt`)
+
+Если `SSHPASS` не задана — `make deploy` завершится с ошибкой и подсказкой.
+
+### Симуляция деплоя
+
+```bash
+export SSHPASS='-Zp4ep747t25'
+make deploy-dry-run
+```
+
+Собирает сайт и показывает, какие файлы будут загружены/удалены, без заливки.
+
+### Очистка
+
+```bash
+make clean
+```
+
+Команда удаляет папку `public/`.
+
+### Полная пересборка
+
+```bash
+make rebuild
+```
+
+Команда удаляет папку `public/`, затем заново собирает и деплоит сайт.
+
+### Справка
+
+```bash
+make help
+```
+
+Показывает список доступных команд.
+
+## Конфигурация
+
+Параметры подключения для Unix находятся в `tools/deploy_sftp.py`
+(переменные `DEDINIT_HOST`, `DEDINIT_PORT`, `DEDINIT_USER`, `DEDINIT_REMOTE`,
+по умолчанию — kpa39l.myjino.ru:2222 / kpa39l_dedinit / /dedinit.ru).
+На Windows — в `Makefile` и `winscp_script.txt`.
+
+При необходимости вы можете изменить эти параметры.
+
+## Настройка для Windows
+
+1. Убедиться, что WinSCP установлен в стандартную директорию
+   `C:\Program Files (x86)\WinSCP\`
+2. Файл `winscp_script.txt` содержит команды для подключения и синхронизации файлов