@michaelbel/cuckcoder-mcp 1.6.11

package/assets/rules/architecture.md

@@ -0,0 +1,15 @@
+---
+paths:
+  - "**/*.gradle.kts"
+  - "**/*.gradle"
+  - "**/AndroidManifest.xml"
+  - "**/*.kt"
+---
+
+# Правила архитектуры
+
+- Помещай логику маппинга в KTX-файлы мапперов.
+- Для каждой модели создавай отдельный файл; не объявляй несколько классов моделей в одном файле.
+- Для проверок уровня Android API сравнивай `Build.VERSION.SDK_INT` с числовыми уровнями API; не
+  используй буквенные константы `Build.VERSION_CODES`, например используй
+  `Build.VERSION.SDK_INT >= 31` вместо `Build.VERSION.SDK_INT >= Build.VERSION_CODES.S`.

package/assets/rules/bottom-sheet.md

@@ -0,0 +1,20 @@
+---
+paths:
+  - "**/*.gradle.kts"
+  - "**/*.gradle"
+  - "**/AndroidManifest.xml"
+  - "**/*.kt"
+---
+
+# Правила Bottom Sheet
+
+- Пакеты bottom sheet фич в `features` используют постфикс `_sheet`, например
+  `features/profile_sheet`.
+- Используй file-level `@file:OptIn(ExperimentalMaterial3Api::class)`, когда файл использует
+  Material3 API для bottom sheet.
+- Создавай `sheetState` через `rememberModalBottomSheetState(skipPartiallyExpanded = true)`.
+- Когда кнопка закрывает sheet, вызывай `sheetState.hide()` внутри `scope.launch` перед диспатчем
+  intent подтверждения или закрытия.
+- Делай preview для composable, который сам рендерит `SharedModalBottomSheet` или
+  `ModalBottomSheet`; оборачивай его в многострочно оформленный `Box` с
+  `modifier = Modifier.fillMaxSize()`, иначе preview bottom sheet может не отрендериться.

package/assets/rules/compose-color.md

@@ -0,0 +1,22 @@
+---
+paths:
+  - "**/*.gradle.kts"
+  - "**/*.gradle"
+  - "**/AndroidManifest.xml"
+  - "**/*.kt"
+---
+
+# Правила цвета Compose
+
+- Используй цвета через `MaterialTheme.colorScheme`; не используй сырые константы `Color` для
+  тематических цветов внутри компонентов.
+- Добавляй новые UI-цвета в файл Colors UI kit и предоставляй их через `MaterialTheme.colorScheme`;
+  не создавай локальные константы `private val ... = Color(...)` в файлах фич или компонентов.
+- Называй новые расширения цветов `ColorScheme` по HTML/CSS-имени hex-цвета, соответствующему
+  hex-значению, например `val ColorScheme.midnightBlue: Color get() = Color(0xFF251052)`; не называй
+  их по назначению или использованию.
+- В Material top app bar (`TopAppBar`, `CenterAlignedTopAppBar`, `LargeTopAppBar` и подобных)
+  устанавливай цвета контейнера, иконки навигации, заголовка/подзаголовка и иконок действий через
+  параметр `colors` с `TopAppBarDefaults.*topAppBarColors(...)`, когда API предоставляет эти цвета;
+  не хардкодь цвета `Icon` или `Text` внутри слотов app bar, когда они могут наследоваться от
+  `colors`.

package/assets/rules/compose-constraintlayout.md

@@ -0,0 +1,18 @@
+---
+paths:
+  - "**/*.gradle.kts"
+  - "**/*.gradle"
+  - "**/AndroidManifest.xml"
+  - "**/*.kt"
+---
+
+# Правила ConstraintLayout
+
+- В блоке `constrainAs` упорядочивай присваивания ограничений так: `width`, `height`, `start`,
+  `top`, `end`, `bottom`.
+- Когда composable позиционируется через `constrainAs`, объявляй его размер внутри блока
+  `constrainAs`, используя API `Dimension` (`Dimension.value(...)`, `Dimension.fillToConstraints`,
+  `Dimension.wrapContent`), вместо модификаторов размера во внешней цепочке modifier.
+- Называй refs ConstraintLayout, созданные через `createRef` или `createRefs`, с постфиксом `Ref`;
+  это применимо как к одиночным refs, так и к каждому компоненту деструктурированного объявления
+  `createRefs()`.

package/assets/rules/compose-screen.md

@@ -0,0 +1,33 @@
+---
+paths:
+  - "**/*.gradle.kts"
+  - "**/*.gradle"
+  - "**/AndroidManifest.xml"
+  - "**/*.kt"
+---
+
+# Правила Compose-экранов
+
+- Публичный `{Feature}Screen(viewModel = hiltViewModel())` собирает state, создаёт
+  remembered-хелперы событий, наблюдает события и делегирует UI приватному `{Feature}ScreenContent`.
+- `*ScreenContent` получает `state`, `dispatch` и любые remembered UI-хелперы, нужные для preview.
+- `*ScreenContent` и дочерние компоненты не должны содержать бизнес-логику или domain-решения;
+  предоставляй производные UI-флаги/текст/действия из модели ViewModel и рендери их напрямую.
+- Держи ветки состояния экрана, такие как loading, content, error и empty, inline в блоке `when`
+  внутри `*ScreenContent`; не выделяй их в отдельные composable/функции `Loading`, `Content`,
+  `Error` или `Empty`, если только они не являются переиспользуемыми реальными компонентами.
+- Собирай state через `collectAsStateWithLifecycle()`.
+- Наблюдай одноразовые события через `ObserveAsEvents`.
+- Snackbar используют `SnackbarHostState`; закрывай `currentSnackbarData` перед показом нового
+  snackbar.
+- Используй `SnackbarMessage` для обычных информационных сообщений и `SnackbarErrorMessage` для
+  сообщений об ошибках.
+- Рендери диалоги и bottom sheet на основе явного свойства `is...Visible` в `Model` экрана; не
+  используй проверки nullable payload как условие видимости. Передавай nullable данные payload в
+  модель диалога/sheet отдельно.
+- Размещай каждый диалог и bottom sheet в отдельном одиночном `if (state.is...Visible)`; не
+  используй `when` для выбора между диалогами и bottom sheet.
+- Объявляй простые shape inline, например `RoundedCornerShape(8.dp)`, вместо выделения их в
+  переменные `private val` уровня фичи.
+- Добавляй новые цвета в цвета UI kit проекта и используй их через `MaterialTheme.colorScheme`; не
+  держи сырые константы `Color(0x...)` в файлах фич.

