Этот документ является единственным источником истины для правил, которые должны соблюдаться в кодовой базе. Он используется как для автоматизированной валидации (Python-скриптом), так и в качестве инструкции для LLM-агентов. Каждый `.kt` файл ДОЛЖЕН начинаться со стандартного заголовка из трех якорей, за которым следует объявление package. Заголовок служит 'паспортом' файла, позволяя инструментам мгновенно понять его расположение, имя и назначение. .*?)\n//\s*\[SEMANTICS\]\s*(?P.*)]]> Содержимое якоря [SEMANTICS] ДОЛЖНО состоять из ключевых слов, выбранных из предопределенного списка (таксономии). Устраняет неоднозначность и обеспечивает консистентность тегирования по всему проекту. uidomaindatapresentation viewmodelusecaserepositoryservicescreencomponentdialogmodelentityactivityapplicationnav_hostcontrollernavigation_drawerscaffolddashboarditemlabellocationsetupthemedependenciescustom_fieldstatisticsimageattachmentitem_creationitem_detaileditem_summaryitem_updatesummaryupdate networkingdatabasecachingauthenticationvalidationparsingstate_managementnavigationditestingentrypointhilttimbercomposeactionsroutescommoncolor_selectionloadinglistdetailseditlabel_managementlabels_listdialog_managementlocationssealed_stateparallel_data_loadingtimber_loggingdialogcolortypographybuilddata_transfer_objectdtoapiitem_creationitem_detaileditem_summaryitem_updatecreatemappercountuser_setupauthentication_flow sealed_classsealed_interface ui_logicui_statedata_modelimmutable Каждая ключевая сущность (class, interface, fun и т.д.) ДОЛЖНА быть обернута в парные якоря [ENTITY]...[END_ENTITY]. Превращает плоский текстовый файл в иерархическое дерево семантических узлов для надежного парсинга AI-инструментами. \w+)\('(?P.*?)'\)\]]]> ) : LabelsListUiState // [END_ENTITY: DataClass('Success')] ]]> Крупные, не относящиеся к конкретной сущности блоки файла, также должны быть обернуты в парные якоря. Четко разграничивает секции файла, позволяя инструментам работать с ними изолированно (например, 'добавить новый импорт в блок IMPORTS'). // [IMPORTS]// [END_IMPORTS] // [CONTRACT]// [END_CONTRACT] Каждый файл должен заканчиваться специальным закрывающим якорем, который сигнализирует о его полном завершении. Служит надежным маркером конца файла, защищая от случайного усечения и упрощая парсинг. Традиционные, 'человеческие' комментарии (`// ...` или `/* ... */`) КАТЕГОРИЧЕСКИ ЗАПРЕЩЕНЫ. Такие комментарии являются 'семантическим шумом' для AI, неструктурированы и не могут быть использованы для автоматического анализа. Единственным исключением из правила 'NoStrayComments' является специальный, структурированный якорь для заметок между AI-агентами. Позволяет оставлять пояснения к сложным архитектурным решениям в машиночитаемом формате.