@nitra/cursor 12.12.0 → 12.14.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [12.14.0] - 2026-06-26
+
+### Changed
+
+- Заміна picomatch на ignore для обробки glob-ів у docgen та resolve-target-files
+
+## [12.13.0] - 2026-06-26
+
+### Changed
+
+- Заміна рекурсивного обходу файлів на використання globby для пошуку файлів
+
 ## [12.12.0] - 2026-06-25
 
 ### Changed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "12.12.0",
+  "version": "12.14.0",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",
@@ -54,6 +54,8 @@
   },
   "dependencies": {
     "@7n/mt": "^0.5.1",
+    "globby": "^16.0.0",
+    "ignore": "^7.0.5",
     "oxc-parser": "^0.137.0",
     "picomatch": "^4.0.4",
     "smol-toml": "^1.7.0",

package/rules/bun/docs/index.md

@@ -6,6 +6,6 @@ resource: npm/rules/bun/
 
 # npm/rules/bun
 
-| Файл | Тип |
-|---|---|
+| Файл                | Тип       |
+| ------------------- | --------- |
 | [main.mjs](main.md) | JS Module |

package/rules/bun/js/docs/index.md

@@ -6,7 +6,7 @@ resource: npm/rules/bun/js/
 
 # npm/rules/bun/js
 
-| Файл | Тип |
-|---|---|
+| Файл                            | Тип       |
+| ------------------------------- | --------- |
 | [fix-layout.mjs](fix-layout.md) | JS Module |
-| [layout.mjs](layout.md) | JS Module |
+| [layout.mjs](layout.md)         | JS Module |

package/rules/bun/main.mjs

@@ -38,7 +38,9 @@ function runLicenseeSteps(cwd = process.cwd(), opts = {}) {
   const configPath = join(cwd, '.licensee.json')
   if (!existsSync(configPath)) {
     if (readOnly) {
-      fail('lint-bun: licensee — немає .licensee.json; запустіть `npx @nitra/cursor fix bun` локально для генерації (bun.mdc)')
+      fail(
+        'lint-bun: licensee — немає .licensee.json; запустіть `npx @nitra/cursor fix bun` локально для генерації (bun.mdc)'
+      )
       return reporter.getExitCode()
     }
     writeFileSync(configPath, DEFAULT_LICENSEE_CONFIG, 'utf8')

package/rules/changelog/js/docs/index.md

@@ -6,7 +6,7 @@ resource: npm/rules/changelog/js/
 
 # npm/rules/changelog/js
 
-| Файл | Тип |
-|---|---|
-| [consistency.mjs](consistency.md) | JS Module |
+| Файл                                      | Тип       |
+| ----------------------------------------- | --------- |
+| [consistency.mjs](consistency.md)         | JS Module |
 | [fix-consistency.mjs](fix-consistency.md) | JS Module |

package/rules/doc-files/js/docgen-ignore.mjs

@@ -1,5 +1,5 @@
 /** @see ./docs/docgen-ignore.md */
-import picomatch from 'picomatch'
+import ignore from 'ignore'
 
 /** Базовий список glob-ів для `docgen` ignore. */
 export const DOCGEN_IGNORE_GLOBS = Object.freeze([
@@ -22,7 +22,7 @@ export const DOCGEN_IGNORE_GLOBS = Object.freeze([
   'npm/rules/k8s/js/manifests.mjs'
 ])
 
-const IGNORE_MATCHERS = DOCGEN_IGNORE_GLOBS.map(glob => picomatch(glob, { dot: true }))
+const ig = ignore().add(DOCGEN_IGNORE_GLOBS)
 
 /**
  * Нормалізує відносний шлях до posix-формату для glob-matching.
@@ -36,7 +36,7 @@ function toPosixRelPath(relPath) {
 /**
  * Перевіряє, чи шлях має бути пропущений `docgen`.
  * Для `kind = 'dir'` це працює і на піддерево каталогу, тож glob на кшталт
- * `**\\/demo/**` спрацьовує на `demo/x` під час рекурсивного обходу.
+ * `**\/demo/**` спрацьовує на `demo/x` під час рекурсивного обходу.
  * @param {string} relPath відносний шлях від кореня проєкту
  * @param {'path'|'dir'} [kind] тип перевірки (за замовчуванням `'path'`)
  * @returns {boolean} `true`, якщо шлях ігнорується
@@ -47,7 +47,8 @@ export function isDocgenIgnored(relPath, kind = 'path') {
   }
   const posixRelPath = toPosixRelPath(relPath)
   if (kind === 'dir') {
-    return IGNORE_MATCHERS.some(match => match(posixRelPath) || match(`${posixRelPath}/__docgen__`))
+    // `**/demo/**` не матчить `demo` напряму — перевіряємо фіктивний файл всередині
+    return ig.ignores(posixRelPath) || ig.ignores(`${posixRelPath}/__docgen__`)
   }
-  return IGNORE_MATCHERS.some(match => match(posixRelPath))
+  return ig.ignores(posixRelPath)
 }

package/rules/doc-files/js/docs/docgen-ignore.md

@@ -3,7 +3,7 @@ type: JS Module
 title: docgen-ignore.mjs
 resource: npm/rules/doc-files/js/docgen-ignore.mjs
 docgen:
-  crc: c17cd785
+  crc: 00687334
   score: 100
 ---
 

package/rules/js/js/docs/index.md

@@ -6,10 +6,10 @@ resource: npm/rules/js/js/
 
 # npm/rules/js/js
 
-| Файл | Тип |
-|---|---|
-| [check.mjs](check.md) | JS Module |
-| [dep-policy.mjs](dep-policy.md) | JS Module |
+| Файл                                  | Тип       |
+| ------------------------------------- | --------- |
+| [check.mjs](check.md)                 | JS Module |
+| [dep-policy.mjs](dep-policy.md)       | JS Module |
 | [lint-findings.mjs](lint-findings.md) | JS Module |
-| [tooling.mjs](tooling.md) | JS Module |
+| [tooling.mjs](tooling.md)             | JS Module |
 | [utils_imports.mjs](utils_imports.md) | JS Module |

package/rules/js-run/js/docs/index.md

@@ -6,7 +6,7 @@ resource: npm/rules/js-run/js/
 
 # npm/rules/js-run/js
 
-| Файл | Тип |
-|---|---|
+| Файл                              | Тип       |
+| --------------------------------- | --------- |
 | [fix-runtime.mjs](fix-runtime.md) | JS Module |
-| [runtime.mjs](runtime.md) | JS Module |
+| [runtime.mjs](runtime.md)         | JS Module |

package/rules/python/docs/index.md

@@ -6,6 +6,6 @@ resource: npm/rules/python/
 
 # npm/rules/python
 
-| Файл | Тип |
-|---|---|
+| Файл                | Тип       |
+| ------------------- | --------- |
 | [main.mjs](main.md) | JS Module |

package/rules/python/main.mjs

@@ -128,7 +128,9 @@ export function runLintPythonSteps(cwd = process.cwd(), opts = {}) {
       return true
     }
     const r = spawnSync(uvPath, ['run', '--frozen', 'pip-licenses', '--from=mixed', '--format=spdx-json'], {
-      cwd: cwdPath, stdio: ['ignore', 'pipe', 'inherit'], shell: false,
+      cwd: cwdPath,
+      stdio: ['ignore', 'pipe', 'inherit'],
+      shell: false
     })
     if (r.status !== 0) {
       failF('lint-python: pip-licenses — помилка виконання')
@@ -136,7 +138,11 @@ export function runLintPythonSteps(cwd = process.cwd(), opts = {}) {
     }
     const allowed = getBronzeAndAbove()
     let doc
-    try { doc = JSON.parse(r.stdout.toString('utf8')) } catch { doc = null }
+    try {
+      doc = JSON.parse(r.stdout.toString('utf8'))
+    } catch {
+      doc = null
+    }
     const packages = doc?.packages ?? []
     const violations = packages.filter(pkg => {
       const lic = pkg.licenseDeclared ?? pkg.licenseConcluded ?? 'NOASSERTION'

package/rules/rust/docs/index.md

@@ -6,6 +6,6 @@ resource: npm/rules/rust/
 
 # npm/rules/rust
 
-| Файл | Тип |
-|---|---|
+| Файл                | Тип       |
+| ------------------- | --------- |
 | [main.mjs](main.md) | JS Module |

package/rules/rust/main.mjs

@@ -89,7 +89,9 @@ function runRustLint(cwd = process.cwd(), opts = {}) {
   const denyConfigPath = join(cwd, 'deny.toml')
   if (!existsSync(denyConfigPath)) {
     if (readOnly) {
-      fail('lint-rust: cargo deny — немає deny.toml; запустіть `npx @nitra/cursor fix rust` локально для генерації (rust.mdc)')
+      fail(
+        'lint-rust: cargo deny — немає deny.toml; запустіть `npx @nitra/cursor fix rust` локально для генерації (rust.mdc)'
+      )
     } else {
       writeFileSync(denyConfigPath, generateDenyTomlLicenses(), 'utf8')
       pass('lint-rust: cargo deny — створено deny.toml з дефолтним allowlist')

package/rules/style/js/docs/index.md

@@ -6,7 +6,7 @@ resource: npm/rules/style/js/
 
 # npm/rules/style/js
 
-| Файл | Тип |
-|---|---|
+| Файл                              | Тип       |
+| --------------------------------- | --------- |
 | [fix-tooling.mjs](fix-tooling.md) | JS Module |
-| [tooling.mjs](tooling.md) | JS Module |
+| [tooling.mjs](tooling.md)         | JS Module |

package/scripts/docs/index.md

@@ -6,18 +6,18 @@ resource: npm/scripts/
 
 # npm/scripts
 
-| Файл | Тип |
-|---|---|
-| [auto-rules.mjs](auto-rules.md) | JS Module |
-| [auto-skills.mjs](auto-skills.md) | JS Module |
-| [build-agents-commands.mjs](build-agents-commands.md) | JS Module |
-| [cli-entry.mjs](cli-entry.md) | JS Module |
+| Файл                                                                                | Тип       |
+| ----------------------------------------------------------------------------------- | --------- |
+| [auto-rules.mjs](auto-rules.md)                                                     | JS Module |
+| [auto-skills.mjs](auto-skills.md)                                                   | JS Module |
+| [build-agents-commands.mjs](build-agents-commands.md)                               | JS Module |
+| [cli-entry.mjs](cli-entry.md)                                                       | JS Module |
 | [ensure-nitra-cursor-dev-dependencies.mjs](ensure-nitra-cursor-dev-dependencies.md) | JS Module |
-| [hook.mjs](hook.md) | JS Module |
-| [post-tool-use-check.mjs](post-tool-use-check.md) | JS Module |
-| [rename-yaml-extensions.mjs](rename-yaml-extensions.md) | JS Module |
-| [skills-cli.mjs](skills-cli.md) | JS Module |
-| [sync-claude-config.mjs](sync-claude-config.md) | JS Module |
-| [sync-setup-bun-deps-action.mjs](sync-setup-bun-deps-action.md) | JS Module |
-| [update-blue-oak.mjs](update-blue-oak.md) | JS Module |
-| [upgrade-nitra-cursor-and-install.mjs](upgrade-nitra-cursor-and-install.md) | JS Module |
+| [hook.mjs](hook.md)                                                                 | JS Module |
+| [post-tool-use-check.mjs](post-tool-use-check.md)                                   | JS Module |
+| [rename-yaml-extensions.mjs](rename-yaml-extensions.md)                             | JS Module |
+| [skills-cli.mjs](skills-cli.md)                                                     | JS Module |
+| [sync-claude-config.mjs](sync-claude-config.md)                                     | JS Module |
+| [sync-setup-bun-deps-action.mjs](sync-setup-bun-deps-action.md)                     | JS Module |
+| [update-blue-oak.mjs](update-blue-oak.md)                                           | JS Module |
+| [upgrade-nitra-cursor-and-install.mjs](upgrade-nitra-cursor-and-install.md)         | JS Module |

package/scripts/lib/discover-checkable-rules.mjs

@@ -17,6 +17,7 @@
 import { existsSync } from 'node:fs'
 import { readdir } from 'node:fs/promises'
 import { join } from 'node:path'
+import { globby } from 'globby'
 
 /**
  * @typedef {object} JsConcern
@@ -44,20 +45,12 @@ import { join } from 'node:path'
  */
 async function listJsConcerns(jsDir) {
   if (!existsSync(jsDir)) return []
-  const entries = await readdir(jsDir, { withFileTypes: true })
-  /** @type {JsConcern[]} */
-  const concerns = []
-  for (const entry of entries) {
-    if (!entry.isFile()) continue
-    if (!entry.name.endsWith('.mjs')) continue
-    if (entry.name.endsWith('.test.mjs')) continue
-    if (entry.name.startsWith('fix-')) continue
-    if (entry.name.startsWith('_')) continue
-    if (entry.name.startsWith('.')) continue
-    const name = entry.name.slice(0, -'.mjs'.length)
-    concerns.push({ name })
-  }
-  return concerns.toSorted((a, b) => a.name.localeCompare(b.name))
+  const files = await globby(['*.mjs', '!*.test.mjs', '!fix-*.mjs', '!_*'], {
+    cwd: jsDir,
+    onlyFiles: true,
+    gitignore: false
+  })
+  return files.map(f => ({ name: f.slice(0, -4) })).toSorted((a, b) => a.name.localeCompare(b.name))
 }
 
 /**

package/scripts/lib/docs/index.md

@@ -6,39 +6,39 @@ resource: npm/scripts/lib/
 
 # npm/scripts/lib
 
-| Файл | Тип |
-|---|---|
-| [assert-project-root.mjs](assert-project-root.md) | JS Module |
-| [blue-oak.mjs](blue-oak.md) | JS Module |
-| [changed-files.mjs](changed-files.md) | JS Module |
-| [check-reporter.mjs](check-reporter.md) | JS Module |
-| [diff-added-lines.mjs](diff-added-lines.md) | JS Module |
+| Файл                                                                        | Тип       |
+| --------------------------------------------------------------------------- | --------- |
+| [assert-project-root.mjs](assert-project-root.md)                           | JS Module |
+| [blue-oak.mjs](blue-oak.md)                                                 | JS Module |
+| [changed-files.mjs](changed-files.md)                                       | JS Module |
+| [check-reporter.mjs](check-reporter.md)                                     | JS Module |
+| [diff-added-lines.mjs](diff-added-lines.md)                                 | JS Module |
 | [discover-check-rules-from-cursor.mjs](discover-check-rules-from-cursor.md) | JS Module |
-| [discover-checkable-rules.mjs](discover-checkable-rules.md) | JS Module |
-| [ensure-tool.mjs](ensure-tool.md) | JS Module |
-| [generated-markdown.mjs](generated-markdown.md) | JS Module |
-| [gha-workflow.mjs](gha-workflow.md) | JS Module |
-| [inline-template-links.mjs](inline-template-links.md) | JS Module |
-| [list-project-rules-mdc.mjs](list-project-rules-mdc.md) | JS Module |
-| [list-rule-ids.mjs](list-rule-ids.md) | JS Module |
-| [load-cursor-config.mjs](load-cursor-config.md) | JS Module |
-| [mirror-parity.mjs](mirror-parity.md) | JS Module |
-| [read-n-cursor-config-lite.mjs](read-n-cursor-config-lite.md) | JS Module |
-| [resolve-target-files.mjs](resolve-target-files.md) | JS Module |
-| [root-notice.mjs](root-notice.md) | JS Module |
-| [rule-meta-helpers.mjs](rule-meta-helpers.md) | JS Module |
-| [rule-meta.mjs](rule-meta.md) | JS Module |
-| [rule-predicates.mjs](rule-predicates.md) | JS Module |
-| [run-conftest-batch.mjs](run-conftest-batch.md) | JS Module |
-| [run-lint-step.mjs](run-lint-step.md) | JS Module |
-| [run-lint.mjs](run-lint.md) | JS Module |
-| [run-rule-cli.mjs](run-rule-cli.md) | JS Module |
-| [run-rule.mjs](run-rule.md) | JS Module |
-| [run-standard-lint.mjs](run-standard-lint.md) | JS Module |
-| [run-standard-rule.mjs](run-standard-rule.md) | JS Module |
-| [skill-meta.mjs](skill-meta.md) | JS Module |
-| [sync-gitignore-worktree.mjs](sync-gitignore-worktree.md) | JS Module |
-| [template.mjs](template.md) | JS Module |
-| [timing-summary.mjs](timing-summary.md) | JS Module |
-| [workspaces.mjs](workspaces.md) | JS Module |
-| [worktree-notice.mjs](worktree-notice.md) | JS Module |
+| [discover-checkable-rules.mjs](discover-checkable-rules.md)                 | JS Module |
+| [ensure-tool.mjs](ensure-tool.md)                                           | JS Module |
+| [generated-markdown.mjs](generated-markdown.md)                             | JS Module |
+| [gha-workflow.mjs](gha-workflow.md)                                         | JS Module |
+| [inline-template-links.mjs](inline-template-links.md)                       | JS Module |
+| [list-project-rules-mdc.mjs](list-project-rules-mdc.md)                     | JS Module |
+| [list-rule-ids.mjs](list-rule-ids.md)                                       | JS Module |
+| [load-cursor-config.mjs](load-cursor-config.md)                             | JS Module |
+| [mirror-parity.mjs](mirror-parity.md)                                       | JS Module |
+| [read-n-cursor-config-lite.mjs](read-n-cursor-config-lite.md)               | JS Module |
+| [resolve-target-files.mjs](resolve-target-files.md)                         | JS Module |
+| [root-notice.mjs](root-notice.md)                                           | JS Module |
+| [rule-meta-helpers.mjs](rule-meta-helpers.md)                               | JS Module |
+| [rule-meta.mjs](rule-meta.md)                                               | JS Module |
+| [rule-predicates.mjs](rule-predicates.md)                                   | JS Module |
+| [run-conftest-batch.mjs](run-conftest-batch.md)                             | JS Module |
+| [run-lint-step.mjs](run-lint-step.md)                                       | JS Module |
+| [run-lint.mjs](run-lint.md)                                                 | JS Module |
+| [run-rule-cli.mjs](run-rule-cli.md)                                         | JS Module |
+| [run-rule.mjs](run-rule.md)                                                 | JS Module |
+| [run-standard-lint.mjs](run-standard-lint.md)                               | JS Module |
+| [run-standard-rule.mjs](run-standard-rule.md)                               | JS Module |
+| [skill-meta.mjs](skill-meta.md)                                             | JS Module |
+| [sync-gitignore-worktree.mjs](sync-gitignore-worktree.md)                   | JS Module |
+| [template.mjs](template.md)                                                 | JS Module |
+| [timing-summary.mjs](timing-summary.md)                                     | JS Module |
+| [workspaces.mjs](workspaces.md)                                             | JS Module |
+| [worktree-notice.mjs](worktree-notice.md)                                   | JS Module |

package/scripts/lib/docs/resolve-target-files.md

@@ -3,7 +3,7 @@ type: JS Module
 title: resolve-target-files.mjs
 resource: npm/scripts/lib/resolve-target-files.mjs
 docgen:
-  crc: a3b361d9
+  crc: 4d3546e6
 ---
 
 Цей файл відповідає за перевірку наявності файлів, що відповідають певним правилам, вказаним у файлах `policy/<name>/target.json`. Він створює список файлів для подальшого використання, використовуючи або конкретні відносні шляхи, або обхід каталогу з використанням шаблонів та ігнорування файлів. Це забезпечує узгодженість та контроль над файлами, які потрібно обробити, відповідно до заданих політик.
@@ -16,7 +16,7 @@ docgen:
 4.  **Завантаження ігнорування:** Завантажує список абсолютних шляхів, які слід ігнорувати, з конфігурації `.n-cursor.json:ignore`.
 5.  **Кешування обходу:** Використовує кеш обходу дерева (Map) для запобігання повторному обходу одного й того ж набору ігнорування. Якщо обхід вже виконано для заданого набору ігнорування, повертає результат з кешу.
 6.  **Обхід дерева:** Якщо обхід не кешований або кеш порожній, виконує обхід дерева файлів від заданого кореня, використовуючи `walkDir`. Під час обходу генерує відносні шляхи файлів від кореня.
-7.  **Фільтрація за масками:** Для кожного відносного шляху файлу застосовує маски `walkGlob` за допомогою `picomatch`. Фільтрує файли, які відповідають маскам, та виключає ті, що відповідають негативним маскам.
+7.  **Фільтрація за масками:** Для кожного відносного шляху файлу застосовує маски `walkGlob` за допомогою `ignore`. Фільтрує файли, які відповідають маскам, та виключає ті, що відповідають негативним маскам.
 8.  **Збіг з ігноруванням:** Перевіряє, чи файл не входить до списку ігнорування.
 9.  **Збіг шляху:** Перетворює відносні шляхи файлів у абсолютні шляхи, додавши корень.
 10. **Повернення результатів:** Повертає масив абсолют
@@ -29,7 +29,7 @@ resolveTargetFiles — Знаходить файли, що вказані в `ta
 
 - **Контракт на поліси:** Зчитуються лише файли з репозиторію.
 - **`single`:** Якщо `existsSync`, повертається список файлів, що відповідають `single`. Інакше, повертається порожній список.
-- **`walkGlob`:** Використовується picomatch для обробки glob-шаблонів відносно шляхів, отриманих з обходу `walkDir` від `root`.
+- **`walkGlob`:** Використовується ignore для обробки glob-шаблонів відносно шляхів, отриманих з обходу `walkDir` від `root`.
 - **Ігнорування:** Підтримується ігнорування файлів за допомогою `.n-cursor.json:ignore` та кешування шляхів ігнорування у `walkCache`.
 - **Кешування:** Результати обходу кешуються для повторного використання при однаковому наборі ігнорувань.
 - **Path-traversal:** При розв'язанні шляхів у формі `single` виникає помилка.

package/scripts/lib/fix/discover-t0-patterns.mjs

@@ -6,42 +6,13 @@
  * `t0.mjs` ініціалізує результат через top-level await (один раз при завантаженні модуля).
  */
 import { existsSync } from 'node:fs'
-import { readdir } from 'node:fs/promises'
 import { join } from 'node:path'
+import { globby } from 'globby'
 
 /**
  * @typedef {{ id: string, test: (output: string) => boolean, apply: (output: string, cwd: string) => Promise<{ok: boolean, action: string}> | {ok: boolean, action: string} }} T0Pattern
  */
 
-/**
- * Повертає абсолютні шляхи до `fix-*.mjs` файлів у директорії (плоско, без рекурсії).
- * @param {string} dir абсолютний шлях до директорії
- * @returns {Promise<string[]>}
- */
-async function findFixFiles(dir) {
-  if (!existsSync(dir)) return []
-  const entries = await readdir(dir, { withFileTypes: true })
-  return entries
-    .filter(e => e.isFile() && e.name.startsWith('fix-') && e.name.endsWith('.mjs'))
-    .map(e => join(dir, e.name))
-}
-
-/**
- * Повертає абсолютні шляхи до `policy/{concern}/fix-*.mjs` у правилі.
- * @param {string} policyDir абсолютний шлях `rules/{rule}/policy/`
- * @returns {Promise<string[]>}
- */
-async function findPolicyFixFiles(policyDir) {
-  if (!existsSync(policyDir)) return []
-  const entries = await readdir(policyDir, { withFileTypes: true })
-  const paths = []
-  for (const entry of entries) {
-    if (!entry.isDirectory()) continue
-    paths.push(...(await findFixFiles(join(policyDir, entry.name))))
-  }
-  return paths
-}
-
 /**
  * Збирає всі T0-паттерни з `fix-*.mjs` файлів усіх правил у `rulesDir`.
  * @param {string} rulesDir абсолютний шлях до `npm/rules/`
@@ -49,26 +20,22 @@ async function findPolicyFixFiles(policyDir) {
  */
 export async function discoverT0Patterns(rulesDir) {
   if (!existsSync(rulesDir)) return []
-  const ruleEntries = await readdir(rulesDir, { withFileTypes: true })
-  /** @type {T0Pattern[]} */
-  const allPatterns = []
-
-  for (const ruleEntry of ruleEntries) {
-    if (!ruleEntry.isDirectory() || ruleEntry.name.startsWith('.')) continue
-    const ruleDir = join(rulesDir, ruleEntry.name)
 
-    const fixPaths = [
-      ...(await findFixFiles(join(ruleDir, 'js'))),
-      ...(await findPolicyFixFiles(join(ruleDir, 'policy')))
-    ]
+  const relPaths = await globby(['*/js/fix-*.mjs', '*/policy/*/fix-*.mjs'], {
+    cwd: rulesDir,
+    onlyFiles: true,
+    gitignore: false
+  })
 
-    for (const fixPath of fixPaths) {
-      try {
-        const mod = await import(fixPath)
-        if (Array.isArray(mod.patterns)) allPatterns.push(...mod.patterns)
-      } catch (err) {
-        console.error(`[discover-t0-patterns] не вдалося імпортувати ${fixPath}: ${err.message}`)
-      }
+  /** @type {T0Pattern[]} */
+  const allPatterns = []
+  for (const rel of relPaths) {
+    const fixPath = join(rulesDir, rel)
+    try {
+      const mod = await import(fixPath)
+      if (Array.isArray(mod.patterns)) allPatterns.push(...mod.patterns)
+    } catch (err) {
+      console.error(`[discover-t0-patterns] не вдалося імпортувати ${fixPath}: ${err.message}`)
     }
   }
 

package/scripts/lib/fix/docs/index.md

@@ -6,16 +6,16 @@ resource: npm/scripts/lib/fix/
 
 # npm/scripts/lib/fix
 
-| Файл | Тип |
-|---|---|
-| [analyze-escalation.mjs](analyze-escalation.md) | JS Module |
-| [discover-t0-patterns.mjs](discover-t0-patterns.md) | JS Module |
-| [escalation-log.mjs](escalation-log.md) | JS Module |
-| [llm-fix-apply.mjs](llm-fix-apply.md) | JS Module |
-| [llm-lint-fix.mjs](llm-lint-fix.md) | JS Module |
-| [llm-worker.mjs](llm-worker.md) | JS Module |
-| [orchestrator.mjs](orchestrator.md) | JS Module |
+| Файл                                                  | Тип       |
+| ----------------------------------------------------- | --------- |
+| [analyze-escalation.mjs](analyze-escalation.md)       | JS Module |
+| [discover-t0-patterns.mjs](discover-t0-patterns.md)   | JS Module |
+| [escalation-log.mjs](escalation-log.md)               | JS Module |
+| [llm-fix-apply.mjs](llm-fix-apply.md)                 | JS Module |
+| [llm-lint-fix.mjs](llm-lint-fix.md)                   | JS Module |
+| [llm-worker.mjs](llm-worker.md)                       | JS Module |
+| [orchestrator.mjs](orchestrator.md)                   | JS Module |
 | [run-conformance-check.mjs](run-conformance-check.md) | JS Module |
-| [t0.mjs](t0.md) | JS Module |
-| [verbose-block.mjs](verbose-block.md) | JS Module |
-| [vscode-ext-add.mjs](vscode-ext-add.md) | JS Module |
+| [t0.mjs](t0.md)                                       | JS Module |
+| [verbose-block.mjs](verbose-block.md)                 | JS Module |
+| [vscode-ext-add.mjs](vscode-ext-add.md)               | JS Module |

package/scripts/lib/fix/docs/llm-worker.md

@@ -3,26 +3,31 @@ type: JS Module
 title: llm-worker.mjs
 resource: npm/scripts/lib/fix/llm-worker.mjs
 docgen:
-  crc: 55419474
+  crc: 5d019a98
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
 ## Огляд
 
-Модуль виділяє унікальні відносні шляхи файлів, пов'язаних із порушеннями. Він також виконує роботу з великою мовною моделлю для аналізу даних про порушення, зчитуючи правила та обробляючи відповідні файли.
+Модуль виділяє унікальні відносні шляхи файлів, пов'язаних із порушеннями, та виконує LLM-виклик для виправлення одного rule-порушення. Підтримує вибір sub-check `.mdc` за конкретним target-файлом — замість повного `n-{id}.mdc` передає моделі лише релевантну секцію правила (1–2 KB замість 20+ KB).
 
 ## Поведінка
 
-extractFilePaths витягує унікальні відносні шляхи файлів із вихідних даних про порушення, розпізнаючи як явні файли, що потребують виправлення, так і файли, що надають контекст.
-runLlmWorker викликає LLM для виправлення одного порушення, зчитує відповідне правило, аналізує файли, формує промпт, отримує відповідь від моделі та застосовує виправлення.
+`extractFilePaths` витягує унікальні відносні шляхи файлів із violation output, пріоритетно розбираючи рядки ❌ (файли що потребують фіксу), потім generic-regex для контексту. Розуміє workspace-prefix `[npm] path/file.ext → npm/path/file.ext`.
+
+`selectSubCheckMdc` читає `policy/<concern>/target.json` з каталогу `npm/rules/{ruleId}/` пакету, знаходить concerns із `files.single`, що відповідають failing-файлам із violation output, і повертає конкатенацію відповідних `.mdc`. Повертає `null` якщо правило не має policy-підкаталогу або жоден concern не збігається з ❌-файлами.
+
+`runLlmWorker` спочатку викликає `selectSubCheckMdc` — і якщо отримує match, передає моделі лише той sub-check `.mdc`. Якщо match немає — fallback на повний `n-{id}.mdc`. Далі читає файли з violation output, будує prompt, викликає LLM через `callLlmRich` і застосовує зміни.
 
 ## Публічний API
 
-extractFilePaths — виділяє відносні шляхи файлів з виводу помилок, обробляючи префікс робочого простору та пріоритетно парсячи рядки, що вказують на необхідність виправлення.
-runLlmWorker — виправляє одне порушення правила за допомогою LLM, повертаючи результати змін чи діагнозу, що слугує інформацією для наступних етапів процесу.
+`extractFilePaths(output)` — повертає унікальні відносні шляхи файлів з violation output (❌-рядки першими).
+
+`runLlmWorker(ruleId, violationOutput, projectRoot, opts)` — виправляє одне порушення правила через LLM. Повертає `{ ok, error?, changes, diagnosis, reasoning, reasoningSource, promptSummary }`. `promptSummary.subCheckMdc: boolean` вказує чи використано точковий sub-check замість повного mdc.
 
 ## Гарантії поведінки
 
-- Read-only: не виконує операцій запису (ФС/БД).
-- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
+- Читає `policy/` безпосередньо з пакету (`import.meta.dirname/../../../rules/`), без pre-generation файлів.
+- Fallback на повний `n-{id}.mdc` при: відсутності policy-підкаталогу, `walkGlob`-таргетах, відсутності ❌-файлів у violation, нульовому match.
+- Перехоплює всі помилки LLM і повертає структурований `{ ok: false, error }`.

package/scripts/lib/fix/llm-worker.mjs

@@ -1,6 +1,6 @@
 /** @see ./docs/llm-worker.md */
 
-import { existsSync, readFileSync } from 'node:fs'
+import { existsSync, readdirSync, readFileSync } from 'node:fs'
 import { join } from 'node:path'
 import { env } from 'node:process'
 import { resolveModel } from '../../../lib/models.mjs'
@@ -20,6 +20,83 @@ const API_KEY_RE = /api key/i
 
 const FILE_EXTS = 'json|js|mjs|ts|vue|yml|yaml|toml|mdc|md|sh|py'
 
+/**
+ * Каталог `npm/rules/` у пакеті — для вибору sub-check .mdc.
+ * Шлях: <package>/npm/scripts/lib/fix/ → ../../.. → npm/ → rules/.
+ */
+const PACKAGE_RULES_DIR = join(import.meta.dirname, '..', '..', '..', 'rules')
+
+/**
+ * Витягує шляхи файлів лише з рядків ❌ у violation output.
+ * Без workspace-розгортання — повертає bare path для звірки з target.json.
+ * @param {string} output violation output
+ * @returns {string[]} унікальні шляхи з ❌-рядків
+ */
+function extractFailPaths(output) {
+  const seen = new Set()
+  const add = p => {
+    seen.add(p)
+  }
+  const failSep = `(?::\\d+)?(?::\\s|[\\s—]|$)`
+  // ❌ [ws] path/file.ext → strip workspace, зберігаємо bare file
+  const failWsRe = new RegExp(`^\\s*❌\\s+\\[[\\w-]+\\]\\s+([\\w./][\\w./-]*\\.(?:${FILE_EXTS}))${failSep}`, 'gm')
+  for (const m of output.matchAll(failWsRe)) add(m[1])
+  const failRe = new RegExp(`^\\s*❌\\s+(\\.?[\\w][\\w./-]*\\.(?:${FILE_EXTS}))${failSep}`, 'gm')
+  for (const m of output.matchAll(failRe)) add(m[1])
+  return [...seen]
+}
+
+/**
+ * Для правил з `policy/<concern>/` підбирає лише ті concern-.mdc, що відповідають
+ * файлам з ❌-рядків violation output. Читає безпосередньо з пакету (`PACKAGE_RULES_DIR`),
+ * тому не потребує pre-generation. Fallback — null (→ повний n-{id}.mdc у caller).
+ * @param {string} ruleId ID правила
+ * @param {string} violationOutput violation output
+ * @returns {string|null} конкатенація релевантних .mdc або null
+ */
+function selectSubCheckMdc(ruleId, violationOutput) {
+  const policyDir = join(PACKAGE_RULES_DIR, ruleId, 'policy')
+  if (!existsSync(policyDir)) return null
+
+  const failPaths = extractFailPaths(violationOutput)
+  if (failPaths.length === 0) return null
+
+  const matched = []
+  let concerns
+  try {
+    concerns = readdirSync(policyDir, { withFileTypes: true })
+  } catch {
+    return null
+  }
+
+  for (const entry of concerns) {
+    if (!entry.isDirectory()) continue
+    const concernDir = join(policyDir, entry.name)
+    const targetPath = join(concernDir, 'target.json')
+    if (!existsSync(targetPath)) continue
+
+    let target
+    try {
+      target = JSON.parse(readFileSync(targetPath, 'utf8'))
+    } catch {
+      continue
+    }
+
+    const targetFile = target?.files?.single
+    if (!targetFile) continue // walkGlob та інші типи → skip, fallback на main.mdc
+
+    // Перевіряємо чи хоч один failing path закінчується на targetFile
+    const hit = failPaths.some(p => p === targetFile || p.endsWith(`/${targetFile}`))
+    if (!hit) continue
+
+    const mdcEntry = readdirSync(concernDir).find(f => f.endsWith('.mdc'))
+    if (!mdcEntry) continue
+    matched.push(readFileSync(join(concernDir, mdcEntry), 'utf8').trim())
+  }
+
+  return matched.length > 0 ? matched.join('\n\n') : null
+}
+
 /**
  * Витягує відносні шляхи файлів із violation output.
  * Розуміє workspace-prefix: `[npm] skills/foo.mjs` → `npm/skills/foo.mjs`.
@@ -185,9 +262,11 @@ export function runLlmWorker(ruleId, violationOutput, projectRoot, opts = {}) {
   const timeoutMs = opts.timeoutMs
   const thinkingBudget = opts.thinkingBudget ?? DEFAULT_THINKING_BUDGET
 
-  // 1. Читаємо rule .mdc
+  // 1. Читаємо rule .mdc: спробуємо sub-check mdc для конкретної перевірки,
+  //    якщо не вдалося — fallback на повний n-{id}.mdc.
+  const subMdc = selectSubCheckMdc(ruleId, violationOutput)
   const mdcPath = join(projectRoot, '.cursor', 'rules', `n-${ruleId}.mdc`)
-  const ruleMdc = existsSync(mdcPath) ? readFileSync(mdcPath, 'utf8') : '(rule file not found)'
+  const ruleMdc = subMdc ?? (existsSync(mdcPath) ? readFileSync(mdcPath, 'utf8') : '(rule file not found)')
 
   // 2. Витягуємо файли з violation output і читаємо їх
   const files = readFilesForFix(extractFilePaths(violationOutput), projectRoot)
@@ -195,6 +274,7 @@ export function runLlmWorker(ruleId, violationOutput, projectRoot, opts = {}) {
   // 3. Будуємо summary промпту (для verbose-блоку) до виклику моделі
   const promptSummary = {
     ruleMdcLen: ruleMdc.length,
+    subCheckMdc: !!subMdc,
     violationLen: violationOutput.length,
     filesCount: files.length,
     filesTotalBytes: files.reduce((s, f) => s + f.content.length, 0),

package/scripts/lib/inline-template-links.mjs

@@ -1,6 +1,7 @@
 import { existsSync } from 'node:fs'
-import { readFile, readdir } from 'node:fs/promises'
+import { readFile } from 'node:fs/promises'
 import { basename, extname, join } from 'node:path'
+import { globby } from 'globby'
 
 const MD_LINK_RE = /\[([^\]]{1,200})\]\((\.\/[^)]{1,500})\)/g
 const TEMPLATE_SEGMENT_RE = /\/templates?\//
@@ -80,27 +81,18 @@ export async function appendDiscoveredMdcFiles(text, ruleDir) {
 
   const jsDir = join(ruleDir, 'js')
   if (existsSync(jsDir)) {
-    const entries = await readdir(jsDir, { withFileTypes: true })
-    for (const e of entries.sort((a, b) => a.name.localeCompare(b.name))) {
-      if (e.isFile() && e.name.endsWith('.mdc')) {
-        sections.push((await readFile(join(jsDir, e.name), 'utf8')).trim())
-      }
+    const files = await globby('*.mdc', { cwd: jsDir, onlyFiles: true, gitignore: false })
+    for (const f of files.toSorted()) {
+      sections.push((await readFile(join(jsDir, f), 'utf8')).trim())
     }
   }
 
   const policyDir = join(ruleDir, 'policy')
   if (existsSync(policyDir)) {
-    const concerns = (await readdir(policyDir, { withFileTypes: true }))
-      .filter(e => e.isDirectory())
-      .sort((a, b) => a.name.localeCompare(b.name))
-    for (const concern of concerns) {
-      const concernDir = join(policyDir, concern.name)
-      const files = (await readdir(concernDir, { withFileTypes: true }))
-        .filter(e => e.isFile() && e.name.endsWith('.mdc'))
-        .sort((a, b) => a.name.localeCompare(b.name))
-      for (const f of files) {
-        sections.push((await readFile(join(concernDir, f.name), 'utf8')).trim())
-      }
+    // '*/*.mdc' → 'concern/file.mdc'; рядкове сортування дає concern-first, потім file
+    const files = await globby('*/*.mdc', { cwd: policyDir, onlyFiles: true, gitignore: false })
+    for (const rel of files.toSorted()) {
+      sections.push((await readFile(join(policyDir, rel), 'utf8')).trim())
     }
   }
 

package/scripts/lib/list-project-rules-mdc.mjs

@@ -3,9 +3,9 @@
  * Винесено зі `bin/n-cursor.js`, щоб ділити між CLI-dispatch і `run-conformance-check` (конформність-детект).
  */
 import { existsSync } from 'node:fs'
-import { readdir } from 'node:fs/promises'
 import { join } from 'node:path'
 import { cwd as processCwd } from 'node:process'
+import { globby } from 'globby'
 
 /** Каталог правил у проєкті-споживачі (відносно кореня). */
 export const CURSOR_RULES_DIR = '.cursor/rules'
@@ -17,6 +17,6 @@ export const CURSOR_RULES_DIR = '.cursor/rules'
 export async function listProjectRulesMdcFiles(cwd = processCwd()) {
   const dir = join(cwd, CURSOR_RULES_DIR)
   if (!existsSync(dir)) return []
-  const names = await readdir(dir)
-  return names.filter(n => n.endsWith('.mdc')).toSorted((a, b) => a.localeCompare(b))
+  const names = await globby('*.mdc', { cwd: dir, onlyFiles: true, gitignore: false })
+  return names.toSorted((a, b) => a.localeCompare(b))
 }

package/scripts/lib/resolve-target-files.mjs

@@ -4,7 +4,7 @@
  * Дві форми у `target.json:files`:
  *   - `{ "single": "<rel>" }` — конкретний відносний шлях. Якщо `existsSync(root/single)` → `[single]`;
  *     інакше `[]` (caller сам вирішує fail vs silent skip за `required`).
- *   - `{ "walkGlob": <glob | glob[]> }` — picomatch проти posix-відносних шляхів, отриманих обходом
+ *   - `{ "walkGlob": <glob | glob[]> }` — `ignore` проти posix-відносних шляхів, отриманих обходом
  *     `walkDir` від `root` із загальними skip-ами та `.n-cursor.json:ignore`. Обхід кешований у
  *     `walkCache` (Map ключ — підпис ignorePaths) — повторні таргети з тим самим набором ignore
  *     перевикористовують список без нового readdir.
@@ -15,7 +15,7 @@
 import { existsSync } from 'node:fs'
 import { isAbsolute, join, normalize, relative, sep } from 'node:path'
 
-import picomatch from 'picomatch'
+import ignore from 'ignore'
 
 import { loadCursorIgnorePaths } from './load-cursor-config.mjs'
 import { walkDir } from '../utils/walkDir.mjs'
@@ -96,14 +96,8 @@ export async function resolveTargetFiles(filesSpec, root, walkCache) {
     const ignorePaths = await loadCursorIgnorePaths(root)
     const all = await getAllFilesCached(root, ignorePaths, walkCache)
     const globs = Array.isArray(filesSpec.walkGlob) ? filesSpec.walkGlob : [filesSpec.walkGlob]
-    // picomatch у масиві трактує `!neg` як ОКРЕМИЙ позитивний матчер «не-neg» (some-OR логіка),
-    // тож наївне `picomatch(['pos','!neg'])` повертає true майже на всьому. Розділяємо вручну:
-    // позитиви join-имо через picomatch(...), негативні фільтруємо окремим isExcluded.
-    const positives = globs.filter(g => !g.startsWith('!'))
-    const negatives = globs.filter(g => g.startsWith('!')).map(g => g.slice(1))
-    const isMatch = positives.length > 0 ? picomatch(positives, { dot: false }) : () => false
-    const isExcluded = negatives.length > 0 ? picomatch(negatives, { dot: false }) : () => false
-    return all.filter(rel => isMatch(rel) && !isExcluded(rel)).map(rel => join(root, rel))
+    const ig = ignore().add(globs)
+    return all.filter(rel => ig.ignores(rel)).map(rel => join(root, rel))
   }
   throw new Error(`target.json: files має містити single або walkGlob (отримано: ${JSON.stringify(filesSpec)})`)
 }

package/scripts/update-blue-oak.mjs

@@ -43,7 +43,7 @@ for (const rating of data.ratings) {
 const out = {
   version: data.version,
   source: BLUE_OAK_URL,
-  bronzeAndAbove,
+  bronzeAndAbove
 }
 
 writeFileSync(OUT_PATH, JSON.stringify(out, null, 2) + '\n', 'utf8')

package/scripts/utils/walkDir.mjs

@@ -1,84 +1,44 @@
-/**
- * Рекурсивний обхід каталогів для скриптів перевірки (Dockerfile, k8s YAML тощо).
- *
- * Обходить дерево від заданого кореня; для кожного звичайного файлу викликає переданий callback.
- * Каталоги node_modules, .git, dist, coverage, .turbo, .next не заходяться.
- * Додатково можна передати `ignorePaths` — повні шляхи каталогів (абсолютні posix), які слід
- * пропускати разом з усім вмістом (поле `ignore` у `.n-cursor.json`). Якщо readdir для каталогу
- * не вдається — тихо виходить без throw.
- */
-import { readdir } from 'node:fs/promises'
-import { isAbsolute, join, resolve, sep } from 'node:path'
+/** @see ./docs/walkDir.md */
+import { join, relative, resolve, sep } from 'node:path'
+import { globby } from 'globby'
 
-/**
- * Перетворює довільний шлях у абсолютний posix-формат без trailing-slash.
- * @param {string} p шлях
- * @returns {string} абсолютний posix-шлях
- */
-function toAbsPosix(p) {
-  const abs = isAbsolute(p) ? p : resolve(p)
-  let posix = abs.split(sep).join('/')
-  while (posix.endsWith('/')) posix = posix.slice(0, -1)
-  return posix
-}
+// .git ніколи не потрапляє в .gitignore — пропускаємо завжди.
+// node_modules — safety net: проєкт може не мати .gitignore або запускатись поза git-репо.
+const ALWAYS_IGNORE = ['.git/**', 'node_modules/**']
 
 /**
- * Чи каталог `dirAbsPosix` входить у список ignore (точний збіг або префікс з '/').
- * Часткові збіги басенейму не враховуються (postgres-master-test ≠ postgres-master).
- * @param {string} dirAbsPosix абсолютний posix-шлях каталогу
- * @param {string[]} ignorePosix вже нормалізовані ignore-шляхи
- * @returns {boolean} `true`, якщо шлях слід пропустити (точний збіг або префікс з `/`)
- */
-function isIgnoredDir(dirAbsPosix, ignorePosix) {
-  for (const ig of ignorePosix) {
-    if (dirAbsPosix === ig) return true
-    if (dirAbsPosix.startsWith(`${ig}/`)) return true
-  }
-  return false
-}
-
-/**
- * Рекурсивно обходить каталог, пропускає типові артефакти збірки/залежностей та `ignorePaths`.
- * @param {string} dir абсолютний шлях
- * @param {(filePath: string) => void} onFile виклик для кожного файлу
- * @param {string[]} [ignorePaths] шляхи каталогів (відносні від cwd або абсолютні), що повністю виключаються з обходу
- * @returns {Promise<void>} визначається по завершенню обходу
+ * Рекурсивно обходить каталог, поважаючи .gitignore (включно з вкладеними).
+ * @param {string} dir абсолютний або відносний шлях до кореня обходу
+ * @param {(filePath: string) => void} onFile колбек для кожного файлу (абсолютний шлях)
+ * @param {string[]} [ignorePaths] додаткові шляхи для пропуску (абсолютні або відносні від cwd)
+ * @returns {Promise<void>}
  */
 export async function walkDir(dir, onFile, ignorePaths = []) {
-  const ignorePosix = ignorePaths.map(p => toAbsPosix(p))
-  await walkDirInner(dir, onFile, ignorePosix)
-}
+  const absDir = resolve(dir)
 
-/**
- * Внутрішній рекурсор. ignorePosix вже нормалізовано — не нормалізуємо повторно на кожному рівні.
- * @param {string} dir абсолютний шлях каталогу для обходу
- * @param {(filePath: string) => void} onFile колбек, що викликається для кожного звичайного файлу
- * @param {string[]} ignorePosix вже нормалізовані абсолютні posix-шляхи ігнорованих каталогів
- * @returns {Promise<void>} визначається по завершенню рекурсії
- */
-async function walkDirInner(dir, onFile, ignorePosix) {
-  if (ignorePosix.length > 0 && isIgnoredDir(toAbsPosix(dir), ignorePosix)) return
-  let entries
+  const extraIgnore = ignorePaths
+    .map(p => {
+      const abs = resolve(p.replace(/\/+$/, ''))
+      const rel = relative(absDir, abs).split(sep).join('/')
+      if (rel.startsWith('..') || rel === '') return null
+      return `${rel}/**`
+    })
+    .filter(Boolean)
+
+  let files
   try {
-    entries = await readdir(dir, { withFileTypes: true })
+    files = await globby('**/*', {
+      cwd: absDir,
+      gitignore: true,
+      dot: true,
+      onlyFiles: true,
+      ignore: [...ALWAYS_IGNORE, ...extraIgnore]
+    })
   } catch {
     return
   }
-  for (const e of entries) {
-    const p = join(dir, e.name)
-    if (e.isDirectory()) {
-      const skipDir =
-        e.name === 'node_modules' ||
-        e.name === '.git' ||
-        e.name === 'dist' ||
-        e.name === 'coverage' ||
-        e.name === '.turbo' ||
-        e.name === '.next'
-      if (skipDir) continue
-      if (ignorePosix.length > 0 && isIgnoredDir(toAbsPosix(p), ignorePosix)) continue
-      await walkDirInner(p, onFile, ignorePosix)
-    } else if (e.isFile()) {
-      onFile(p)
-    }
+
+  for (const rel of files) {
+    onFile(join(absDir, rel))
   }
 }

package/skills/doc-aggregate/SKILL.md

@@ -44,6 +44,7 @@ node -e "const p=JSON.parse(require('fs').readFileSync('package.json','utf8'));
 ```
 
 Для кожного воркспейсу `<ws>`:
+
 - `relRoot` = `<ws>` (напр. `npm`, `demo`)
 - `docPath` = `<ws>/docs/ARCHITECTURE.md`
 - `members` — кодові файли (`.mjs .ts .vue .py`, крім тестів) у `<ws>/`

package/skills/publish-telegram/SKILL.md

@@ -11,12 +11,15 @@ version: '1.0'
 
 ## Формат Telegram
 
-Telegram підтримує моноширний шрифт через markdown-розмітку:
+Telegram підтримує Markdown-форматування безпосередньо в клієнті:
 
-- `` `inline code` `` — для inline
-- ` ```pre``` ` (потрійні backticks) — для блоку коду / моноширного тексту
+- `**bold**` — жирний (заголовки, мітки секцій)
+- `_italic_` — курсив (акценти)
+- `` `inline code` `` — inline-код, команди, назви файлів/пакетів
+- ` ```block``` ` (потрійні backticks) — блок коду, коли є реальний код
+- `~~strikethrough~~` — закреслення (опціонально)
 
-Весь пост оформлюй як **один блок** потрійних backticks, щоб текст був моноширним.
+Секції (Проблема:, Рішення: тощо) виділяй `**жирним**`. Технічні терміни (назви файлів, пакетів, команди) — в `` `inline code` ``.
 
 ## Workflow
 
@@ -28,23 +31,23 @@ Telegram підтримує моноширний шрифт через markdown-
 
 ## Шаблон посту
 
-```markdown
+```
 #тег
 
-📌 <Короткий заголовок>
+📌 **<Короткий заголовок>**
 
-Проблема:
+**Проблема:**
 <1-3 речення — що було не так / яке завдання>
 
-Рішення:
+**Рішення:**
 <2-5 речень — що зробили, який підхід>
 
-Деталі:
+**Деталі:**
 • <ключовий момент 1>
 • <ключовий момент 2>
 • <ключовий момент 3>
 
-Результат:
+**Результат:**
 <1-2 речення — що отримали, яка вигода>
 ```
 
@@ -64,32 +67,27 @@ Telegram підтримує моноширний шрифт через markdown-
 - Тег: рівно 1 хештег першим рядком поста (#devops, #frontend, #bugfix, #refactoring, #CI, #performance тощо)
 - Emoji: лише структурні (📌 для заголовка, • для списку), не перевантажувати
 - Цільова аудиторія: розробники та менеджери — тому пояснюй простою мовою, без надмірного жаргону
-- Весь текст повинен бути всередині потрійних backticks для моноширного відображення в Telegram
+- Назви файлів, пакетів, команди — у `` `inline code` ``
+- Блок коду (потрійні backticks) — лише якщо є реальний код/конфіг, не для всього тексту
 
 ## Приклад
 
-````
 ```
 #dev
 
-📌 Міграція з Prettier на oxfmt
+📌 **Міграція з Prettier на oxfmt**
 
-Проблема:
-Prettier повільно форматував великі файли і
-конфліктував з ESLint при роботі з Vue SFC.
+**Проблема:**
+Prettier повільно форматував великі файли і конфліктував з ESLint при роботі з Vue SFC.
 
-Рішення:
-Замінили Prettier на oxfmt — нативний
-форматер від OXC. Оновили VS Code settings,
-видалили prettier-конфіги, додали .oxfmtrc.json.
+**Рішення:**
+Замінили Prettier на `oxfmt` — нативний форматер від OXC. Оновили VS Code settings, видалили prettier-конфіги, додали `.oxfmtrc.json`.
 
-Деталі:
-• oxfmt працює в 10-50x швидше за Prettier
-• Єдиний конфіг .oxfmtrc.json у корені
-• CI перевіряє форматування через lint-js
+**Деталі:**
+• `oxfmt` працює в 10-50x швидше за Prettier
+• Єдиний конфіг `.oxfmtrc.json` у корені
+• CI перевіряє форматування через `lint-js`
 
-Результат:
-Форматування працює миттєво при збереженні,
-зникли конфлікти між форматером і лінтером.
+**Результат:**
+Форматування працює миттєво при збереженні, зникли конфлікти між форматером і лінтером.
 ```
-````