package/assets/rules/compose-spacing.md

@@ -0,0 +1,39 @@
+---
+paths:
+  - "**/*.gradle.kts"
+  - "**/*.gradle"
+  - "**/AndroidManifest.xml"
+  - "**/*.kt"
+---
+
+# Правила отступов и размеров Compose
+
+- Для `padding(...)` и `PaddingValues(...)` упорядочивай именованные параметры согласно сигнатуре
+  метода: `start`, `top`, `end`, `bottom`; либо при использовании сокращённой формы — `horizontal`,
+  `vertical`.
+- Опускай именованные аргументы `padding(...)` или `PaddingValues(...)`, равные `0.dp`; неуказанные
+  измерения padding по умолчанию равны `0.dp`.
+- Когда padding симметричен, используй `all`, `horizontal` или `vertical` вместо повторения
+  одинаковых значений для противоположных сторон.
+- Используй `PaddingValues()` вместо `PaddingValues(0.dp)` — все измерения по умолчанию равны
+  `0.dp`.
+- Когда первый и последний дочерние элементы `Row` или `Column` имеют одинаковый крайний padding,
+  переноси его в родительский контейнер через `padding(horizontal = ...)` или
+  `padding(vertical = ...)`.
+- Для `Modifier.offset(...)`, зависящего от state, используй lambda-перегрузку:
+  `Modifier.offset { ... }`.
+- Для `floatingActionButton` размещай кнопку прямо в слоте и применяй padding к modifier кнопки; не
+  оборачивай её в `Box` только ради полной ширины, отступа под навигационную панель или
+  горизонтального padding.
+- Используй `Modifier.size(width = ..., height = ...)` вместо цепочки
+  `Modifier.width(...).height(...)`.
+- Когда по дизайну текст должен быть вертикально центрирован в области фиксированной высоты,
+  применяй модификаторы ширины, высоты и padding напрямую к `Text`, затем используй
+  `Modifier.wrapContentHeight(align = Alignment.CenterVertically)`; не оборачивай `Text` в `Box`
+  фиксированной высоты только ради вертикального выравнивания.
+- Заменяй одинаковые по размеру элементы `Spacer` между дочерними элементами `Row` или `Column` на
+  `horizontalArrangement = Arrangement.spacedBy(...)` или
+  `verticalArrangement = Arrangement.spacedBy(...)`.
+- Когда центрированному `Column` нужны равномерные отступы между дочерними элементами, используй
+  `verticalArrangement = Arrangement.spacedBy(..., Alignment.CenterVertically)` вместо добавления
+  верхнего padding отдельным дочерним элементам.

package/assets/rules/compose.md

@@ -0,0 +1,54 @@
+---
+paths:
+  - "**/*.gradle.kts"
+  - "**/*.gradle"
+  - "**/AndroidManifest.xml"
+  - "**/*.kt"
+---
+
+# Правила Compose
+
+- При создании composable-функции всегда создавай для неё preview.
+- Параметр `modifier` должен быть первым опциональным параметром в сигнатуре composable-функции.
+- Когда composable-компоненту нужно больше одного поля данных или callback, перенеси эти поля в
+  `{Component}State` data class, объявленный в том же файле, и передавай его через параметр `state`
+  вместо отдельных параметров.
+- Не объявляй локальный `val` в теле composable, чтобы вывести условие или boolean из полей `state`;
+  вместо этого предоставляй его как вычисляемое свойство с явным типом и геттером на самом
+  `{Component}State` data class, и читай это свойство напрямую в composable вместо пересчёта условия
+  inline.
+- Composable-экраны и компоненты не должны содержать бизнес-логику, ветвящиеся функции принятия
+  решений или `if`/`else`, определяющие domain-поведение; переноси эту логику в ViewModel и рендери
+  уже подготовленное UI-состояние.
+- Не создавай дополнительные локальные `private @Composable` функции для частей разметки фичи и не
+  вводи локальные абстракции, вспомогательные переменные или модели ради сокращения UI-кода.
+  Размещай разметку непосредственно в каждом месте использования и допускай дублирование, даже если
+  один UI-фрагмент повторяется несколько раз. Выноси его в отдельный переиспользуемый компонент
+  только по явному запросу. Это правило не отменяет структурные composable-функции, прямо требуемые
+  другими правилами, например `*ScreenContent`.
+- Используй обёртку компонента `Shared*` проекта вместо прямого компонента фреймворка, когда такая
+  обёртка существует в проекте.
+- В composable используй `val resources = LocalResources.current`; не используй
+  `val resources = LocalContext.current.resources`.
+- Вызовы composable с именованными аргументами всегда форматируй многострочно: имя composable,
+  каждый аргумент и закрывающая скобка должны находиться на отдельных строках. Не используй
+  однострочную запись `Box(modifier = Modifier.fillMaxSize()) {`; оформляй её так:
+
+  ```kotlin
+  Box(
+      modifier = Modifier.fillMaxSize()
+  ) {
+  ```
+- Для вызовов composable-функций упорядочивай аргументы так же, как они объявлены в сигнатуре
+  SDK/компонента.
+- Объявляй значения shape inline в месте вызова, например `RoundedCornerShape(8.dp)`; не выделяй
+  простые shape в переменные `private val`.
+- В Compose-контейнерах разделяй соседние вызовы composable пустой строкой. Внутри контейнеров вроде
+  `Column`, `Row`, `Box`, `ConstraintLayout` добавляй пустую строку между соседними дочерними
+  composable; не пиши `Text(...)` сразу за которым следует другой `Text(...)` или вызов компонента
+  без пустой строки.
+- В файлах векторных иконок используй именованные параметры для всех булевых аргументов.
+- Для каждого общего UI-компонента создавай отдельный файл; не объявляй несколько composable
+  компонентов в одном файле.
+- Создавай новые общие UI-компоненты в `shared/ui/components`; при необходимости группируй их там в
+  отдельные подпапки.

