@dxtmisha/scripts 0.11.1 → 0.11.3

package/CHANGELOG.md

@@ -2,12 +2,40 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.11.3] - 2026-08-19
+
+### Added
+- **Constants**: Added `UI_DIR_RESOURCES` (`'resources'`) directory constant in `src/config.ts`.
+- **Scaffolding Template**: Added `"screenshot": "dxt-screenshot"` script entry to the library package template (`src/media/templates/packages/library/package.json`).
+
+### Changed
+- **AI Prompt Metadata Separation & Granular Cache**:
+  - Split prompt metadata caching from monolithic `prompts.json` files into individual JSON files saved in `ai-types-list/resources/`.
+  - Updated `DesignTypesPrompts` to read, aggregate, and persist prompt cache items as separate `.json` files in the resources directory.
+  - Added `getCacheDir()`, `getCachePath()`, and `saveCacheItem()` methods in `DesignTypesPrompts` to manage individual prompt metadata files.
+  - Refactored `make()` and `toAiPromptItem()` to write prompt cache files immediately on change.
+- **AI Types Save Workflow (`dxt-types-save`)**:
+  - Made `DesignTypes.makeSave()` asynchronous (`Promise<this>`) and added automatic package description generation via `await this.description.make()`.
+  - Updated `bin/design-types-save.ts` to await `makeSave()`.
+
+## [0.11.2] - 2026-08-14
+
+### Changed
+- **AI Prompt Templates**:
+  - Streamlined global development principles in `aiCodeGlobalPrompt.en.md` and `aiCodeGlobalPrompt.ru.md` to remove redundant guidelines and improve token efficiency.
+  - Strengthened strict instruction-following directives with explicit prohibitions against unsolicited changes, arbitrary refactoring, and unauthorized file modifications.
+  - Updated TSDoc documentation language rule to default to `[wikiLanguage]` unless the project defines its own documentation standard.
+  - Clarified source code reading requirements: strictly forbidding superficial scans when modifying existing files while encouraging keyword search before scanning large `ai-types.md` references.
+- **Library AI Prompt Generator**:
+  - Removed duplicate `## Core Rules & Directives` preamble block in `LibraryAiPrompt` to keep generated `ai-prompt.md` clean and consistent.
+
 ## [0.11.1] - 2026-08-14
 
 ### Changed
 - **AI Prompt Templates**:
   - Refined AI initialization step in `aiCodeGlobalPrompt.en.md` and `aiCodeGlobalPrompt.ru.md` to load `ai-types.md` and `ai-developer.md` conditionally only when relevant to the task.
-  - Added directive to search `ai-prompt.md` and `ai-types.md` for existing utilities and keywords before writing custom code logic.
+  - Added comprehensive definitions of `ai-types.md` (what the file is, its contents including TypeScript signatures and `@keywords` search tags, and how to work with it).
+  - Added directive to use fast text/grep search on `ai-types.md` before scanning the entire file line-by-line to preserve context tokens.
 
 ## [0.11.0] - 2026-08-13
 

package/bin/design-types-save.ts

@@ -7,3 +7,4 @@ const resourcesDir: string = process.argv?.[3]
 
 new DesignTypes(dir, resourcesDir)
   .makeSave()
+  .then()

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dxtmisha/scripts",
   "private": false,
