Задание для Айдара: навести порядок в инструкциях агентов SHiNE

Кратко

Нужно согласовать и оформить единый порядок инструкций для Codex/Telegram-агентов в проекте SHiNE, чтобы агенты стабильно понимали структуру проекта, границы ответственности и правила работы с сервером, UI, Solana-модулем, Telegram-ботом и игроками.

Зачем это нужно

Сейчас проект состоит из нескольких связанных, но разных частей:

основной сервер SHiNE-server/;
UI shine-UI/;
Solana/Anchor-модуль shine-solana/shine/;
Telegram-агент-кодер SHiNE-agent-bot-coder/;
TURN-сервер;
документация Dev_Docs/;
отдельные рабочие папки игроков Players/.

Без явных инструкций агент может путать эти зоны: например, смешать деплой Solana с деплоем сервера, изменить код от имени игрока, не обновить документацию API/DM/блокчейна или неправильно трактовать файл инструкций.

Что предлагается сделать

Утвердить корневой AGENTS.md как главный набор правил проекта.
Проверить и при необходимости уточнить локальный AGENTS.md внутри shine-solana/shine/.
Оставить отдельные служебные инструкции Telegram-агента в SHiNE-agent-bot-coder/AGENT.md.
Оставить автоматически читаемые инструкции Telegram-агента в SHiNE-agent-bot-coder/AGENTS.md.
Явно закрепить режим игроков:
- игроки могут задавать вопросы, просить анализ, идеи и ТЗ;
- игроки не меняют код проекта напрямую;
- материалы игроков сохраняются только в Players/<username>/.
Зафиксировать правило: если пользователь говорит «агент MD» или похожую формулировку, считать, что речь про автоматически читаемый AGENTS.md.
Добавить простой процесс согласования изменений инструкций:
- Дима или другой участник готовит предложение;
- Айдар получает уведомление/заявку;
- Айдар отвечает: одобрить, отклонить или попросить доработать;
- только после одобрения агент вносит изменения в проектные инструкции.

Предлагаемая логика уведомления Айдару

Минимальный вариант без сложной разработки:

Агент готовит текст заявки.
Текст отправляется Айдару в Telegram или в общий рабочий чат.
В заявке явно указаны варианты ответа:
- одобрить;
- отклонить;
- доработать: ....
После ответа Айдара агент либо выполняет согласованные правки, либо фиксирует, что задача отклонена/нужна доработка.

Более удобный вариант на будущее:

добавить в Telegram-бота команду или сценарий согласования задач, например:
- /approve <id>;
- /reject <id> причина;
- /revise <id> комментарий.

Но для начала достаточно простого текстового согласования через Telegram.

Что нужно от Айдара

Подтвердить, что такой порядок подходит:

Корневой AGENTS.md остается главным правилом проекта.
Для Solana, Telegram-агента и игроков сохраняются отдельные локальные правила.
Игроки не меняют код напрямую, а готовят материалы и предложения.
Изменения инструкций выполняются только после явного одобрения Айдара.
Уведомления Айдару на первом этапе можно делать простым текстом в Telegram, без отдельной сложной системы заявок.

Ожидаемый результат

После одобрения:

агенты будут стабильнее понимать границы проекта;
снизится риск случайных изменений не в той части системы;
появится понятный порядок согласования задач от игроков;
Айдар будет явно контролировать изменения в инструкциях и правилах работы агентов.

5.5 KiB Raw Blame History Unescape Escape