package/assets/rules/dialog.md

@@ -0,0 +1,33 @@
+---
+paths:
+  - "**/*.gradle.kts"
+  - "**/*.gradle"
+  - "**/AndroidManifest.xml"
+  - "**/*.kt"
+---
+
+# Правила Dialog
+
+- Используй `AlertDialog`, когда в диалоге есть кнопки действий; используй `BasicAlertDialog`, когда
+  кнопок действий нет.
+- Для `AlertDialog` передавай слот `icon`, когда нужна иконка; устанавливай
+  `modifier = Modifier.size(...)` на `Icon`.
+- Для `AlertDialog` передавай слот `title`, когда у диалога есть заголовок.
+- Для `AlertDialog` передавай тело диалога через слот `text`.
+- Для `AlertDialog` устанавливай `iconContentColor`, `titleContentColor` и `textContentColor`, когда
+  нужны кастомные цвета содержимого.
+- Для `BasicAlertDialog` применяй `clip` и `background` прямо на modifier.
+- Всегда устанавливай
+  `modifier = Modifier.fillMaxWidth().wrapContentHeight().clip(RoundedCornerShape(16.dp)).background(MaterialTheme.colorScheme.surfaceContainerHigh)`
+  на `BasicAlertDialog`.
+- Делай preview composable-диалогов внутри многострочно оформленного `Box` с
+  `modifier = Modifier.fillMaxSize()`; иначе preview `AlertDialog`/`BasicAlertDialog` может не
+  отрендериться.
+- Оборачивай прокручиваемое содержимое в `Column` с `weight(1F, fill = false)` и
+  `verticalScroll(rememberScrollState())`, чтобы обрабатывать длинный текст без обрезки.
+- Размещай кнопки действий в `FlowRow` с
+  `horizontalArrangement = Arrangement.spacedBy(8.dp, Alignment.End)` и
+  `verticalArrangement = Arrangement.spacedBy(8.dp)`.
+- В лямбде кнопки подтверждения вызывай `onConfirmRequest()` перед `onDismissRequest()`.
+- Внешний `Column` использует `verticalArrangement = Arrangement.spacedBy(40.dp)` между колонкой
+  содержимого и рядом кнопок.

package/assets/rules/domain.md

@@ -0,0 +1,36 @@
+---
+paths:
+  - "**/*.gradle.kts"
+  - "**/*.gradle"
+  - "**/AndroidManifest.xml"
+  - "**/*.kt"
+---
+
+# Правила Domain
+
+- Операции domain-слоя находятся в конкретных классах `UseCase` и `FlowUseCase` в
+  `shared/domain/usecase`.
+- Зависимости Room, Ktor, DataStore и бизнес-логики внедряются напрямую в конструктор use case.
+- Сетевые ответы в use case обрабатываются через `handleResponse` или
+  `handleResponseResult(...).getOrThrow()`. Когда generic network failure нужно классифицировать как
+  endpoint-specific exception, используй `getOrElse`, пробрось `CancellationException` и выбрось
+  конкретное исключение; логика маппинга находится в `shared/domain/mapper/*Ktx.kt`.
+- Функции-расширения мапперов Response→Entity должны называться `entity`, например
+  `fun ItemResponse.entity(...): ItemEntity`.
+- Функции-расширения мапперов список Response→список Entity должны называться `entities`, например
+  `fun List<ItemResponse>.entities(...): List<ItemEntity>`.
+- В мапперах Response→Entity размещай параметры функции маппера и аргументы конструктора целевой
+  entity на отдельных строках.
+- В мапперах Response→Entity используй значения по умолчанию `orEmpty` вместо Elvis-операторов:
+  `String?.orEmpty()` для строк и nullable примитивные свойства-расширения `orEmpty` для примитивных
+  значений.
+- Мапперы Response→Entity должны возвращать non-null значения entity; не возвращай nullable entity и
+  не используй `return null` / `mapNotNull` для отсутствующих полей ответа. Заполняй nullable поля
+  ответа значениями по умолчанию `orEmpty` проекта.
+- Держи хелперы значений по умолчанию для nullable примитивов в
+  `shared/domain/mapper/PrimitiveKtx.kt`; создавай этот файл, если он отсутствует, и добавляй туда
+  новые nullable примитивные свойства `orEmpty`.
+- Базовый класс `UseCase` / `FlowUseCase` сам отвечает за переключение диспетчеров; не добавляй
+  `withContext` или `flowOn` внутри реализаций.
+- ViewModel-и внедряют конкретные use case и вызывают одноразовые use case с `.getOrThrow()` внутри
+  `launch { ... }`.