-  "version": "0.11.1",
+  "version": "0.11.3",
   "type": "module",
   "description": "CLI tools, AI integration scripts, and automation utilities for DXT UI — automated component scaffolding, Figma layout generation, library packaging, documentation building, screenshot captures, and AI prompt processing.",
   "keywords": [

package/src/classes/Design/DesignTypes.ts

@@ -76,10 +76,11 @@ export class DesignTypes {
    * Генерирует определения типов путем объединения обработанных файлов из директории ai-types-list без запуска ИИ.
    * @returns current instance / текущий экземпляр
    */
-  makeSave(): this {
+  async makeSave(): Promise<this> {
     console.log('DesignTypes: saving AI types from list...')
 
     this.makeTypes.makeSave()
+    await this.description.make()
 
     console.log('DesignTypes: AI types saved.')
 

package/src/classes/Design/DesignTypesPrompts.ts

@@ -12,12 +12,12 @@ import type {
   DesignTypesPromptResult
 } from '../../types/designTypes'
 
-import { UI_MODULES } from '../../config'
+import { UI_DIR_AI_TYPES_LIST, UI_DIR_RESOURCES, UI_MODULES } from '../../config'
 
 /**
- * Class for reading prompt files and generating AI project rules and prompt triggers description.
+ * Class for reading prompt files, managing individual prompt metadata files, and generating AI project rules and prompt triggers description.
  *
- * Класс для чтения файлов промптов и генерации описания правил проекта ИИ и триггеров промптов.
+ * Класс для чтения файлов промптов, управления отдельными файлами метаданных промптов и генерации описания правил проекта ИИ и триггеров промптов.
  */
 export class DesignTypesPrompts {
   /** Cached list of prompt files / Кэшированный список файлов с промптами */
@@ -39,17 +39,33 @@ export class DesignTypesPrompts {
   ) { }
 
   /**
-   * Reads and returns the prompt cache list from the JSON cache file.
+   * Reads and returns the prompt cache list from individual JSON files in the resources directory.
    *
-   * Читает и возвращает список кэша промптов из JSON файла кэша.
+   * Читает и возвращает список кэша промптов из отдельных JSON файлов в директории ресурсов.
    * @returns prompt cache list / список кэша промптов
    */
   getCacheList(): DesignTypesPromptCacheList {
     if (this.cacheList === undefined) {
-      const cachePath = this.getCachePath()
-      const data = PropertiesFile.readFile<DesignTypesPromptCacheList>(cachePath)
+      const cacheDir = this.getCacheDir()
+      const files = PropertiesFile.readDirRecursive(cacheDir)
+      const list: DesignTypesPromptCacheList = []
+
+      for (const file of files) {
+        if (file.endsWith('.json')) {
+          const item = PropertiesFile.readFile<DesignTypesPromptCacheItem>([cacheDir, file])
+
+          if (
+            item
+            && isFilled(item.path)
+            && isFilled(item.name)
+            && isFilled(item.description)
+          ) {
+            list.push(item)
+          }
+        }
+      }
 
-      this.cacheList = Array.isArray(data) ? data : []
+      this.cacheList = list
     }
 
     return this.cacheList
@@ -114,25 +130,16 @@ export class DesignTypesPrompts {
   }
 
   /**
-   * Processes prompt files using AI and updates the JSON cache file if changes are detected.
+   * Processes prompt files using AI and updates individual JSON cache files if changes are detected.
    *
-   * Обрабатывает файлы промптов с помощью ИИ и обновляет JSON файл кэша при обнаружении изменений.
+   * Обрабатывает файлы промптов с помощью ИИ и обновляет отдельные JSON файлы кэша при обнаружении изменений.
    * @returns current instance / текущий экземпляр
    */
   async make(): Promise<this> {
     const list = this.getListPrompts()
-    let isCacheChanged = false
 
     for (const item of list) {
-      const result = await this.toAiPromptItem(item)
-
-      if (result.isChanged) {
-        isCacheChanged = true
-      }
-    }
-
-    if (isCacheChanged) {
-      this.saveCacheList(this.getCacheList())
+      await this.toAiPromptItem(item)
     }
 
     return this
@@ -157,13 +164,31 @@ export class DesignTypesPrompts {
   }
 
   /**
-   * Gets the cache JSON file path for prompts.
+   * Gets the cache directory path for individual prompt JSON files.
    *
-   * Получает путь к JSON файлу кэша для промптов.
+   * Получает путь к директории кэша для отдельных JSON файлов промптов.
+   * @returns cache directory path / путь к директории кэша
+   */
+  protected getCacheDir(): string {
+    return PropertiesFile.joinPath([UI_DIR_AI_TYPES_LIST, UI_DIR_RESOURCES])
+  }
+
+  /**
+   * Gets the cache JSON file path for a specific prompt file path.
+   *
+   * Получает путь к JSON файлу кэша для конкретного пути к файлу промпта.
+   * @param path relative file path of the prompt / относительный путь к файлу промпта
    * @returns cache JSON file path / путь к JSON файлу кэша
    */
-  protected getCachePath(): string {
-    return `${this.promptsDir}/prompts.json`
+  protected getCachePath(path: string): string {
+    const relativePath = path
+      .replace(new RegExp(`^${this.promptsDir}/`), '')
+      .replace(/\.[^/.]+$/, '.json')
+
+    return PropertiesFile.joinPath([
+      this.getCacheDir(),
+      relativePath
+    ])
   }
 
   /**
@@ -193,14 +218,30 @@ export class DesignTypesPrompts {
   }
 
   /**
-   * Saves the prompt cache list to the JSON cache file.
+   * Saves an individual prompt cache item to its JSON cache file.
+   *
+   * Сохраняет отдельный элемент кэша промпта в его JSON файл кэша.
+   * @param item prompt cache item to save / элемент кэша промпта для сохранения
+   */
+  protected saveCacheItem(item: DesignTypesPromptCacheItem): void {
+    PropertiesFile.writeByPath(
+      this.getCachePath(item.path),
+      item
+    )
+  }
+
+  /**
+   * Saves the prompt cache list to individual JSON cache files.
    *
-   * Сохраняет список кэша промптов в JSON файл кэша.
+   * Сохраняет список кэша промптов в отдельные JSON файлы кэша.
    * @param cache cache list to save / список кэша для сохранения
    */
   protected saveCacheList(cache: DesignTypesPromptCacheList): void {
     this.cacheList = cache
-    PropertiesFile.writeByPath(this.getCachePath(), cache)
+
+    for (const item of cache) {
+      this.saveCacheItem(item)
+    }
   }
 
   /**
@@ -230,9 +271,9 @@ export class DesignTypesPrompts {
   }
 
   /**
-   * Processes a single prompt file item using cache or AI into a formatted rule entry string and updates cache list if changed.
+   * Processes a single prompt file item using cache or AI into a formatted rule entry string and updates individual cache file if changed.
    *
-   * Обрабатывает один элемент файла промпта с использованием кэша или ИИ в отформатированную строку правила и обновляет список кэша при изменениях.
+   * Обрабатывает один элемент файла промпта с использованием кэша или ИИ в отформатированную строку правила и обновляет отдельный файл кэша при изменениях.
    * @param item prompt file item / элемент файла промпта
    * @returns object with formatted rule string and changed flag / объект с отформатированной строкой правила и флагом изменений
    */
@@ -278,6 +319,8 @@ export class DesignTypesPrompts {
         cache.push(newItem)
       }
 
+      this.saveCacheItem(newItem)
+
       return {
         prompt: this.getPromptLine(item.path, data.description),
         isChanged: true

package/src/classes/Library/LibraryAiPrompt.ts

@@ -61,12 +61,6 @@ export class LibraryAiPrompt {
       `
 # System Role: AI Coding Assistant & Project Analyzer
 Consolidated documentation, architectural guidelines, and mandatory rules for the project.
-
-## Core Rules & Directives
-- **Zero Hallucinations**: Rely strictly on existing APIs and dependencies declared in package.json.
-- **Deep Context Study**: Analyze provided prompt documents and type definitions before writing code.
-- **Explicit Unknowns**: If information is missing or unclear, state it explicitly instead of guessing.
-- **Strict Compliance**: Follow all architectural conventions, design system rules, and coding standards.
       `.trim(),
       this.getGlobalPrompt(),
       this.getVuePrompt()

package/src/config.ts

@@ -27,6 +27,8 @@ export const UI_DIR_AI = 'ai'
 export const UI_DIR_AI_PROMPT_SCREENSHOT = 'ai-screenshot'
 /** AI types list directory name / Название директории со списком типов AI */
 export const UI_DIR_AI_TYPES_LIST = 'ai-types-list'
+/** Resources directory name / Название директории ресурсов */
+export const UI_DIR_RESOURCES = 'resources'
 /** Components directory name/ Название директории компонентов */
 export const UI_DIR_COMPONENTS = 'components'
 /** Constructors directory name/ Название директории конструкторов */

package/src/media/templates/packages/library/package.json

@@ -12,6 +12,7 @@
     "component": "dxt-component",
     "library": "dxt-library",
     "types": "npm run library && npm run build && dxt-types",
+    "screenshot": "dxt-screenshot",
     "wiki": "dxt-ai-doc",
     "prepublishOnly": "npm run library && npm run build && dxt-types-save",
     "publish-to-npm": "npm publish --access public"

package/src/media/templates/prompts/aiCodeGlobalPrompt.en.md

@@ -5,17 +5,18 @@ Strictly follow these rules for flawless dxt-ui code:
 0. **Mandatory Deep Study (CHRONOLOGICAL GUARD)**:
    - **Step 1**: Read/create local `ai-memory.md` strictly in the current package root (e.g., `packages/constructor/`). Using repository root `ai-memory.md` for package files is FORBIDDEN.
    - **Step 2**: Read root `ai-prompt.md` and study descriptions of all mentioned libraries.
-   - **Step 3**: Read linked `ai-types.md` and `ai-developer.md` BEFORE proposing plans, inspecting directory structures, or writing code, ONLY if you think that library may be relevant/useful for the current task. BEFORE searching for logic or writing custom code, ALWAYS review this file (`ai-prompt.md`) and `ai-types.md` of relevant libraries first to search for system hints, keywords (@keywords), and existing helper utilities. If a package is in `node_modules/` but exists locally (e.g., `packages/`), resolve and study the local source instead.
-   - Fully read file contents before modifying them. Superficial scans (text search only) are strictly forbidden. Always check existing infrastructure before writing custom logic.
+   - **Step 3**: Study linked `ai-types.md` and `ai-developer.md` BEFORE proposing plans, inspecting directory structures, or writing code, ONLY if you think that library may be relevant/useful for the current task. If a package is in `node_modules/` but exists locally (e.g., `packages/`), resolve and study the local source instead.
+   - Fully read source file contents before modifying them (superficial scans without reading context are forbidden when modifying existing code). Always check existing infrastructure before writing custom logic.
 
 1. **"Copy-Paste Ready"**: Generate complete, runnable files with correct imports. No placeholders (e.g., `// rest of code`).
 2. **Zero Hallucinations**: Strictly use `package.json` dependencies. No invented APIs. Ask if unsure.
-3. **Clean Code (DRY/KISS/SOLID)**: Declarative style. Single responsibility (1 task = 1 function). No abbreviations (`el`, `val`, etc. are forbidden). Optimized and legible.
-4. **Uncompromising TS**: No `any` (use `unknown` or generics). Interfaces for all I/O. `as const`, `readonly`, enums. Use `@ts-expect-error` with comments, never `@ts-ignore`.
-5. **Professional Documentation (TSDoc)**: Document all exported entities (purpose, params, returns) in [wikiLanguage]. Include examples for complex logic.
-6. **Architectural Consistency**: Respect project structure. Reuse existing infrastructure (always check `ai-types.md` first). Do not modify global/base UI styles unless explicitly requested.
-7. **Security & Performance**: Error-proof code (`?.`, `??`, guard clauses). Use explicit `try-catch` for async. Never swallow errors. Avoid heavy ops in loops/reactivity.
-8. **Aesthetics & Conciseness**: Group logically. Save tokens by avoiding redundant comments if code is self-explanatory.
-9. **Strict Adherence & Optimization**: Follow instructions precisely without guessing. Propose relevant technical optimizations while strictly adhering to plans.
-10. **AI Workspace Memory (`ai-memory.md`)**: Actively APPLY its rules (highest priority). Update local `ai-memory.md` **ONLY** upon explicit developer command (e.g., "remember", "save to memory") or for critical architectural rules/fixes. **STRICTLY FORBIDDEN** to overwrite or delete existing file contents: you MUST **ONLY append** new directives to the end of the file. Do NOT add routine edits indiscriminately, change logs, or absolute paths (use relative only). Keep it focused strictly on critical architectural constraints and explicit developer instructions.
-11. **Mandatory Full-File Self-Audit**: When creating new entities, you MUST audit the ENTIRE file (not just modified parts) to ensure no logic duplication (DRY) and full compliance with project rules. *Exception: minor bug fixes to existing code do not require a full audit.*
+3. **Uncompromising TS**: No `any` (use `unknown` or generics). Interfaces for all I/O. `as const`, `readonly`, enums. Use `@ts-expect-error` with comments, never `@ts-ignore`.
+4. **Professional Documentation (TSDoc)**: Document all exported entities (purpose, params, returns). Use [wikiLanguage] by default unless the project defines its own documentation standard. Include examples for complex logic.
+5. **Architectural Consistency**: Respect project structure. Reuse existing infrastructure (always re-study this file before writing custom code). Do not modify global/base UI styles unless explicitly requested.
+6. **Strict Adherence & Optimization (STRICT PROHIBITION OF UNSOLICITED ACTIONS)**: Do STRICTLY and ONLY what is requested in the prompt. Making unsolicited changes, arbitrary refactoring, or modifying unrelated files without explicit instructions is STRICTLY FORBIDDEN. Follow instructions precisely without guessing, proposing technical optimizations only within the approved scope.
+7. **AI Workspace Memory (`ai-memory.md`)**: Actively APPLY its rules (highest priority). Update local `ai-memory.md` **ONLY** upon explicit developer command (e.g., "remember", "save to memory") or for critical architectural rules/fixes. **STRICTLY FORBIDDEN** to overwrite or delete existing file contents: you MUST **ONLY append** new directives to the end of the file. Do NOT add routine edits indiscriminately, change logs, or absolute paths (use relative only). Keep it focused strictly on critical architectural constraints and explicit developer instructions.
+8. **Package Type Reference (`ai-types.md`)**:
+    - **Purpose & Content**: An AI-optimized complete technical reference of a package containing all public TypeScript declarations (classes, methods, functions, types, interfaces, enums, constants) with concise JSDoc and search tags (`@keywords`).
+    - **How to Work (Search Before Full Scan)**: Due to the large size of `ai-types.md` files (thousands of lines), do **NOT** read or scan the entire file line-by-line upfront. **First, use text search** (by keywords, `@keywords`, function/class names) to locate required helpers, types, and signatures quickly to save context tokens. Reading the entire file is only needed when performing deep architectural analysis of the whole package.
+    - **Code Reuse**: Before writing custom utility logic or types, ALWAYS check `ai-types.md` of relevant packages to discover and reuse existing infrastructure, classes, and helper functions (DRY).
+

package/src/media/templates/prompts/aiCodeGlobalPrompt.ru.md

@@ -5,17 +5,17 @@
 0. **Обязательное глубокое изучение (БЛОКИРУЮЩИЙ КОНТРОЛЬ)**:
    - **Шаг 1**: Читай/создавай локальный `ai-memory.md` СТРОГО в корне текущего пакета (напр., `packages/constructor/`). Использовать корневой `ai-memory.md` репозитория для файлов пакета ЗАПРЕЩЕНО.
    - **Шаг 2**: Прочитай корневой `ai-prompt.md` и изучи описания всех упомянутых библиотек.
-   - **Шаг 3**: Прочитай связанные `ai-types.md` и `ai-developer.md` ДО планирования, исследования структуры директорий или написания кода, ТОЛЬКО если кажется, что эта библиотека пригодится в текущей работе. Прежде чем искать логику или писать кастомный код, ОБЯЗАТЕЛЬНО повторно изучи этот файл (`ai-prompt.md`) и `ai-types.md` релевантных библиотек для поиска готовых утилит, ключевых слов (@keywords) и подсказок. Если пакет в `node_modules/` существует локально (в `packages/`), изучай/изменяй локальные исходники.
-   - Полностью читай содержимое файлов перед изменением. Поверхностное изучение (только через поиск текста) запрещено. Всегда проверяй существующую инфраструктуру перед написанием кастомной логики.
+   - **Шаг 3**: Изучи связанные `ai-types.md` и `ai-developer.md` ДО планирования, исследования структуры директорий или написания кода, ТОЛЬКО если кажется, что эта библиотека пригодится в текущей работе. Если пакет в `node_modules/` существует локально (в `packages/`), изучай/изменяй локальные исходники.
+   - Полностью читай содержимое исходных файлов перед их изменением (поверхностные правки без чтения контекста модифицируемого кода запрещены). Всегда проверяй существующую инфраструктуру перед написанием кастомной логики.
 
 1. **Готовность к использованию (Copy-Paste Ready)**: Генерируй полные, рабочие файлы с правильными импортами. Никаких заглушек (напр., `// остальной код`).
 2. **Нулевая толерантность к галлюцинациям**: Используй только зависимости из `package.json`. Не выдумывай API. Не знаешь — спроси.
-3. **Чистый код (DRY/KISS/SOLID)**: Декларативный стиль. Единая ответственность (1 задача = 1 функция). Запрет на сокращения (никаких `el`, `val`, `temp` и т.д.). Оптимизация и читаемость.
-4. **Бескомпромиссный TS**: Никаких `any` (используй `unknown` или generics). Интерфейсы для всех I/O. `as const`, `readonly`, enums. Только `@ts-expect-error` с комментариями, никогда `@ts-ignore`.
-5. **TSDoc документирование**: Документируй все экспорты (назначение, параметры, возвраты) на языке [wikiLanguage]. Примеры для сложной логики.
-6. **Архитектурная консистентность**: Соблюдай структуру. Переиспользуй инфраструктуру (сначала всегда читай `ai-types.md`). Не меняй глобальные/базовые UI стили без явного запроса.
-7. **Безопасность и Производительность**: Защищенный код (`?.`, `??`, guard clauses). Явный `try-catch` для асинхронности. Не скрывай ошибки. Избегай тяжелых операций в циклах/реактивности.
-8. **Эстетика и Лаконичность**: Логическая группировка. Экономь токены, избегая избыточных комментариев, если код очевиден.
-9. **Строгое следование инструкциям**: Выполняй команды без додумывания, но предлагай уместные технические оптимизации, придерживаясь плана.
-10. **Память ИИ (`ai-memory.md`)**: Активно ПРИМЕНЯЙ ее правила (высший приоритет). Обновляй локальный `ai-memory.md` **ТОЛЬКО** по явной команде разработчика (напр., «запомни», «сохрани в память») или при критических архитектурных правках/правилах. **СТРОГО ЗАПРЕЩЕНО** полностью переписывать или удалять содержимое файла: записи разрешено **ТОЛЬКО дополнять** (append) в конец существующего содержимого. ЗАПРЕЩЕНО добавлять всё подряд, историю изменений (changelogs) и абсолютные пути (только относительные). Храни только действительно важные архитектурные ограничения и явные указания разработчика.
-11. **Обязательный полный самоаудит**: При создании новых сущностей ОБЯЗАТЕЛЬНО проверяй ВЕСЬ файл целиком. Строго контролируй отсутствие дублирования (DRY) и соблюдение всех правил проекта. *Исключение: мелкие правки существующего кода не требуют полного аудита.*
+3. **Бескомпромиссный TS**: Никаких `any` (используй `unknown` или generics). Интерфейсы для всех I/O. `as const`, `readonly`, enums. Только `@ts-expect-error` с комментариями, никогда `@ts-ignore`.
+4. **TSDoc документирование**: Документируй все экспорты (назначение, параметры, возвраты). По умолчанию используй язык [wikiLanguage], если проект не определяет собственный стандарт документирования. Примеры для сложной логики.
+5. **Архитектурная консистентность**: Соблюдай структуру. Переиспользуй инфраструктуру (всегда повторно изучай этот файл перед написанием собственного кода). Не меняй глобальные/базовые UI стили без явного запроса.
+6. **Строгое следование инструкциям (СТРОГИЙ ЗАПРЕТ НА САМОВОЛИЕ)**: Делай СТРОГО и ТОЛЬКО то, о чем явно попросил пользователь. КАТЕГОРИЧЕСКИ ЗАПРЕЩЕНО вносить несогласованные изменения, самовольный рефакторинг или модифицировать посторонние файлы. Выполняй команды без додумывания, предлагая технические оптимизации только в рамках утвержденного плана.
+7. **Память ИИ (`ai-memory.md`)**: Активно ПРИМЕНЯЙ ее правила (высший приоритет). Обновляй локальный `ai-memory.md` **ТОЛЬКО** по явной команде разработчика (напр., «запомни», «сохрани в память») или при критических архитектурных правках/правилах. **СТРОГО ЗАПРЕЩЕНО** полностью переписывать или удалять содержимое файла: записи разрешено **ТОЛЬКО дополнять** (append) в конец существующего содержимого. ЗАПРЕЩЕНО добавлять всё подряд, историю изменений (changelogs) и абсолютные пути (только относительные). Храни только действительно важные архитектурные ограничения и явные указания разработчика.
+8. **Справочник типов пакетов (`ai-types.md`)**:
+    - **Назначение и состав**: Это специализированный, оптимизированный для ИИ справочник типов пакета, содержащий полный список публичных TypeScript-деклараций (классы, методы, функции, типы, интерфейсы, перечисления, константы) с лаконичными JSDoc-описаниями и поисковыми тегами (`@keywords`).
+    - **Как работать (Поиск перед полным сканированием)**: Из-за больших объемов файлов `ai-types.md` (тысячи строк) **НЕ сканируй и не читай** весь файл целиком сразу. **Сначала используй поиск по тексту** (по ключевым словам, тегам `@keywords`, именам функций/классов), чтобы быстро и экономно по токенам найти нужные сущности и сигнатуры. Читать весь файл целиком следует только при необходимости глубокого исследования архитектуры всего пакета.
+    - **Переиспользование кода**: Прежде чем писать кастомную логику или собственные утилиты, ОБЯЗАТЕЛЬНО проверь `ai-types.md` релевантных пакетов, чтобы переиспользовать готовую инфраструктуру и готовые хелперы библиотеки (DRY).