docs: add repo rules, thinking log, and progress update for console

2026-04-15 07:57:43 +03:00
parent 8920ba10e6
commit 19bcdc5fc7
3 changed files with 316 additions and 0 deletions
@@ -0,0 +1,65 @@
+# Правила работы агента в проекте fission
+
+## ГЛАВНОЕ ПРАВИЛО
+
+**НЕ "СОВЕРШЕНСТВОВАТЬ" РАБОЧИЙ КОД БЕЗ ЯВНОГО УКАЗАНИЯ.**
+
+---
+
+## Файловая система и выполнение команд
+
+### Маппинг путей
+
+Локальная папка `~/remote_dev/` примонтирована через sshfs к `~/terra/` на ВМ `5.172.178.213`.
+Это **одна и та же файловая система**:
+
+| Локально (VS Code)              | На ВМ                         |
+|----------------------------------|-------------------------------|
+| `/home/naeel/remote_dev/fission` | `/home/naeel/terra/fission`   |
+| `/home/naeel/remote_dev/sless`   | `/home/naeel/terra/sless`     |
+| `/home/naeel/remote_dev/IoT`     | `/home/naeel/terra/IoT`       |
+
+Любой файл, сохранённый локально через VS Code, **мгновенно виден на ВМ**. SCP не нужен.
+
+### Что можно делать локально
+
+- **Редактировать файлы** — через VS Code, replace_string_in_file, create_file и т.д. Изменения сразу на ВМ.
+- **Читать файлы** — read_file, grep_search, file_search, semantic_search — всё разрешено.
+
+### Что ЗАПРЕЩЕНО локально
+
+**Все команды выполнять ИСКЛЮЧИТЕЛЬНО через SSH на ВМ:**
+
+```bash
+ssh -i ~/.ssh/naeel_vm_id_ed25519 -o StrictHostKeyChecking=no -o ConnectTimeout=10 naeel@5.172.178.213 'КОМАНДА'
+```
+
+**Причина:** локально может быть активен VPN, что вызывает сбои при выполнении сетевых команд, обращениях к кластеру, Docker и пр.
+
+Запрещено запускать локально (без ssh):
+- `go build`, `go test`, `go mod tidy`
+- `docker build`, `docker push`
+- `kubectl`, `helm`
+- `terraform`
+- `curl`, `wget` к кластерным сервисам
+- `git push`, `git pull` (git операции — через ssh на ВМ)
+- Любые bash-скрипты проекта
+
+### Формат работы
+
+1. Отредактировать файлы локально (VS Code / инструменты агента)
+2. Запустить команды через SSH на ВМ
+3. Ждать результата
+
+---
+
+## Документация
+
+Всё важное фиксировать в `doc/`:
+- `doc/thinking/` — лог рассуждений агента (обязательно)
+- `doc/progress.md` — трекер задач
+- Обновлять после каждого значимого изменения.
+
+## Git
+
+Коммитить и пушить после каждого завершённого этапа.