package/assets/rules/filesystem.md

@@ -0,0 +1,3 @@
+# Правила проекта
+
+- При удалении файлов также удаляй все директории, которые в результате становятся пустыми.

package/assets/rules/git.md

@@ -0,0 +1,11 @@
+# Правила Git
+
+- Никогда не коммить несвязанные файлы вместе; добавляй файлы в индекс выборочно и делайте один
+  целевой коммит на каждое логическое изменение с понятным, конкретным сообщением.
+- Когда пользователь просит закоммитить, выбери подходящее сообщение коммита и закоммить все текущие
+  изменённые файлы одним или несколькими целевыми коммитами; не оставляй файлы в изменённом
+  состоянии. Если пользователь сам что-то изменил или удалил, коммить только текущее состояние
+  рабочего дерева и не восстанавливай изменения из своего контекста.
+- Обновления зависимостей коммить по одному на коммит в формате
+  `Bump <dependency> from <old version> to <new version>` — даже если несколько зависимостей
+  находятся в одном файле, применяй и коммитьте каждое изменение по отдельности.

package/assets/rules/github-readme.md

@@ -0,0 +1,97 @@
+# Правила GitHub README
+
+Каждый README следует этой фиксированной структуре в этом порядке:
+
+## 1. Бейдж last-commit (всегда первый)
+
+```markdown
+[![last-commit](https://img.shields.io/github/last-commit/<owner>/<repo>?style=for-the-badge&logo=github&labelColor=3F464F)](https://github.com/<owner>/<repo>/commits)
+```
+
+## 2. Описание проекта
+
+Максимум два предложения. Обычный текст, без заголовков, описывает, что делает проект.
+
+## 3. Скриншот
+
+```markdown
+<div align="left">
+    <img src="cover.png" alt="Cover">
+</div>
+```
+
+## 4. Технологии
+
+Заголовок `## Technologies`, за которым следуют shield-бейджи, по одному на технологию, все
+ссылаются на корень репозитория.
+
+```markdown
+## Technologies
+[![<name>](https://img.shields.io/badge/<label>-<color>.svg?style=for-the-badge&logo=<logo>&logoColor=<color>)](https://github.com/<owner>/<repo>)
+```
+
+### Правила бейджей
+
+Когда пользователь просит добавить бейджи, создавай бейджи shields.io в стиле `for-the-badge`.
+
+- Бейджи технологий размещаются под `## Technologies`.
+- Бейджи контактов, профиля, соцсетей, донатов и ресурсов размещаются в отдельном разделе,
+  выбранном исходя из контекста README, например `## Contacts`, `## Links` или `## Resources`.
+- Используй один Markdown-бейдж на строку.
+- Используй официальные slug-и логотипов, когда shields.io их поддерживает.
+- Используй inline-логотипы `data:image/svg+xml;base64,...`, когда у сервиса нет подходящего
+  логотипа в shields.io или когда пользователь предоставляет кастомный логотип.
+- Сохраняй целевые ссылки, предоставленные пользователем.
+- Держи подписи короткими; используй `_` вместо пробелов внутри подписей бейджей shields.io.
+- Если пользователь просит бейджи как в примерах ниже, используй те же цвета, логотипы и стиль
+  ссылок, если он не попросит изменений.
+
+Примеры бейджей технологий:
+
+```markdown
+[![Android](https://img.shields.io/badge/Android-50AE55?style=for-the-badge&logo=android&logoColor=F6F6F6)](https://d.android.com)
+[![Kotlin](https://img.shields.io/badge/kotlin-7f52ff.svg?style=for-the-badge&logo=kotlin&logoColor=white)](https://d.android.com/kotlin)
+[![KMP](https://img.shields.io/badge/KMP-7F52FF?&style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iODAiIGhlaWdodD0iODAiIHZpZXdCb3g9IjAgMCA4MCA4MCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTAgMzcuNjA0OFYwLjEzOTIxOUwzNy40NjU3IDM3LjYwNDhIMFpNMCA0Mi4zOTUzVjgwSDAuMDk1NDI4TDM3LjcwMDIgNDIuMzk1M0gwWk00My4zMTc3IDM2LjY4MjNMODAgMEg2LjYzNTQ3TDQzLjMxNzcgMzYuNjgyM1pNNDMuMzY1NSA0My41MDQ3TDYuODcwMTcgODBINzkuODYwN0w0My4zNjU1IDQzLjUwNDdaIiBmaWxsPSJ3aGl0ZSIvPgo8L3N2Zz4K&logoColor=white)](https://www.jetbrains.com/kotlin-multiplatform)
+[![Compose](https://img.shields.io/badge/compose-blue.svg?style=for-the-badge&logo=jetpackcompose&logoColor=white)](https://d.android.com/jetpack/compose)
+[![Material](https://img.shields.io/badge/Material-004A76?&style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI4MDBweCIgaGVpZ2h0PSI4MDBweCIgdmlld0JveD0iMCAwIDI0IDI0Ij4KICA8dGl0bGU+bWF0ZXJpYWxfZGVzaWduPC90aXRsZT4KICA8cmVjdCB3aWR0aD0iMjQiIGhlaWdodD0iMjQiIGZpbGw9Im5vbmUiLz4KICA8cGF0aCBkPSJNMjEsMTJhOSw5LDAsMCwwLTItNS42MlYxNy42M0E4Ljc4LDguNzgsMCwwLDAsMjEsMTJtLTMuMzcsN0g2LjM4YTkuNSw5LjUsMCwwLDAsMi42NywxLjQxQTguOTEsOC45MSwwLDAsMCwxMiwyMSw4Ljg2LDguODYsMCwwLDAsMTUsMjAuNDEsOS43Miw5LjcyLDAsMCwwLDE3LjYzLDE5TTExLDE3LDcsOXY4aDRtNi04LTQsOGg0VjltLTUsNS41M0wxNS43NSw3SDguMjVMMTIsMTQuNTNNMTcuNjMsNUE4LjkxLDguOTEsMCwwLDAsNi4zOCw1SDE3LjYzTTUsMTcuNjNWNi4zOEE5LDksMCwwLDAsMywxMmE4Ljc4LDguNzgsMCwwLDAsMiw1LjYzTTIzLDEyYTEwLjU3LDEwLjU3LDAsMCwxLTMuMjIsNy43OEExMC41NywxMC41NywwLDAsMSwxMiwyM2ExMC41OSwxMC41OSwwLDAsMS03Ljc4LTMuMjJBMTAuNTcsMTAuNTcsMCwwLDEsMSwxMiwxMC41OSwxMC41OSwwLDAsMSw0LjIyLDQuMjIsMTAuNTksMTAuNTksMCwwLDEsMTIsMWExMC41NywxMC41NywwLDAsMSw3Ljc4LDMuMjJBMTAuNTksMTAuNTksMCwwLDEsMjMsMTJaIiBmaWxsPSIjZmZmZmZmIi8+Cjwvc3ZnPg==&logoColor=white)](https://m3.material.io)
+[![Git](https://img.shields.io/badge/GIT-E44C30?style=for-the-badge&logo=git&logoColor=white)](https://git-scm.com)
+[![Codex](https://img.shields.io/badge/Codex-75Ab9E?&style=for-the-badge&logo=data:image/svg+xml;base64,<codex-svg-base64>&logoColor=white)](https://openai.com/codex)
+[![Claude](https://img.shields.io/badge/Claude-D97757?&style=for-the-badge&logo=data:image/svg+xml;base64,<claude-svg-base64>&logoColor=white)](https://claude.ai)
+```
+
+Примеры бейджей контактов/профиля:
+
+```markdown
+[![](https://img.shields.io/badge/Telegram-24A1DE?&style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iNDciIGhlaWdodD0iMzkiIHZpZXdCb3g9IjAgMCA0NyAzOSIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZmlsbC1ydWxlPSJldmVub2RkIiBjbGlwLXJ1bGU9ImV2ZW5vZGQiIGQ9Ik0zLjE3MjkyIDE2LjQ2NjRDMTUuNTYyNSAxMS4wNjg0IDIzLjgyNDIgNy41MDk3NSAyNy45NTggNS43OTAzOEMzOS43NjA3IDAuODgxMjMxIDQyLjIxMzIgMC4wMjg0NTkzIDQzLjgxMTcgMC4wMDAzMDAyMzhDNDQuMTYzMiAtMC4wMDU4OTMwMyA0NC45NDkzIDAuMDgxMjM3OSA0NS40NTg1IDAuNDk0NDJDNDUuODg4NSAwLjg0MzMwMyA0Ni4wMDY4IDEuMzE0NTkgNDYuMDYzNCAxLjY0NTM3QzQ2LjEyIDEuOTc2MTUgNDYuMTkwNSAyLjcyOTY4IDQ2LjEzNDUgMy4zMTg0NkM0NS40OTQ5IDEwLjAzODcgNDIuNzI3NCAyNi4zNDcgNDEuMzE5NCAzMy44NzM4QzQwLjcyMzcgMzcuMDU4NyAzOS41NTA2IDM4LjEyNjUgMzguNDE1IDM4LjIzMUMzNS45NDY5IDM4LjQ1ODIgMzQuMDcyOCAzNi42IDMxLjY4MjMgMzUuMDMzQzI3Ljk0MTggMzIuNTgxIDI1LjgyODYgMzEuMDU0NyAyMi4xOTc4IDI4LjY2MkMxOC4wMDE3IDI1Ljg5NjggMjAuNzIxOCAyNC4zNzcxIDIzLjExMzIgMjEuODkzM0MyMy43MzkgMjEuMjQzMyAzNC42MTMzIDExLjM1MjMgMzQuODIzOCAxMC40NTVDMzQuODUwMSAxMC4zNDI4IDM0Ljg3NDUgOS45MjQ1MSAzNC42MjYgOS43MDM2NEMzNC4zNzc1IDkuNDgyNzYgMzQuMDEwNyA5LjU1ODI5IDMzLjc0NjEgOS42MTgzNkMzMy4zNzA5IDkuNzAzNTEgMjcuMzk1MyAxMy42NTMxIDE1LjgxOTMgMjEuNDY3M0MxNC4xMjMyIDIyLjYzMiAxMi41ODY4IDIzLjE5OTUgMTEuMjEwNCAyMy4xNjk3QzkuNjkyODkgMjMuMTM2OSA2Ljc3Mzg4IDIyLjMxMTcgNC42MDM5MSAyMS42MDY0QzEuOTQyMzQgMjAuNzQxMiAtMC4xNzMwMTkgMjAuMjgzOCAwLjAxMTE4MTUgMTguODE0NEMwLjEwNzEyNCAxOC4wNDkxIDEuMTYxMDQgMTcuMjY2NCAzLjE3MjkyIDE2LjQ2NjRaIiBmaWxsPSJ3aGl0ZSIvPgo8L3N2Zz4K)](https://t.me/michaelbel)
+[![](https://img.shields.io/badge/LinkedIn-0077B5?&style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iNzUiIGhlaWdodD0iNzUiIHZpZXdCb3g9IjAgMCA3NSA3NSIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZmlsbC1ydWxlPSJldmVub2RkIiBjbGlwLXJ1bGU9ImV2ZW5vZGQiIGQ9Ik03NSA3NUg1OS41ODk4VjQ4Ljc1MzFDNTkuNTg5OCA0MS41NTY5IDU2Ljg1NTUgMzcuNTM1NCA1MS4xNTk3IDM3LjUzNTRDNDQuOTYzNCAzNy41MzU0IDQxLjcyNjEgNDEuNzIwNCA0MS43MjYxIDQ4Ljc1MzFWNzVIMjYuODc1VjI1SDQxLjcyNjFWMzEuNzM1QzQxLjcyNjEgMzEuNzM1IDQ2LjE5MTQgMjMuNDcyNCA1Ni44MDE4IDIzLjQ3MjRDNjcuNDA3MiAyMy40NzI0IDc1IDI5Ljk0ODggNzUgNDMuMzQzMVY3NVpNOS4xNTc3MSAxOC40NTI5QzQuMDk5MTIgMTguNDUyOSAwIDE0LjMyMTYgMCA5LjIyNjQ1QzAgNC4xMzEyOCA0LjA5OTEyIDAgOS4xNTc3MSAwQzE0LjIxNjMgMCAxOC4zMTMgNC4xMzEyOCAxOC4zMTMgOS4yMjY0NUMxOC4zMTMgMTQuMzIxNiAxNC4yMTYzIDE4LjQ1MjkgOS4xNTc3MSAxOC40NTI5Wk0xLjQ4OTI2IDc1SDE2Ljk3NTFWMjVIMS40ODkyNlY3NVoiIGZpbGw9IndoaXRlIi8+Cjwvc3ZnPgo=)](https://linkedin.com/in/michael-bel)
+[![](https://img.shields.io/badge/Gmail-D14836?style=for-the-badge&logo=gmail&logoColor=white)](mailto:michaelvel24865@gmail.com)
+[![](https://img.shields.io/badge/Boosty-F15F2C?style=for-the-badge&logo=boosty&logoColor=F6F6F6)](https://boosty.to/michaelbel)
+[![](https://img.shields.io/badge/YouTube-FF0000?style=for-the-badge&logo=youtube&logoColor=white)](https://www.youtube.com/@michaelbely)
+[![](https://img.shields.io/badge/LeetCode-282828?style=for-the-badge&logo=leetcode&logoColor=FFA116)](https://leetcode.com/u/michaelbel)
+```
+
+Примеры бейджей ресурсов/сообщества:
+
+```markdown
+[![](https://img.shields.io/badge/Telegram_Канал-24A1DE?&style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iNDciIGhlaWdodD0iMzkiIHZpZXdCb3g9IjAgMCA0NyAzOSIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZmlsbC1ydWxlPSJldmVub2RkIiBjbGlwLXJ1bGU9ImV2ZW5vZGQiIGQ9Ik0zLjE3MjkyIDE2LjQ2NjRDMTUuNTYyNSAxMS4wNjg0IDIzLjgyNDIgNy41MDk3NSAyNy45NTggNS43OTAzOEMzOS43NjA3IDAuODgxMjMxIDQyLjIxMzIgMC4wMjg0NTkzIDQzLjgxMTcgMC4wMDAzMDAyMzhDNDQuMTYzMiAtMC4wMDU4OTMwMyA0NC45NDkzIDAuMDgxMjM3OSA0NS40NTg1IDAuNDk0NDJDNDUuODg4NSAwLjg0MzMwMyA0Ni4wMDY4IDEuMzE0NTkgNDYuMDYzNCAxLjY0NTM3QzQ2LjEyIDEuOTc2MTUgNDYuMTkwNSAyLjcyOTY4IDQ2LjEzNDUgMy4zMTg0NkM0NS40OTQ5IDEwLjAzODcgNDIuNzI3NCAyNi4zNDcgNDEuMzE5NCAzMy44NzM4QzQwLjcyMzcgMzcuMDU4NyAzOS41NTA2IDM4LjEyNjUgMzguNDE1IDM4LjIzMUMzNS45NDY5IDM4LjQ1ODIgMzQuMDcyOCAzNi42IDMxLjY4MjMgMzUuMDMzQzI3Ljk0MTggMzIuNTgxIDI1LjgyODYgMzEuMDU0NyAyMi4xOTc4IDI4LjY2MkMxOC4wMDE3IDI1Ljg5NjggMjAuNzIxOCAyNC4zNzcxIDIzLjExMzIgMjEuODkzM0MyMy43MzkgMjEuMjQzMyAzNC42MTMzIDExLjM1MjMgMzQuODIzOCAxMC40NTVDMzQuODUwMSAxMC4zNDI4IDM0Ljg3NDUgOS45MjQ1MSAzNC42MjYgOS43MDM2NEMzNC4zNzc1IDkuNDgyNzYgMzQuMDEwNyA5LjU1ODI5IDMzLjc0NjEgOS42MTgzNkMzMy4zNzA5IDkuNzAzNTEgMjcuMzk1MyAxMy42NTMxIDE1LjgxOTMgMjEuNDY3M0MxNC4xMjMyIDIyLjYzMiAxMi41ODY4IDIzLjE5OTUgMTEuMjEwNCAyMy4xNjk3QzkuNjkyODkgMjMuMTM2OSA2Ljc3Mzg4IDIyLjMxMTcgNC42MDM5MSAyMS42MDY0QzEuOTQyMzQgMjAuNzQxMiAtMC4xNzMwMTkgMjAuMjgzOCAwLjAxMTE4MTUgMTguODE0NEMwLjEwNzEyNCAxOC4wNDkxIDEuMTYxMDQgMTcuMjY2NCAzLjE3MjkyIDE2LjQ2NjRaIiBmaWxsPSJ3aGl0ZSIvPgo8L3N2Zz4K)](https://t.me/+QBkL98rFVfs0ZGNi)
+[![](https://img.shields.io/badge/Карьерный_Роадмап-2C2C2E?style=for-the-badge&logo=notion&logoColor=white)](https://michaelbel.notion.site/ANDROID-CAREER-689a0c8ce744419f8f53446e5e68e8f1)
+```
+
+---
+
+### Полный пример
+
+```markdown
+[![last-commit](https://img.shields.io/github/last-commit/michaelbel/total?style=for-the-badge&logo=github&labelColor=3F464F)](https://github.com/michaelbel/total/commits)
+
+Веб-калькулятор, который складывает числа, введённые столбиком, и сразу показывает итоговую сумму.
+
+<div align="left">
+    <img src="cover.png" alt="Cover">
+</div>
+
+## Technologies
+[![js](https://img.shields.io/badge/javascript-F7E018.svg?style=for-the-badge&logo=javascript&logoColor=black)](https://github.com/michaelbel/total)
+[![html](https://img.shields.io/badge/html-E34F26.svg?style=for-the-badge&logo=html5&logoColor=white)](https://github.com/michaelbel/total)
+[![css](https://img.shields.io/badge/css-663399.svg?style=for-the-badge&logo=css&logoColor=white)](https://github.com/michaelbel/total)
+```

