@nitra/cursor 6.0.0 → 7.1.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [7.1.0] - 2026-06-14
+
+### Added
+
+- lint-text підкоманда приймає --read-only (детект без авто-фіксу markdownlint/shellcheck/dotenv) — для CI-режиму без мутацій
+
+## [7.0.0] - 2026-06-14
+
+### Changed
+
+- lint --full поглинає конформність (колишній fix): read-only → детект через per-rule fix.mjs run(); fix → convergence-движок. Конформність як whole-repo фаза лише у --full
+- lint приймає фільтр правил (lint <rule>) → конформність лише цих правил (мапить колишній fix <rule>); hk pre-commit changelog → lint changelog
+- governance: знято заборону паралельного eslint — паралельно по диз'юнктних файлах дозволено; серіалізувати лише whole-tree прогони того самого корпусу (CLAUDE.md-секція + n-lint SKILL)
+
+### Removed
+
+- Видалено команди fix/check/fix-run; рух-движок конформності переміщено skills/fix/js→scripts/lib/fix і поглинуто в lint. PostToolUse-хук → read-only детект усіх правил (без роутингу). /n-fix → делегат на /n-lint. fix-t0/_fix-check лишаються внутрішніми фазами движка
+
 ## [6.0.0] - 2026-06-14
 
 ### Added

package/bin/n-cursor.js

@@ -637,15 +637,16 @@ async function removeOrphanManagedSkillDirs(skillsRoot, configSkills) {
 }
 
 /**
- * Рендерить коротку секцію для CLAUDE.md: не розпаралелювати лінт (ESLint) між shells/субагентами.
+ * Рендерить коротку секцію для CLAUDE.md: паралелізм лінту — по диз'юнктних файлах дозволено,
+ * серіалізувати лише whole-tree прогони того самого корпусу.
  * @returns {string[]} рядки для вставки (з порожнім рядком на початку)
  */
 function buildClaudeLintParallelismSectionLines() {
   return [
     '',
-    '## Лінт і ESLint (без паралельних запусків)',
+    '## Лінт і ESLint (паралелізм)',
     '',
-    'Щоб не запускати **кілька** одночасних **`eslint`** (і не перевантажувати диск/CPU), **заборонено** стартувати `bun run lint` / `lint-js` / `eslint` **паралельно** в різних Bash-задачах, **фонових** shells чи **субагентах** (Task тощо). Має бути **один** послідовний прогон на сесію; команда **`/n-lint`** — **не** ділити на паралельні підзадачі. Деталі: `.cursor/skills/n-lint/SKILL.md`.',
+    'Паралельний лінт по **різних** файлах — **дозволено**: диз\'юнктні набори (per-file `lint` на змінених vs origin) не конфліктують і не перевантажують диск/CPU. Серіалізувати треба лише **whole-tree** прогони того самого корпусу (`bun run lint`, `n-cursor lint --full` по всьому репо) — щоб не дублювати важкий full-scan. Деталі: `.cursor/skills/n-lint/SKILL.md`.',
     ''
   ]
 }
@@ -1597,7 +1598,7 @@ async function runSync() {
  * `--root`-команди `lint-doc-files`/`fix-doc-files`/`doc-files`/`doc-aggregate`/`rename-yaml-extensions`, `worktree`,
  * sub-лінтери) гард не зачіпає.
  */
