tf_provider/.github/pravila.md

Правила работы агента

Файловая система

~/remote_dev/ (локально) примонтирован через sshfs к ~/terra/ на ВМ — одна ФС. Файлы, сохранённые локально, мгновенно видны на ВМ. SCP не нужен.

Монтирование может слетать. Признак: файлы рассинхронизированы.

# Размонтировать
fusermount -u ~/remote_dev
# Если завис: sudo umount -l /home/naeel/remote_dev

# Примонтировать
sshfs naeel@5.172.178.213:/home/naeel/terra ~/remote_dev \
  -o cache=no -o no_readahead -o reconnect \
  -o ServerAliveInterval=15 -o ServerAliveCountMax=3 \
  -o IdentityFile=~/.ssh/naeel_vm_id_ed25519

SSH

Все команды — только через SSH на ВМ. Локально — только читать и редактировать файлы.

ssh -i ~/.ssh/naeel_vm_id_ed25519 -o StrictHostKeyChecking=no -o ConnectTimeout=10 naeel@5.172.178.213 'КОМАНДА'

Запрещено локально: go, docker, kubectl, helm, terraform, curl/wget, git push/pull, любые скрипты проекта.

Документация

• doc/thinking/ — лог рассуждений агента (обязательно)
• doc/progress.md — трекер задач
• Старые файлы doc/ не перезаписывать — новое в новых файлах с датой

Git

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

Версионирование тегами: vMAJOR.MINOR.PATCH

• Patch — любое изменение кода
• Minor — новая фича / компонент
• Major — breaking change

git tag vX.Y.Z && git push origin vX.Y.Z

Поведение агента

• Не трогать рабочий код без явного указания
• Не делать ничего сверх того, о чём явно попросили
• Деструктивные операции (kubectl delete, rm -rf, terraform destroy и др.) — только после явного подтверждения с указанием конкретных объектов
• Отвечать кратко, без вступлений, извинений, благодарностей и прочей воды