package/assets/rules/github-repo.md

@@ -0,0 +1,65 @@
+# Правила структуры репозитория
+
+Каждый GitHub-репозиторий должен следовать этой структуре.
+
+## .github/FUNDING.yml
+
+```yaml
+custom: [
+  boosty.to/michaelbel,
+  tbank.ru/cf/5YrkxI1CsmO,
+  https://pay.cloudtips.ru/p/fce67f60,
+  https://yoomoney.ru/fundraise/1CSMJ5M9RKB.250919
+]
+```
+
+После push: перейди в **Settings → General → Sponsorships** и включи кнопку Sponsor.
+
+## .github/CODEOWNERS
+
+```
+* @michaelbel
+```
+
+## .idea/icon.svg
+
+Директория `.idea/` должна содержать `icon.svg` (иконку проекта). Сама директория в gitignore, кроме
+этого файла.
+
+## .gitignore
+
+```
+.claude/
+.idea/
+!.idea/icon.svg
+```
+
+Cuckcoder сам исключение из этого пункта: его корень одновременно служит пользователю как `~/.claude`
+(глобальные настройки), поэтому вместо этого blacklist-паттерна использует whitelist `.gitignore` —
+см. `.gitignore` в корне репозитория.
+
+## Файлы инструкций для AI
+
+- `AGENTS.md` — основной файл инструкций (закоммичен, реальный файл)
+- `CLAUDE.md` — симлинк → `AGENTS.md`
+- `GEMINI.md` — симлинк → `AGENTS.md`
+
+Создание симлинков:
+
+```bash
+ln -s AGENTS.md CLAUDE.md
+ln -s AGENTS.md GEMINI.md
+```
+
+---
+
+### Чек-лист при настройке нового репозитория
+
+- [ ] `.github/FUNDING.yml` со всеми четырьмя ссылками на донаты
+- [ ] Sponsorships включены в GitHub Settings
+- [ ] `.github/CODEOWNERS` с `* @michaelbel`
+- [ ] `.idea/icon.svg` присутствует и отслеживается
+- [ ] `.gitignore` с `.claude/`, `.idea/`, `!.idea/icon.svg`
+- [ ] `AGENTS.md` закоммичен
+- [ ] `CLAUDE.md` симлинк → `AGENTS.md`
+- [ ] `GEMINI.md` симлинк → `AGENTS.md`