-const ROOT_GUARDED_COMMANDS = new Set([undefined, '', 'fix', 'check', 'lint', 'coverage', 'change', 'release'])
+const ROOT_GUARDED_COMMANDS = new Set([undefined, '', 'lint', 'coverage', 'change', 'release'])
 
 /**
  * Короткий опис дії для тексту root-guard помилки за іменем команди.
@@ -1610,12 +1611,8 @@ function describeRootGuardedAction(cmd) {
     case '': {
       return 'Дефолтна синхронізація скаффолдить .cursor/, .claude/, CLAUDE.md, .n-cursor.json і робить bun install у поточному каталозі'
     }
-    case 'fix':
-    case 'check': {
-      return '`fix` запускає programmatic-перевірки правил, що переписують конфіги в поточному каталозі'
-    }
     case 'lint': {
-      return '`lint` запускає авто-fix лінтерів (oxfmt/eslint --fix/stylelint --fix) у поточному каталозі'
+      return '`lint` за замовчуванням авто-fix лінтерів (oxfmt/eslint --fix/stylelint --fix) і конформності (--full) у поточному каталозі'
     }
     case 'coverage': {
       return '`coverage` генерує COVERAGE.md і Stryker-артефакти в поточному каталозі'
@@ -1646,29 +1643,13 @@ try {
   }
   await ensureNitraCursorInRootDevDependencies(cwd())
   switch (command) {
-    case 'fix': {
-      const { runOrchestratorCli } = await import('../skills/fix/js/orchestrator.mjs')
-      process.exitCode = await runOrchestratorCli(args, cwd())
-      break
-    }
     case '_fix-check': {
-      // Внутрішня команда оркестратора — не є публічним API.
-      // Повертає JSON {total, failed, rules:[{ruleId, ok, output}]} у stdout.
+      // Внутрішня команда движка конформності (не публічний API): per-rule fix.mjs run() = детект.
+      // Повертає JSON {total, failed, rules:[{ruleId, ok, output}]} у stdout. Викликається
+      // конформність-фазою `lint` (read-only) і движком orchestrator/t0.
       await runFixCommand(args, { json: true })
       break
     }
-    case 'check': {
-      // Backward-compatibility alias. Перейменовано на `fix` у 1.13.84 (узгоджено з ім'ям файла `rules/<id>/fix.mjs`).
-      console.warn(
-        `⚠️  Команда \`check\` deprecated — використовуйте \`fix\` (\`npx ${PACKAGE_NAME} fix [<rule>...]\`)`
-      )
-      await runFixCommand(
-        args.filter(a => a !== '--json'),
-        { json: args.includes('--json') }
-      )
-
-      break
-    }
     case 'rename-yaml-extensions': {
       const code = await runRenameYamlExtensionsCli(args)
       if (code !== 0) {
@@ -1687,7 +1668,14 @@ try {
     }
     case 'lint': {
       // Дві ортогональні осі: --full (scope: весь репо vs дельта vs origin) × --read-only (behavior).
-      process.exitCode = await runLint({ full: args.includes('--full'), readOnly: args.includes('--read-only') })
+      // Позиційні (не-флаг) аргументи — фільтр правил конформності (напр. `lint changelog`):
+      // прогнати лише конформність цих правил, без лінтер-скану (мапить колишній `fix <rule>`).
+      const rules = args.filter(a => !a.startsWith('-'))
+      process.exitCode = await runLint({
+        full: args.includes('--full'),
+        readOnly: args.includes('--read-only'),
+        rules
+      })
 
       break
     }
@@ -1723,8 +1711,9 @@ try {
       break
     }
     case 'lint-text': {
-      // Канонічний lint-text: cspell → run-shellcheck → markdownlint-cli2 --fix → run-v8r (text.mdc).
-      process.exitCode = await runLintTextCli()
+      // Канонічний lint-text: cspell → shellcheck → dotenv → markdownlint → v8r (text.mdc).
+      // `--read-only` (CI): без авто-фіксу (markdownlint/shellcheck/dotenv) — нуль мутацій.
+      process.exitCode = await runLintTextCli({ readOnly: args.includes('--read-only') })
 
       break
     }
@@ -1764,19 +1753,12 @@ try {
 
       break
     }
-    case 'fix-run': {
-      // Backward-compatibility alias → перенаправляємо на `fix`.
-      console.warn(`⚠️  \`fix-run\` deprecated — використовуйте \`fix\``)
-      const { runOrchestratorCli } = await import('../skills/fix/js/orchestrator.mjs')
-      process.exitCode = await runOrchestratorCli(args, cwd())
-      break
-    }
     case 'fix-t0': {
-      // n-cursor fix-t0 [rule...] — T0-auto рівень n-fix оркестратора.
-      // Запускає fix --json, знаходить violation-output із детермінованим паттерном
+      // Внутрішня фаза движка конформності (не публічний API): T0-auto рівень.
+      // Запускає _fix-check, знаходить violation-output із детермінованим паттерном
       // (vscode-ext-add, rm-forbidden-file тощо), застосовує програмний фікс (0 LLM),
-      // перевіряє check-gate. Exit 0 = усі T0-паттерни закриті; 1 = є решта для LLM.
-      const { runT0AutoCli } = await import('../skills/fix/js/t0.mjs')
+      // перевіряє check-gate. Викликається orchestrator.mjs (fix-режим конформності lint).
+      const { runT0AutoCli } = await import('../scripts/lib/fix/t0.mjs')
       process.exitCode = await runT0AutoCli(args, cwd())
 
       break
@@ -1892,7 +1874,7 @@ try {
     default: {
       console.error(`❌ Невідома команда: ${command}`)
       console.error(
-        `   Очікується: (без аргументів) синхронізація правил, fix, check, rename-yaml-extensions, post-tool-use-fix, lint, lint-ga, lint-rego, lint-k8s, lint-docker, lint-text, lint-doc-files, fix-doc-files, coverage, coverage-fix, taze, start-check, fix-t0, change, release, skill, worktree, lint-ci, trace, doc-files, doc-aggregate`
+        `   Очікується: (без аргументів) синхронізація правил, rename-yaml-extensions, post-tool-use-fix, lint, lint-ga, lint-rego, lint-k8s, lint-docker, lint-text, lint-doc-files, fix-doc-files, coverage, coverage-fix, taze, start-check, change, release, skill, worktree, lint-ci, trace, doc-files, doc-aggregate`
       )
       process.exitCode = 1
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "6.0.0",
+  "version": "7.1.0",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",

package/scripts/lint-cli.mjs

@@ -14,6 +14,7 @@
 import { existsSync, readdirSync } from 'node:fs'
 import { dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
+import { spawnSync } from 'node:child_process'
 import { cwd as processCwd } from 'node:process'
 
 import { parseRuleLintSpec, readRuleMetaRaw } from './lib/rule-meta.mjs'
@@ -21,6 +22,41 @@ import { collectChangedFilesSince, resolveChangedBase } from './lib/changed-file
 
 const PACKAGE_ROOT = dirname(dirname(fileURLToPath(import.meta.url)))
 const RULES_DIR = join(PACKAGE_ROOT, 'rules')
+const N_CURSOR_BIN = join(PACKAGE_ROOT, 'bin', 'n-cursor.js')
+
+/**
+ * Конформність-фаза lint (whole-repo: config/file/workflow conformance — те, що раніше робив `fix`).
+ * Per-file декомпозиції немає, тож виконується лише у `--full`.
+ *  - read-only: детект через `_fix-check` (per-rule `fix.mjs run()` = перевірка, без мутацій);
+ *  - fix: convergence-движок (check → Tier0 → omlx) через orchestrator.
+ * @param {string} cwd корінь
+ * @param {boolean} readOnly true → лише детект (нуль мутацій)
+ * @param {(s: string) => void} log логер
+ * @param {string[]} [filter] фільтр правил (порожній — усі)
+ * @returns {Promise<number>} 0 — чисто, 1 — порушення/помилка
+ */
+async function runConformance(cwd, readOnly, log, filter = []) {
+  if (!readOnly) {
+    const { runOrchestratorCli } = await import('./lib/fix/orchestrator.mjs')
+    return runOrchestratorCli(filter, cwd)
+  }
+  const r = spawnSync('bun', [N_CURSOR_BIN, '_fix-check', ...filter], { cwd, encoding: 'utf8', timeout: 600_000 })
+  let parsed = null
+  try {
+    parsed = JSON.parse((r.stdout ?? '').trim())
+  } catch {
+    parsed = null
+  }
+  if (!parsed) {
+    log('❌ lint: конформність — помилка перевірки (_fix-check не повернув JSON)\n')
+    return 1
+  }
+  const failed = parsed.rules.filter(/** @param {{ok:boolean}} x */ x => !x.ok)
+  if (failed.length === 0) return 0
+  log(`❌ lint: конформність — ${failed.length} порушень: ${failed.map(/** @param {{ruleId:string}} x */ x => x.ruleId).join(', ')}\n`)
+  for (const f of failed) if (f.output) log(`${f.output}\n`)
+  return 1
+}
 
 /**
  * Вибирає id правил для контексту, алфавітно.
@@ -56,18 +92,25 @@ function readAllMeta(rulesDir) {
 
 /**
  * Запускає lint-оркестрацію.
- * @param {{ full?: boolean, readOnly?: boolean, cwd?: string, rulesDir?: string, log?: (s: string) => void }} [opts] параметри
+ * @param {{ full?: boolean, readOnly?: boolean, rules?: string[], cwd?: string, rulesDir?: string, log?: (s: string) => void }} [opts] параметри
  *   - `full` — весь репо (`true`) проти дельти vs origin (`false`, default);
- *   - `readOnly` — лише детект без мутацій (`true`) проти fix (`false`, default).
+ *   - `readOnly` — лише детект без мутацій (`true`) проти fix (`false`, default);
+ *   - `rules` — непорожній фільтр → лише конформність цих правил (без лінтер-скану; мапить `fix <rule>`).
  * @returns {Promise<number>} exit code
  */
 export async function runLint(opts = {}) {
   const full = opts.full === true
   const readOnly = opts.readOnly === true
+  const rules = Array.isArray(opts.rules) ? opts.rules : []
   const cwd = opts.cwd ?? processCwd()
   const rulesDir = opts.rulesDir ?? RULES_DIR
   const log = opts.log ?? (s => process.stdout.write(s))
 
+  // Rule-filter режим (напр. `lint changelog` із hk): лише конформність указаних правил, без лінтерів.
+  if (rules.length > 0) {
+    return runConformance(cwd, readOnly, log, rules)
+  }
+
   // Default scope — дельта vs origin (merge-base main/origin/main); `--full` — весь репо.
   const changed = full ? undefined : collectChangedFilesSince(resolveChangedBase(cwd), cwd)
   if (!full && changed.length === 0) {
@@ -86,5 +129,12 @@ export async function runLint(opts = {}) {
     const code = await mod.lint(changed, cwd, { readOnly })
     if (code !== 0) return code
   }
+
+  // Конформність-фаза (поглинула `fix`): whole-repo, лише у `--full`. Кастомний rulesDir
+  // (юніт-тести селектора) — реальний пакет недоступний, тож пропускаємо.
+  if (full && opts.rulesDir === undefined) {
+    const conformanceCode = await runConformance(cwd, readOnly, log)
+    if (conformanceCode !== 0) return conformanceCode
+  }
   return 0
 }

package/scripts/post-tool-use-fix.mjs

@@ -1,65 +1,19 @@
 /**
- * PostToolUse hook для Claude Code: точкова маршрутизація `npx \@nitra/cursor fix`
- * за типом зміненого файла. Запускається після кожного `Edit` / `Write` / `MultiEdit`;
- * замінює дорогий синхронний `Stop`-хук, що ганяв повний `fix` усіх правил на кожному
- * turn-і.
+ * PostToolUse hook для Claude Code: read-only детект конформності **всіх** активованих правил
+ * після редагування файлу. Запускається після кожного `Edit` / `Write` / `MultiEdit`.
  *
- * Контракт:
- * - stdin Claude Code: JSON із `tool_input.file_path` (відносний шлях зміненого файла);
- * - exit 0, якщо файл не має маршрут (PostToolUse не блокує turn у будь-якому випадку,
- *   але ми лишаємо exit-код прозорим — для діагностики);
- * - інакше spawn `npx --no \@nitra/cursor fix <rules…>` із передаванням exit-коду.
+ * Раніше хук маршрутизував змінений файл у релевантні правила й ганяв повний `fix` (автофікс
+ * + LLM) — дорого, тож звужували. Тепер хук — **детект** (нуль мутацій, нуль LLM), тож роутинг
+ * зайвий: один виклик `_fix-check` (per-rule `fix.mjs run()` = перевірка) по всіх правилах.
  *
- * Маршрути впорядковані від найбільш специфічного до загального; перший збіг — переможець.
- * `docs/adr/**\/*.md` свідомо повертає `[]`: ADR-нормалізація вже покривається async
- * Stop-hook'ом `normalize-decisions.sh` — повторний `fix adr` тут лише сповільнював би turn.
+ * Контракт:
+ * - stdin Claude Code: JSON із `tool_input.file_path`; якщо файлу немає (напр. Bash) — exit 0 (skip);
+ * - інакше spawn `_fix-check` (детект усіх правил), exit-код прозоро пробрасуємо (PostToolUse
+ *   не блокує turn, але код лишаємо інформативним: 1 — є порушення конформності).
  */
 import { spawn } from 'node:child_process'
 import { once } from 'node:events'
 
-import picomatch from 'picomatch'
-
-/**
- * @typedef {object} Route
- * @property {string} pattern picomatch glob (з підтримкою `**` і `{a,b}`)
- * @property {string[]} rules ID правил `npm/rules/<id>` (бо `fix.mjs` обов'язковий)
- */
-
-/** Порядок важливий: специфічні маршрути (`.github/workflows/*`, `**\/k8s/**`) — перед загальними. */
-/** @type {readonly Route[]} */
-const ROUTES = Object.freeze([
-  { pattern: 'docs/adr/**/*.md', rules: [] },
-  { pattern: '.github/workflows/*.{yml,yaml}', rules: ['ga'] },
-  { pattern: '**/k8s/**/*.{yaml,yml}', rules: ['k8s'] },
-  { pattern: '**/*.vue', rules: ['js-lint', 'style-lint', 'vue'] },
-  { pattern: '**/*.{mjs,js,cjs,ts,tsx,jsx}', rules: ['js-lint'] },
-  { pattern: '**/*.{css,scss,sass}', rules: ['style-lint'] },
-  { pattern: '**/*.rego', rules: ['rego'] },
-  { pattern: '{**/,}Dockerfile', rules: ['docker'] },
-  { pattern: '**/*.Dockerfile', rules: ['docker'] },
-  { pattern: '**/*.sh', rules: ['security'] },
-  { pattern: '{**/,}package.json', rules: ['npm-module', 'bun'] },
-  { pattern: '**/*.md', rules: ['text'] }
-])
-
-/**
- * Повертає список правил, які слід прогнати для зміненого `filePath`.
- * Перший збіг із `ROUTES` — переможець; невідомі шляхи / некоректні входи → `[]`.
- * @param {unknown} filePath відносний шлях зміненого файла зі stdin Claude Code
- * @returns {string[]} ID правил для `npx \@nitra/cursor fix`
- */
-export function routeFilePathToRules(filePath) {
-  if (typeof filePath !== 'string' || filePath === '') {
-    return []
-  }
-  for (const { pattern, rules } of ROUTES) {
-    if (picomatch.isMatch(filePath, pattern, { dot: true })) {
-      return [...rules]
-    }
-  }
-  return []
-}
-
 /**
  * Зчитує stdin до EOF як utf8 рядок. На TTY — повертає `''` одразу.
  * @returns {Promise<string>} вміст stdin
@@ -87,7 +41,7 @@ async function readStdin() {
  * @param {string} stdinJson сирий вміст stdin
  * @returns {string | null} відносний шлях або `null`
  */
-function extractFilePath(stdinJson) {
+export function extractFilePath(stdinJson) {
   if (!stdinJson) {
     return null
   }
@@ -103,27 +57,25 @@ function extractFilePath(stdinJson) {
 /**
  * Точка входу. Викликається з `bin/n-cursor.js` коли argv[0] === `post-tool-use-fix`.
  * Параметри доступні для інʼєкції для тестів: `stdinJson` обходить read від `process.stdin`,
- * `spawnFn` — заміна `node:child_process.spawn` (повертає EventEmitter-сумісний об'єкт).
- * @param {{ stdinJson?: string, spawnFn?: typeof spawn }} [options] параметри для тестів (ін'єкція stdin/spawn)
- * @returns {Promise<number>} exit code (0 — пропущено / fix ОК; інше — exit-код `fix`)
+ * `spawnFn` — заміна `node:child_process.spawn`.
+ * @param {{ stdinJson?: string, spawnFn?: typeof spawn }} [options] параметри для тестів
+ * @returns {Promise<number>} exit code (0 — пропущено / конформність ОК; інше — є порушення)
  */
 export async function runPostToolUseFixCli(options = {}) {
   const stdinJson = options.stdinJson ?? (await readStdin())
   const filePath = extractFilePath(stdinJson)
+  // Тільки після редагування файлу (Edit/Write/MultiEdit мають file_path); Bash тощо — skip.
   if (filePath === null) {
     return 0
   }
-  const rules = routeFilePathToRules(filePath)
-  if (rules.length === 0) {
-    return 0
-  }
   const spawnFn = options.spawnFn ?? spawn
-  const child = spawnFn('npx', ['--no', '@nitra/cursor', 'fix', ...rules], { stdio: 'inherit' })
+  // Один read-only виклик: детект конформності всіх активованих правил, без роутингу.
+  const child = spawnFn('npx', ['--no', '@nitra/cursor', '_fix-check'], { stdio: 'inherit' })
   try {
     const [code] = await once(child, 'exit')
     return code ?? 1
   } catch (error) {
-    process.stderr.write(`post-tool-use-fix: не вдалося запустити npx @nitra/cursor fix — ${error.message}\n`)
+    process.stderr.write(`post-tool-use-fix: не вдалося запустити детект конформності — ${error.message}\n`)
     return 1
   }
 }

package/skills/fix/SKILL.md

@@ -1,23 +1,22 @@
 ---
 name: n-fix
 description: >-
-  Виправити проєкт відповідно до всіх правил в .cursor/rules/
+  DEPRECATED — використовуй /n-lint. fix злито в lint: `n-cursor lint` тепер і
+  детектить, і виправляє (конформність + лінтери) за один прохід.
 ---
 
-# n-fix — автоматичне виправлення проєкту
+# n-fix — DEPRECATED (делегат на /n-lint)
 
-## Scope
+Команду `n-cursor fix` **видалено**: рух-движок конформності (convergence-loop /
+check-gate / Tier0 / LLM) поглинуто в `lint` (спека
+`docs/specs/2026-06-14-lint-orchestrator-fix-readonly-unification-design.md`).
 
-Цей скіл відповідає **лише за структуру** проєкту: щоб `.cursor/rules/` + `npx @nitra/cursor fix` були задоволені (наявність конфігів, залежностей, скриптів, GitHub workflows, відсутність заборонених файлів). **Лінт-порушення у самому коді** (ESLint, oxlint, jscpd, cspell, knip, sonarjs, stylelint тощо) — **поза скоупом**; їх діагностує й виправляє **`/n-lint`** (`bun run lint`).
+**Використовуй `/n-lint`** замість цього скіла:
 
-## Workflow
+- `n-cursor lint` — дельта vs origin, **fix за замовчуванням** (лінтери на змінених файлах);
+- `n-cursor lint --full` — весь репо + **конформність** (колишній `fix`: конфіги/файли/воркфлоу
+  через convergence-движок);
+- `n-cursor lint --read-only [--full]` — лише детект, нуль мутацій (CI / pre-commit);
+- `n-cursor lint <rule>` — конформність одного правила (колишній `fix <rule>`).
 
-```bash
-n_cursor_npx fix
-```
-
-Exit 0 = чисто, 1 = є unresolved (перевір вивід — буде список правил що не закрились після 3 ітерацій).
-
-Якщо змінились залежності — `bun i`. Якщо змінились JS/TS файли — `oxfmt .`.
-
-Для конкретних правил: `n_cursor_npx fix bun ga`.
+Цей скіл лишено як тонкий делегат до наступного major; уся логіка — у `/n-lint`.

package/skills/lint/SKILL.md

@@ -91,18 +91,17 @@ bun run lint
 - Якщо тестів **немає** або вони **не покривають** блок, який змінюєш — **спочатку** додай/розшир тести, переконайся, що вони стабільно проходять, **потім** роби рефакторинг, **потім** знову прогони тести й **`bun run lint`**, щоб підтвердити, що функціональність коректна й лінт чистий.
 - Якщо після рефакторингу тести або лінт падають — **не** залишай «половинчастий» рефакторинг: відкотись або доведи зміни до зеленого стану.
 
-## Навантаження на macOS (багато процесів `eslint` / лаги)
+## Паралелізм і навантаження на macOS
 
-Часто це **не** «один ESLint розпаралелив себе всередині», а **кілька паралельних запусків** одного й того ж ланцюжка (**`bun run lint`**, **`bun run lint-js`**) у різних Bash-задачах агента (кілька shells). Кожен запуск = окремий процес **`eslint`** плюс **`oxlint`**, **`jscpd`** тощо — диск і CPU перегружаються.
+**Паралельно по різних файлах — дозволено.** Диз'юнктні набори (per-file `n-cursor lint` на змінених vs origin) не конфліктують: кожен процес обробляє свій підмножину файлів, тож гонки за тим самим корпусом немає.
 
-**Чому взагалі кілька `eslint`:** оркестратор (Claude Code, Cursor тощо) може **розпаралелити** роботу: кілька **субагентів** / **паралельних Bash-задач** / **фонових shell**, і кожен **сам** виконує **`/n-lint`** або запускає **`eslint`**. Тоді навантаження **множиться**: не один прогон лінту, а **N прогонів** одночасно.
+Проблема — не паралелізм як такий, а **кілька одночасних whole-tree прогонів того самого корпусу** (**`bun run lint`**, **`n-cursor lint --full`**) у різних Bash-задачах/shells: кожен повторно сканує **весь** репо (eslint + oxlint + jscpd + knip), і диск/CPU перевантажуються дублюванням важкого full-scan.
 
-### Що робити агенту під час виконання цього скілу (обов’язково)
+### Що робити агенту під час виконання цього скілу
 
-1. **Один** запуск **`bun run lint`** (або всі кроки **`lint`**, як у **`package.json`**) — у **одному** foreground shell, **без** `run_in_background` / фонових копій тієї ж команди.
-2. **Не** викликати **паралельні субагенти** (subagent, Task, «розбий на N паралельних завдань») лише заради лінту в одному репозиторії. Лінт не потребує шардінгу: один процес, послідовно.
-3. Якщо ти **батьок-сесія** й уже делегував дочірнім задачам **інші** кроки — **не** доручай дочірнім і **`bun run lint`**, залиш **лише** собі один **послідовний** прогон **після** змін у файлах, або **один** виклик цілого скілу на сесію.
-4. Якщо сесія/користувач уже запускає лінт — **не** дублювати; зачекати завершення або **не** стартувати лінт повторно в іншому shell.
+1. **Whole-tree** прогін (**`bun run lint`** / **`lint --full`**) — **один** за раз, у одному foreground shell; **не** запускати другий full-прогін того самого корпусу паралельно.
+2. **Per-file** лінт по диз'юнктних файлах (різні субагенти на різні файли) — **дозволено** й не потребує серіалізації.
+3. Якщо сесія/користувач уже запускає **whole-tree** лінт — не дублювати його; зачекати завершення.
 
 **Що можна змінити у проєкті (локально або в `package.json`)**