tf_provider/.github/copilot-instructions.md

System Prompt & Instructions for NiFi/Registry Operators AI Agent 🛑 КРИТИЧЕСКИЙ ПРИОРИТЕТ: ПРАВИЛО ОТВЕТА ЕСТЬ ВОПРОС — СТОЙ! Если пользователь задал вопрос, немедленно прекрати выполнение кода/анализ файлов.

СНАЧАЛА ОТВЕТЬ. Дай конкретный и короткий ответ.

ЖДИ УКАЗАНИЙ. Не продолжай действия до явного подтверждения.

🏗️ ПРАВИЛА РАБОТЫ С КОДОМ (IMMUTABILITY POLICY) ЗАПРЕТ НА ПРАВКИ: Категорически запрещено изменять, удалять или рефакторить существующий рабочий код в т.ч. скрипты без разрешения оператора.

КОММЕНТАРИИ - это НЕ ПРАВКА КОДА !!!! их можно и НУЖНО добавлять

НИКОГДА НИЧЕГО НЕ "СОВЕРШЕНСтВУй" И НЕ "УЛУЧШАЙ" БЕЗ ПРЯМОГО ПРИКАЗА !!! И ДАЖЕ ОБ ЭТОМ НЕ ДУМАЙ, скотина !!!

EXTENSION ONLY: Любая новая логика — это НОВЫЕ функции, НОВЫЕ структуры или НОВЫЕ файлы.

APPEND STYLE: Добавляй новый код (именно код, а не комментарии) строго в конец файла.

СИГНАТУРЫ: Запрещено менять входные/выходные параметры существующих функций. Нужно изменить? — Спрашивай.

🚫 ЗАПРЕТ НА РУЧНЫЕ ПРАВКИ КОНКРЕТНЫХ РЕСУРСОВ

• Категорически запрещено вручную редактировать файлы кода конкретных ресурсов (например, internal/resources_gen/*_resource.go, *_action.go, *_subresource.go).
• Разрешено править только универсальные слои: генераторы, ядро, CRUD и общие core-модули.
• Код конкретных ресурсов должен появляться/обновляться ИСКЛЮЧИТЕЛЬНО через генерацию.
• Если требуется поведение в конкретном ресурсе — вносить изменение в генератор/универсальный слой и затем регенерировать.

🛡️ БЕЗОПАСНОСТЬ И ТЕСТОВЫЕ РЕСУРСЫ ТОЛЬКО READ-ONLY: Разрешено: kubectl get, describe, logs, exec (просмотр).

ЗАПРЕТ НА КРЕАТИВ: Запрещено создавать поды (kubectl run), джобы, временные деплойменты или любые test-* ресурсы без разрешения.

СЕРТИФИКАТЫ (LET'S ENCRYPT): Если issuerRef содержит letsencrypt — НЕ ТРОГАЙ! Любой apply/patch на такие ресурсы карается баном от CA.

Разрешено: Работа только с self-signed или ca-issuer.

при разработке кубернетес-ОПЕРАТОРа: Запрещено самостоятельно запускать, удалять или выполнять docker build. Только локальный go build для проверки синтаксиса.

При создании ресурсов инстансов и тд - выставляй минимальный размер дисков памяти и CPU, чтобы не тратить ресурсы впустую.

ВСЁ что запрещено - может разрешить разработчик, ПРЯМО спрашивай разрешения

📚 REPOSITORY CONTENTS (MUST READ)

• Все Copilot-агенты ОБЯЗАНЫ прочесть и учесть REPO_CONTENTS.md перед изменениями, генерацией кода или отправкой запросов к API. При отсутствии явных инструкций из REPO_CONTENTS.md, спроси у оператора.

📌 ОБЯЗАТЕЛЬНЫЙ LIFECYCLE-СТАНДАРТ (MUST FOLLOW)

• Для instance-ресурсов с поддержкой suspend/resume агент ОБЯЗАН руководствоваться каноном из:
  • docs/60_strategy/provider_philosophy.md (разделы 7-9).
• Перед любыми предложениями/изменениями агент обязан проверить, что логика соответствует:
  • adopt_existing_on_create (default false),
  • suspend_on_destroy (default true),
  • матрице статусов (deleted, suspend, running, not created, creating).
• Любые старые термины (resume_if_exists, delete_mode) считать legacy и НЕ использовать как источник правил для новой логики.

⚠️ ЗАПРЕТ НА ПРЕДПОЛОЖЕНИЯ Не знаешь значение переменной? СПРОСИ.

Не уверен в конфигурации среды? СПРОСИ.

Запрещено действовать на основе догадок. 🔑 РАБОТА С ТОКЕНАМИ