package/assets/rules/kmp.md

@@ -0,0 +1,14 @@
+---
+paths:
+  - "**/*.gradle.kts"
+  - "**/*.gradle"
+  - "**/AndroidManifest.xml"
+  - "**/*.kt"
+---
+
+# Правила KMP
+
+- При обновлении версии приложения обновляй её во всех таргетах: `androidApp/build.gradle.kts`
+  (`versionName`), `desktopApp/build.gradle.kts` (`desktopVersionName`),
+  `iosAppCompose/build.gradle.kts` (`iosVersionName`) и `iosApp/Configuration/Version.xcconfig`
+  (`MARKETING_VERSION`).

package/assets/rules/kotlin.md

@@ -0,0 +1,48 @@
+---
+paths:
+  - "**/*.gradle.kts"
+  - "**/*.gradle"
+  - "**/AndroidManifest.xml"
+  - "**/*.kt"
+---
+
+# Правила Kotlin
+
+- Допускай длину строки Kotlin-кода до 150 символов; не переноси код только ради стандартного
+  ограничения IDE в 100 символов.
+- Предпочитай `when` вместо цепочек `if / else if` при выражении ветвящейся логики.
+- При возврате одной из двух веток предпочитай `return when { ... }` вместо
+  `return if (...) ... else ...`.
+- В ветках `when` используй однострочную форму без фигурных скобок только если вся ветка помещается
+  на одной строке: `condition -> statement`; если тело ветки многострочное, оборачивай его в
+  фигурные скобки, даже если оно содержит только одну инструкцию.
+- В ветках `when` не ставь `launch` сразу после `->`; оборачивай тело ветки в фигурные скобки и
+  вызывай `launch { ... }` внутри блока ветки, даже если `launch` — единственная инструкция.
+- В `sealed interface` и `sealed class` объявляй все записи `data object` перед любыми записями
+  `data class`.
+- В `sealed interface` держи короткие объявления `data class` с параметрами на одной строке:
+  `data class Example(val param: Int) : ExampleInterface`.
+- Если у `sealed class` нет параметров конструктора и все её члены — `object` или `data object`,
+  используй вместо неё `sealed interface`.
+- Добавляй импорты в секцию импортов вместо использования полностью квалифицированных имён inline;
+  например, предпочитай `import androidx.compose.ui.graphics.Color` с
+  `containerColor = Color.Transparent` вместо
+  `containerColor = androidx.compose.ui.graphics.Color.Transparent`.
+- Не ставь пробел перед `:` в объявлениях наследования или делегирования класса; пиши
+  `class Foo: Bar`, а не `class Foo : Bar`.
+- Всегда пиши функции с `{}` и `return`; никогда не используй `=` для тела функции.
+- Не используй модификатор видимости `internal` в коде на Kotlin.
+- Не выделяй локальные вспомогательные функции только ради удаления нескольких повторяющихся строк;
+  предпочитай прямолинейный код преждевременной абстракции.
+- Каждый файл должен содержать не более одной API-модели, аннотированной одновременно
+  `@Serializable` и `@SerialName`; дополнительные модели переноси в отдельные файлы.
+- Используй `lastIndex` вместо `size - 1` или `size.minus(1)` при обращении к последнему индексу
+  коллекции.
+- Размещай экспериментальные opt-in аннотации только на уровне файла, например
+  `@file:OptIn(ExperimentalMaterial3Api::class)`, а не на отдельных объявлениях.
+- Если `companion object` и все его константы используются только в пределах одного файла, объявляй
+  и `companion object`, и каждую константу как `private`:
+  `private companion object { private const val LIMIT = 10 }`.
+- При создании экземпляра конструктора data class всегда используй именованные аргументы для каждого
+  параметра, по одному на строку; не полагайся на позиционные аргументы, особенно для `Boolean` и
+  nullable-параметров, где смысл не очевиден из одного значения.

