shine-solana/shine/AGENTS.md

AGENTS.md

Documentation Rule

В проекте есть спецификация пользовательской PDA-записи:

• doc/SHINE_USER_PDA_V1.md

Если меняется формат записи, сериализация, правила подписи, prev_hash, экономика лимитов или связанные ограничения create/update, этот документ нужно обновлять в том же изменении.

Language Rule

Во всем проекте использовать русский язык:

• комментарии в коде;
• тексты в файлах настроек и справочных файлах;
• сообщения и описания в коммитах;
• сопроводительные технические заметки.

Rule: Logic and Docs

Если меняется бизнес-логика смарт-контрактов, сериализация PDA, правила переводов или экономика:

1. Обновить соответствующий документ в doc/ в том же изменении.
2. Если документ сразу обновить нельзя, обязательно явно согласовать это с пользователем в чате и зафиксировать план обновления.

Rule: Git Push

Для push в удаленный репозиторий использовать токен из переменной окружения:

• GITEA_TOKEN

Push выполнять через http.extraHeader (Authorization) без вывода токена в логи.

Rule: Commit Messages

Текст commit message писать на русском языке.

Rule: UI Deploy

Деплой UI Shine Payments выполнять через Gradle из папки shine:

1. gradle deployUi
2. gradle checkUiRemote

Где смотреть детали (пути деплоя, путь Caddy, рабочие URL):

• комментарии в build.gradle (в корне shine/).