# Правила работы агента в проекте 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

Коммитить и пушить после каждого завершённого этапа.