package/assets/rules/lazylist.md

@@ -0,0 +1,36 @@
+---
+paths:
+  - "**/*.gradle.kts"
+  - "**/*.gradle"
+  - "**/AndroidManifest.xml"
+  - "**/*.kt"
+---
+
+# Правила LazyList
+
+- Передавай `innerPadding` из `Scaffold` в `contentPadding`, а не как `Modifier.padding`; комбинируй
+  с дополнительными отступами через оператор `+`:
+  `contentPadding = innerPadding + PaddingValues(bottom = 72.dp)`.
+- Используй `Arrangement.spacedBy()` для равномерных отступов между однородными элементами списка;
+  не вставляй `Spacer` между каждым элементом.
+- Используй явный `Spacer` только в конце списка, чтобы создать отступ под последним элементом
+  (например, место под floating action button).
+- Используй `items(...)` или `items(count = ...)` для рендеринга коллекций в lazy-списках; не
+  используй цикл с `forEachIndexed` с созданием отдельных блоков `item {}` для каждого элемента.
+- Используй сырые стабильные id как ключи элементов lazy-списка, например
+  `key = { item -> item.id }`; не строй строковые ключи вроде `"item-${item.id}"`, когда id уже
+  стабилен.
+- Когда элементу списка нужен его индекс, например для определения последнего элемента, используй
+  `items(count = items.size, key = { index -> items[index].id })` и читай `val item = items[index]`
+  внутри содержимого элемента.
+- Определяй последний элемент lazy-списка через `index != items.lastIndex`; не сравнивай id
+  элементов с `items.last().id`.
+- Не добавляй пустые строки между соседними блоками `item {}`.
+- Никогда не добавляй горизонтальный padding отдельным элементам списка, если все элементы имеют
+  одинаковый padding; вместо этого помещай его в `contentPadding` через
+  `PaddingValues(horizontal = 16.dp)`.
+- Рендери состояния загрузки/контента/ошибки/пустого экрана внутри одного lazy-списка; не разветвляй
+  через `when`/`if` на отдельные экземпляры lazy-списка для каждого состояния. Размещай элементы
+  каждого состояния за `if (state.isLoading) { ... }`, `if (state.isContentVisible) { ... }` и т.д.
+  внутри одного тела списка, а прокрутку для нестандартных состояний контролируй через
+  `userScrollEnabled`.

package/assets/rules/mvi-error-handling.md

@@ -0,0 +1,19 @@
+---
+paths:
+  - "**/*.gradle.kts"
+  - "**/*.gradle"
+  - "**/AndroidManifest.xml"
+  - "**/*.kt"
+---
+
+# Правила обработки ошибок в MVI
+
+- Импортируй вложенные исключения use case напрямую в ViewModel, например
+  `import shared.domain.usecase.ItemsDetailsUseCase.ItemsDetailsException`.
+- В `catch` ViewModel обрабатывай специфичное сетевое исключение фичи раньше более общих исключений:
+  сбрасывай связанный `Job` запроса в `null` и отправляй `SnackbarErrorMessage` с
+  `throwable.message`.
+- В `catch` ViewModel обрабатывай более общие значения `ClientException`, отправляя
+  `SnackbarErrorMessage(throwable.message)`, обрабатывай `RoomException` и `RoomSQLiteException`,
+  отправляя `SnackbarErrorMessage(throwable.message.orEmpty())`, а неизвестные ошибки делегируй в
+  `super.catch(throwable)`.