fission-console/.github/copilot-instructions.md

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

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

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