# 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) без вывода токена в логи.