@nitra/cursor 1.28.6 → 1.28.7

package/CHANGELOG.md

@@ -4,6 +4,17 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.28.7] - 2026-05-28
+
+### Fixed
+
+- **`rules/js-lint/coverage/coverage.mjs`** — `n-cursor coverage` із кореня тепер працює у monorepo з частковим покриттям тестами (наприклад, `ai`: тести лише у `gt/`, інші `cf/*`/`run/*` без тестів). До цього перший workspace без тестів обривав ланцюг із `JS coverage exit 1`. Зміни: `defaultRunner.runJsCoverage` отримує `--passWithNoTests` (vitest 4.x — exit 0 у workspace без тестів); `collect()` розпиляно на `collectOneRoot(jsRoot, cwd, runner)` (per-workspace) і публічний агрегатор. `collectOneRoot` повертає `null` для workspace із порожнім lcov — Stryker у такому випадку не запускається. Реальні помилки (vitest exit ≠ 0, mutation.json відсутній при наявних тестах, compile errors) — throw, не маскуються. Якщо тестів немає у жодному workspace — `collect()` повертає `[]`, оркестратор `rules/test/coverage/coverage.mjs:runCoverageSteps` обробляє це як exit 1 із explainer-ом. Helpers `addCoverage`/`addMutation` беруться з `rules/test/coverage/coverage.mjs` (DRY, замість локальних копій). Додано 4 тести: monorepo з порожніми workspaces (skip), all-empty (`[]`), single-package без тестів, vitest exit ≠ 0 у monorepo (throw). ADR — `docs/adr/2026-05-28-coverage-multi-workspace-iteration.md`.
+- **`rules/test/test.mdc`** (`version` 2.4 → 2.5) і дзеркало `.cursor/rules/n-test.mdc` — секція "Multi-workspace iteration" з описом ітерації `resolveAllJsRoots()` і поведінки skip workspaces без тестів.
+
+### Changed
+
+- `abie` rule: `abie.package_json_docs` → `abie.package_json_shared`; пакет, що його перевіряє правило, перейменовано з `@nitra/abie-docs` на `@nitra/abie-shared` (паралель до `efes.package_json_shared` / `@nitra/efes-shared`). Реалізація: `npm/rules/abie/policy/package_json_shared/` (перейменовано з `package_json_docs/`). Bump `abie.mdc` `1.21` → `1.22`. Зачеплено: `.cursor/rules/conftest.mdc`.
+
 ## [1.28.5] - 2026-05-28
 
 ### Fixed

package/package.json

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

package/rules/abie/abie.mdc

@@ -1,7 +1,7 @@
 ---
 description: Правила для проєктів AbInBev Efes
 alwaysApply: true
-version: '1.21'
+version: '1.22'
 ---
 
 Правило **abie** для споживачів **@nitra/cursor**: **k8s** (Deployment + **HealthCheckPolicy** у **`hc.yaml`**, overlay **ua** — **nodeSelector**, **HTTPRoute** (будь-який непорожній **`target.name`**, для спільних сервісів **`auth-run-hl`** / **`file-link-hl`** — **`namespace: dev`** у base та patch **`…/backendRefs/…/namespace`** у **ua**)), гілки **dev**, **ua** у **clean-merged-branch**, а також заборона тримати артефакти **Firebase Hosting** у **підкаталогах першого рівня** (безпосередні діти кореня репозиторію; у самому корені ці імена не вимагаються до видалення).
@@ -140,12 +140,12 @@ KVCMS_URL=http://kvcms-hl.ua-apruv.svc.abie-ua.internal:8080
 
 Загальне правило про **внутрішній** URL (не публічний домен) для `HASURA_GRAPHQL_ENDPOINT` лишається у **`hasura.mdc`** (для nitra і abie) — `rules/hasura/fix.mjs` приймає кластерний DNS-формат `<cluster>.internal`.
 
-## `@nitra/abie-docs` у `devDependencies`
+## `@nitra/abie-shared` у `devDependencies`
 
-У кореневому **`package.json`** abie-проєкту в **`devDependencies`** має бути **`@nitra/abie-docs`** — пакет з канонічними контрактами/схемами abie-сервісів (наприклад, шляхи `node_modules/@nitra/abie-docs/...` для імпорту схем). Версію правило не фіксує — лише presence. Додати:
+У кореневому **`package.json`** abie-проєкту в **`devDependencies`** має бути **`@nitra/abie-shared`** — пакет зі спільними abie-ресурсами: канонічні GraphQL-схеми, скіли, типи (наприклад, шляхи `node_modules/@nitra/abie-shared/schema/...` для імпорту схем). Версію правило не фіксує — лише presence. Додати:
 
 ```bash
-bun add -d @nitra/abie-docs
+bun add -d @nitra/abie-shared
 ```
 
 ## Firebase Hosting
@@ -168,7 +168,7 @@ bun add -d @nitra/abie-docs
 - **`health_check_policy/`** → `abie.health_check_policy` — структура HealthCheckPolicy: `apiVersion: networking.gke.io/v1`, `metadata.name`, `spec.default.config.type: HTTP`, `httpHealthCheck.requestPath` починається з `/`, `port: 8080`, `targetRef.kind: Service`, `targetRef.name` має суфікс `-hl`. **Цільові файли:** `…/k8s/.../hc.yaml`.
 - **`base_deployment_preem/`** → `abie.base_deployment_preem` — Deployment у base/ має `spec.template.spec.nodeSelector.preem` зі значенням `true` (boolean або рядок). **Цільові файли:** ресурсні YAML під `…/k8s/.../base/...`.
 - **`clean_merged_ignore_branches/`** → `abie.clean_merged_ignore_branches` — у workflow `.github/workflows/clean-merged-branch.yml` крок з `uses: phpdocker-io/github-actions-delete-abandoned-branches` має `with.ignore_branches`, що містить токени `dev,ua` (case-insensitive). **Цільові файли:** `.github/workflows/clean-merged-branch.yml`.
-- **`package_json_docs/`** → `abie.package_json_docs` — у кореневому `package.json` `devDependencies` має містити `@nitra/abie-docs` (presence-only, версію не фіксуємо). **Цільові файли:** `package.json`.
+- **`package_json_shared/`** → `abie.package_json_shared` — у кореневому `package.json` `devDependencies` має містити `@nitra/abie-shared` (presence-only, версію не фіксуємо). **Цільові файли:** `package.json`.
 
 Cross-file / FS-логіка лишається у JS-частинах (`js/<concern>.mjs`) — Rego не читає файлову систему й не робить cross-document резолюцію:
 

package/rules/abie/policy/{package_json_docs/package_json_docs.rego → package_json_shared/package_json_shared.rego}

@@ -1,16 +1,16 @@
 # Перевірка кореневого `package.json` abie-проєкту: у `devDependencies` має бути
-# `@nitra/abie-docs` (контракти/схеми abie-сервісів — наприклад
-# `node_modules/@nitra/abie-docs/...`). Версію не фіксуємо — лише presence.
+# `@nitra/abie-shared` (контракти/схеми/скіли abie-сервісів — наприклад
+# `node_modules/@nitra/abie-shared/...`). Версію не фіксуємо — лише presence.
 #
 # Inverse-presence перевірка — лишається inline у rego (як `@nitra/cspell-dict`
 # у `text.package_json`), бо у template/ зберігаємо позитивні snippet/deny канони,
 # а не одиничний required-ключ.
-package abie.package_json_docs
+package abie.package_json_shared
 
 import rego.v1
 
 deny contains msg if {
 	dev := object.get(input, "devDependencies", {})
-	not "@nitra/abie-docs" in object.keys(dev)
-	msg := "package.json: devDependencies має містити @nitra/abie-docs — bun add -d @nitra/abie-docs (abie.mdc)"
+	not "@nitra/abie-shared" in object.keys(dev)
+	msg := "package.json: devDependencies має містити @nitra/abie-shared — bun add -d @nitra/abie-shared (abie.mdc)"
 }

package/rules/abie/policy/{package_json_docs → package_json_shared}/target.json

@@ -1,5 +1,5 @@
 {
   "$schema": "https://unpkg.com/@nitra/cursor/schemas/target.json",
   "files": { "single": "package.json", "required": true },
-  "missingMessage": "package.json не існує — створи його, додай devDependencies['@nitra/abie-docs'] (abie.mdc)"
+  "missingMessage": "package.json не існує — створи його, додай devDependencies['@nitra/abie-shared'] (abie.mdc)"
 }

package/rules/js-lint/coverage/coverage.mjs

@@ -13,6 +13,7 @@ import { tmpdir } from 'node:os'
 import { join, relative } from 'node:path'
 
 import { resolveAllJsRoots } from '../../../scripts/utils/resolve-js-root.mjs'
+import { addCoverage, addMutation } from '../../test/coverage/coverage.mjs'
 
 const TEST_BLOCK_START = /^\s*(it|test)\(/
 const FILE_EXTENSION = /\.[^.]+$/
@@ -210,12 +211,23 @@ export function parseStrykerReport(report, jsRoot) {
 /**
  * Default runner — спавнить реальні bun-команди через `node:child_process.spawnSync`
  * (працює і в Node-runtime через shebang `n-cursor`, і в Bun). Замінюється у тестах.
+ *
+ * Прапор `--passWithNoTests` робить vitest non-failing у workspaces без тестів
+ * (типовий патерн monorepo, де тести зосереджені в одному пакеті); пустий lcov
+ * у такому випадку сигналізує "no tests" → collectOneRoot пропускає workspace.
  */
 const defaultRunner = {
   runJsCoverage({ cwd, lcovDir }) {
     const r = spawnSync(
       'bunx',
-      ['vitest', 'run', '--coverage', '--coverage.reporter=lcov', `--coverage.reportsDirectory=${lcovDir}`],
+      [
+        'vitest',
+        'run',
+        '--passWithNoTests',
+        '--coverage',
+        '--coverage.reporter=lcov',
+        `--coverage.reportsDirectory=${lcovDir}`
+      ],
       { cwd, stdio: 'inherit', env: process.env }
     )
     return r.status ?? 1
@@ -227,91 +239,108 @@ const defaultRunner = {
 }
 
 /**
- * Збирає JS-метрики покриття + мутаційного тестування. У monorepo ітерує кожен
- * JS-root з `resolveAllJsRoots()` (включно з glob-патернами на кшталт `cf/*`),
- * запускає vitest+Stryker у кожному та сумує lcov/mutation. Шляхи файлів у
- * `survived` рібейзяться відносно `cwd`, щоб `coverage-fix.mjs` знаходив джерела.
+ * Збирає метрики покриття + мутаційного тестування для **одного** JS-root.
+ * Пропускає workspace без тестів (повертає `null`): vitest у такому випадку
+ * пройшов з `--passWithNoTests`, але lcov порожній — нема сенсу запускати
+ * Stryker. Реальні помилки (vitest exit ≠ 0, mutation.json відсутній попри
+ * наявні тести) кидаються — у multi-root режимі це не маскує справжній збій.
+ * @param {string} jsRoot абсолютний шлях до workspace-кореня
+ * @param {string} cwd корінь проєкту (для рібейзингу `survived[].file`)
+ * @param {{runJsCoverage:Function, runStryker:Function}} runner spawn-ін'єкція
+ * @returns {Promise<{coverage:object, mutation:{caught:number,total:number}, survived:Array<object>} | null>} результати або null коли workspace без тестів
+ */
+async function collectOneRoot(jsRoot, cwd, runner) {
+  const wsRel = relative(cwd, jsRoot)
+
+  // 1. Coverage через vitest run --passWithNoTests --coverage
+  const lcovDir = await mkdtemp(join(tmpdir(), 'js-lint-cov-'))
+  let coverage
+  try {
+    const code = await runner.runJsCoverage({ cwd: jsRoot, lcovDir })
+    if (code !== 0) throw new Error(`JS coverage exit ${code}`)
+    const lcovPath = join(lcovDir, 'lcov.info')
+    coverage = existsSync(lcovPath)
+      ? parseLcov(await readFile(lcovPath, 'utf8'))
+      : { lines: { covered: 0, total: 0 }, functions: { covered: 0, total: 0 } }
+  } finally {
+    await rm(lcovDir, { recursive: true, force: true })
+  }
+
+  // Порожній lcov ⇔ vitest з --passWithNoTests не знайшов тестів. Пропускаємо
+  // workspace, щоб не запускати Stryker марно і не псувати агрегат.
+  const hasTests = coverage.lines.total > 0 || coverage.functions.total > 0
+  if (!hasTests) return null
+
+  // 2. Mutation через Stryker
+  await runner.runStryker({ cwd: jsRoot })
+  const mutationPath = join(jsRoot, 'reports', 'stryker', 'mutation.json')
+  if (!existsSync(mutationPath)) {
+    throw new Error(
+      'js-lint coverage: stryker не залишив mutation.json — ' +
+        'запусти `npx @nitra/cursor fix test` для встановлення canonical stryker.config.mjs, ' +
+        'або налаштуй його вручну'
+    )
+  }
+  const mutationReport = JSON.parse(await readFile(mutationPath, 'utf8'))
+  const parsed = parseStrykerReport(mutationReport, jsRoot)
+
+  return {
+    coverage,
+    mutation: { caught: parsed.caught, total: parsed.total },
+    survived: parsed.survived.map(group => ({
+      ...group,
+      file: wsRel === '' ? group.file : join(wsRel, group.file),
+      exampleTest: group.exampleTest
+        ? {
+            ...group.exampleTest,
+            testFile: wsRel === '' ? group.exampleTest.testFile : join(wsRel, group.exampleTest.testFile)
+          }
+        : null
+    }))
+  }
+}
+
+/**
+ * Збирає JS-метрики покриття + мутаційного тестування. У monorepo ітерує усі
+ * JS-roots з `resolveAllJsRoots()` (включно з glob-патернами `cf/*`), запускає
+ * vitest+Stryker у кожному та сумує lcov/mutation через `addCoverage`/`addMutation`
+ * з оркестратора. Workspaces без тестів пропускаються (див. `collectOneRoot`).
+ * Якщо тестів немає у жодному workspace — повертає `[]`; оркестратор
+ * `rules/test/coverage/coverage.mjs:runCoverageSteps` обробить це як exit 1
+ * з зрозумілим повідомленням ("Жодного провайдера покриття не знайдено").
+ * Шляхи у `survived` рібейзяться відносно `cwd`, щоб `coverage-fix.mjs`
+ * знаходив джерела через `join(projectRoot, file)`.
  * @param {string} cwd корінь проєкту
  * @param {{runner?: typeof defaultRunner}} [opts] runner-ін'єкція для тестів
- * @returns {Promise<Array<{area:string, coverage:object, mutation:{caught:number,total:number}}>>} рядки для COVERAGE.md
+ * @returns {Promise<Array<{area:string, coverage:object, mutation:{caught:number,total:number}, survived:Array<object>}>>} рядок `JS` або `[]` коли тестів нема ніде
  */
 export async function collect(cwd, opts = {}) {
   const runner = opts.runner ?? defaultRunner
   const jsRoots = await resolveAllJsRoots(cwd)
   if (jsRoots.length === 0) throw new Error('js-lint coverage: package.json не знайдено')
 
-  let coverage = { lines: { covered: 0, total: 0 }, functions: { covered: 0, total: 0 } }
-  let mutation = { caught: 0, total: 0 }
-  const survived = []
-
+  const results = []
   for (const jsRoot of jsRoots) {
-    const wsRel = relative(cwd, jsRoot)
-
-    // 1. Coverage через vitest run --coverage (v8 provider пише lcov.info у lcovDir)
-    const lcovDir = await mkdtemp(join(tmpdir(), 'js-lint-cov-'))
-    try {
-      const code = await runner.runJsCoverage({ cwd: jsRoot, lcovDir })
-      if (code !== 0) throw new Error(`JS coverage exit ${code}`)
-      coverage = addCoverage(coverage, parseLcov(await readFile(join(lcovDir, 'lcov.info'), 'utf8')))
-    } finally {
-      await rm(lcovDir, { recursive: true, force: true })
-    }
-
-    // 2. Mutation через Stryker
-    await runner.runStryker({ cwd: jsRoot })
-    let mutationReport
-    try {
-      mutationReport = JSON.parse(await readFile(join(jsRoot, 'reports', 'stryker', 'mutation.json'), 'utf8'))
-    } catch {
-      throw new Error(
-        'js-lint coverage: stryker не залишив mutation.json — ' +
-          'запусти `npx @nitra/cursor fix test` для встановлення canonical stryker.config.mjs, ' +
-          'або налаштуй його вручну'
-      )
-    }
-    const parsed = parseStrykerReport(mutationReport, jsRoot)
-    mutation = addMutation(mutation, { caught: parsed.caught, total: parsed.total })
-
-    for (const group of parsed.survived) {
-      survived.push({
-        ...group,
-        file: wsRel === '' ? group.file : join(wsRel, group.file),
-        exampleTest: group.exampleTest
-          ? {
-              ...group.exampleTest,
-              testFile: wsRel === '' ? group.exampleTest.testFile : join(wsRel, group.exampleTest.testFile)
-            }
-          : null
-      })
-    }
+    const r = await collectOneRoot(jsRoot, cwd, runner)
+    if (r !== null) results.push(r)
   }
 
-  return [{ area: 'JS', coverage, mutation, survived }]
-}
-
-/**
- * Сумування coverage-totals — імпортується з оркестратора при потребі; тут
- * локальна копія, щоб уникнути циклу test/coverage → js-lint/coverage.
- * @param {{lines:{covered:number,total:number}, functions:{covered:number,total:number}}} a перший
- * @param {{lines:{covered:number,total:number}, functions:{covered:number,total:number}}} b другий
- * @returns {{lines:{covered:number,total:number}, functions:{covered:number,total:number}}} сума
- */
-function addCoverage(a, b) {
-  return {
-    lines: { covered: a.lines.covered + b.lines.covered, total: a.lines.total + b.lines.total },
-    functions: {
-      covered: a.functions.covered + b.functions.covered,
-      total: a.functions.total + b.functions.total
-    }
+  if (results.length === 0) {
+    console.error(
+      'js-lint coverage: жоден workspace не має тестів ' +
+        '(`*.test.{js,mjs}` у `tests/` або поряд із джерелом) — ' +
+        'додай тести або вилучи `js-lint` з .n-cursor.json#rules'
+    )
+    return []
   }
-}
 
-/**
- * Сумування mutation-counts.
- * @param {{caught:number,total:number}} a перший
- * @param {{caught:number,total:number}} b другий
- * @returns {{caught:number,total:number}} сума
- */
-function addMutation(a, b) {
-  return { caught: a.caught + b.caught, total: a.total + b.total }
+  let coverage = { lines: { covered: 0, total: 0 }, functions: { covered: 0, total: 0 } }
+  let mutation = { caught: 0, total: 0 }
+  const survived = []
+  for (const r of results) {
+    coverage = addCoverage(coverage, r.coverage)
+    mutation = addMutation(mutation, r.mutation)
+    survived.push(...r.survived)
+  }
+  return [{ area: 'JS', coverage, mutation, survived }]
 }

package/rules/test/test.mdc

@@ -1,6 +1,6 @@
 ---
 description: JS-тести (*.test.mjs) живуть у tests/. Правило `test` керує stryker.config.mjs + vitest.config.js (якщо js-lint enabled) і .cargo/mutants.toml (якщо rust enabled).
-version: '2.4'
+version: '2.5'
 globs: "**/{.n-cursor.json,package.json,Cargo.toml,stryker.config.mjs,vitest.config.js,.cargo/mutants.toml},**/*.test.mjs"
 alwaysApply: false
 ---
@@ -91,6 +91,10 @@ Canonical `vitest.config.js` (для довідки — `pool: 'forks'` + `inclu
 
 Канон `scripts.coverage` (substring requirement): [package.json.contains.json](./policy/package_json/template/package.json.contains.json)
 
+### Multi-workspace iteration
+
+У monorepo `n-cursor coverage` ітерує усі workspaces з власним `package.json` (через `resolveAllJsRoots()`, з розгортанням glob-патернів `cf/*`/`packages/*`) і агрегує метрики lcov + Stryker у єдиний `JS`-рядок `COVERAGE.md`. Workspace без тестів пропускається без помилки (vitest викликається з `--passWithNoTests`, порожній lcov → skip-сигнал, Stryker не запускається). `n-cursor coverage` падає лише коли тестів немає в **жодному** workspace проєкту або коли vitest повертає non-zero exit (реальний test failure / compile error — це не маскується).
+
 ## Налаштування mutation-testing
 
 Якщо у `.n-cursor.json#rules` присутнє правило `js-lint` — правило `test` створює canonical baseline `stryker.config.mjs` + `vitest.config.js` у **кожному** JS-root проєкту: у кожному workspace з власним `package.json` (або в корені для single-package). У monorepo з `workspaces: ['app', 'scripts']` отримаєте `app/stryker.config.mjs` + `app/vitest.config.js` і `scripts/stryker.config.mjs` + `scripts/vitest.config.js`.

package/skills/llm-patch/SKILL.md

@@ -25,6 +25,54 @@ description: >-
   на XML-тегах, file refs (`path/to/file.ts:42`), markdown.
 - **Один блок виводу:** результат — це **один** markdown-блок у відповіді
   чату, готовий до копіювання.
+- **Лаконічність — головне:** промпт містить **інтент + покажчики**, а не
+  цитати + готовий код. Цільова LLM має повний доступ до свого CWD через
+  `Read`/`Grep`/`Glob` і прочитає актуальний стан сама — наш патч не повинен
+  дублювати те, до чого вона додумається з 2-3 файлів.
+
+## Що **не** включати у промпт (cut list)
+
+Цільова LLM сама прочитає файли — не дублюй їх. Викидай:
+
+- **Великі цитати коду** з файлів, які LLM знайде за file ref. Замість блоку
+  з 30 рядками функції — один рядок: `див. rules/foo/bar.mjs:120-150 (collect)`.
+  Цитуй **тільки**: вже видалений код (тобто LLM його не знайде), або фрагмент
+  з зовнішнього джерела (логи, stderr, помилка з CI).
+- **Готові імплементації** ("ось як має виглядати новий `defaultRunner`")
+  з повним кодом. Опиши інтент і обмеження — LLM напише код сама й краще
+  під поточний стиль файлу. Виняток: один-два рядки, які важко описати словами
+  (наприклад, точна назва прапора CLI).
+- **Покрокові підказки рівня "крок 1: import X, крок 2: split into a) і b)…"**
+  з псевдо-кодом. Це передчасна архітектура — описуй **бажану поведінку**
+  (input → output, edge cases), а декомпозицію довір LLM.
+- **Повний вміст `package.json`, конфігів, helpers** — досить імені поля та
+  значення, що змінюється: `engines.node: ">=22" → ">=25"`. Якщо значення
+  специфічне (peer ranges, exports map) — цитуй **тільки цей фрагмент**.
+- **Огляд альтернатив, які ти відкинув,** із розгорнутими аргументами. Один
+  рядок: "розглянутий варіант X відкинуто — Y" або взагалі прибрати, якщо
+  LLM сама дійде того самого висновку.
+- **Списки існуючих helpers ("вже є addCoverage у rules/test/coverage")** —
+  досить рядка-покажчика; LLM зайде `Grep`'ом і прочитає сигнатуру сама.
+- **Дублювання правил репо** (`CLAUDE.md`, `.cursor/rules/*.mdc`) — досить
+  згадки "дотриматись n-test.mdc"; LLM прочитає файл сама.
+- **Готовий `tree -L 2`-дамп** — досить рядка "монорепо з workspaces
+  cf/_, run/_, gt (bun)"; повна структура майже завжди шум.
+- **Самоочевидні acceptance-checks** ("тести зелені", "лінтер чистий") —
+  пиши тільки специфічні до завдання ("на репо `ai`: `bun run coverage`
+  не падає з `JS coverage exit 1`").
+
+## Що **обов'язково** включити
+
+- **Інтент** — 1-3 речення, що саме треба і чому (1 речення на причину).
+- **Симптом / репро,** якщо це bugfix: справжній stderr, точна команда,
+  exit code. Це **не** виводиться з коду — без нього LLM не знає, що
+  саме ламається.
+- **File refs** на ключові точки правки: `path:line` або `path:line-range`,
+  з одним рядком пояснення кожна.
+- **Реальні обмеження,** які не виводяться з коду: версії в репо-споживачі,
+  inflight-міграції, breaking-change політика, зовнішні залежності.
+- **Як перевірити** — конкретні команди й специфічні до завдання сигнали
+  успіху.
 
 ## Виклик
 
@@ -48,102 +96,98 @@ description: >-
    пакета / шлях. Аргумент = намір користувача, передається у промпт
    як розділ "Завдання".
 
-2. **Зібрати read-only контекст з CWD:**
-   - `package.json` — поля `name`, `version`, `engines`, `peerDependencies`,
-     `dependencies`, `devDependencies`, `scripts`, `type`, `exports`.
-   - Структура репо: `tree -L 2 -I 'node_modules|.git|dist|build|.next|.nuxt'`
-     (або `ls -la` коли `tree` недоступний).
-   - `README.md` — перші 40-60 рядків (head).
-   - `CLAUDE.md` / `AGENTS.md` / `.cursor/rules/*.mdc` — якщо є, відмітити їх
-     існування й перелік.
-   - **Релевантні до завдання config-файли** — підбирати за ключовими
-     словами з аргументу (наприклад, "node" → `engines`, `.nvmrc`,
-     `.node-version`; "eslint" → `eslint.config.*`, `.eslintrc*`;
-     "vite" → `vite.config.*`; "ts" → `tsconfig.json`).
-
-3. **Визначити "точку патчу"** — короткий список файлів, які найімовірніше
-   доведеться правити цільовому агенту, з обґрунтуванням.
-
-4. **Сформувати промпт за шаблоном нижче.** Дрібні релевантні файли
-   (≤ ~80 рядків) вбудовуй **повністю**; великі — цитуй фрагмент з
-   посиланням на шлях:рядки.
-
-5. **Вивести один markdown-блок у чат** — без додаткових коментарів
+2. **Зібрати read-only контекст з CWD — мінімум, потрібний для опису
+   інтенту й покажчиків:**
+   - `package.json` — лише поля, релевантні до завдання (напр., для "node"
+     — `engines`, `name`, `version`; для "eslint" — `peerDependencies`,
+     `exports`). Не читай поля, які потім не з'являться у промпті.
+   - Структура репо — швидкий огляд (`ls` верхнього рівня), щоб згадати
+     **тип** ("монорепо bun з 7 workspaces" — рядком, не дампом).
+   - **Релевантні файли** — відкривай саме ті, що потрібні щоб знайти
+     `file:line` покажчики на точки правки. Не читай "про запас".
+   - `CLAUDE.md` / `.cursor/rules/*.mdc` — лише **перевір наявність**
+     і назви файлів-правил, які стосуються завдання (LLM прочитає сама).
+
+3. **Визначити "точку патчу"** — 1-5 `path:line` покажчиків на місця, які
+   найімовірніше треба правити, з одним рядком пояснення на кожен.
+
+4. **Сформувати промпт за шаблоном нижче.** Цитуй код **тільки** коли він
+   зовнішній (stderr, лог CI) або уже видалений. Існуючий код у CWD не
+   цитуй — давай `path:line` ref.
+
+5. **Прорахуй cut list:** перед видачею пройдись по секції "Що **не**
+   включати" вище і видали все, що цільова LLM може отримати з 2-3
+   `Read`/`Grep`-викликів у своєму CWD.
+
+6. **Вивести один markdown-блок у чат** — без додаткових коментарів
    поза блоком, окрім однорядкового підпису "готово до копіювання".
 
 ## Шаблон вихідного промпта
 
+Тільки секції, які несуть навантаження. Порожніх не залишай. Зразок:
+
 ````markdown
 ```markdown
 # Завдання
 
-<нормалізований опис з аргументу — 1-3 речення без води>
-
-# Контекст проєкту
+<1-3 речення: що треба і яка причина (баг / новий стек / requirement).
+Якщо bugfix — вкажи симптом одним рядком.>
 
-- Назва / версія: `<name>@<version>`
-- Тип: <library | app | eslint-config | monorepo | …>
-- Стек: Node `<engines.node>`, <TS/JS>, <ключові залежності>
-- Документи правил: <CLAUDE.md / .cursor/rules — або "немає">
+# Симптом / репро
 
-## Структура (skim)
-```
+<тільки для bugfix: точна команда + ключовий рядок stderr/exit code.
+Пропусти секцію, якщо не bugfix.>
 
-<вивід tree -L 2>
-````
+# Точки правки
 
-# Релевантні файли
-
-## `package.json`
-
-```text
-<повний вміст або ключові поля>
-```
-
-## `<інший релевантний файл>`
-
-```<lang>
-<вміст або фрагмент з посиланням на шлях:рядки>
-```
+- `path/to/file.mjs:120` — <одне речення: що тут не так / що зробити>
+- `path/to/other.mjs:34-50` — <…>
 
 # Що треба зробити
 
-- крок 1 — у файлі `X` (`<коротке пояснення>`)
-- крок 2 — у файлі `Y`
-- крок 3 — оновити `CHANGELOG.md` / bump `version`, якщо це npm-пакет
+<бажана поведінка input → output, edge cases, без псевдо-коду й
+покрокових імплементаційних підказок. 3-8 буллетів.>
 
 # Обмеження
 
-- Не ламати публічний API
-- <constraints, виявлені з package.json / конфігів — наприклад "engines.node вже >=22, треба >=25">
-- Дотриматись правил репо (CLAUDE.md / .cursor/rules — посилання вище)
+<тільки реальні, не виводяться з коду: версії у репо-споживачі, breaking-change політика, inflight-міграції. Пропусти секцію, якщо їх нема.>
 
 # Як перевірити
 
-- `<команда з scripts — npm test / bun test / lint>`
-- <конкретні acceptance-checks: "у `engines.node` має бути `>=25`",
-  "CI зелений" тощо>
-
+- `<команда>` — <специфічний до завдання сигнал успіху>
 ```
+````
 
-```
+### Контр-приклад (так робити не треба)
 
-````
+- Секція `# Контекст проєкту` з name/version/stack/docs — LLM прочитає
+  `package.json` сама за 1 виклик.
+- `## Структура (skim)` з `tree -L 2` дампом — шум.
+- `## package.json` з повним JSON — досить рядка про конкретне поле
+  у `Що треба зробити` або `Обмеження`.
+- `## <функція>` з 30 рядками існуючого коду — давай `path:line` ref
+  у `Точки правки`.
+- Покрокові підказки з кодом ("крок 1: import X, крок 2: split…") —
+  опиши поведінку, код напише LLM.
 
 ## Правила
 
 - **Мова промпту:** українська за замовчуванням; якщо аргумент англійською —
   можна англійською. Технічні терміни — англійською.
-- **Обсяг:** прагни вмістити промпт у ~200-500 рядків. Якщо релевантних
-  файлів багато — обери 3-5 найважливіших, решту згадай посиланнями.
-- **Без галюцинацій:** не вигадуй полів `package.json`, версій, шляхів —
-  лише те, що реально прочитав з CWD. Якщо чогось бракує — явно так і
-  напиши ("`engines.node` відсутнє").
+- **Обсяг:** прагни до **30-100 рядків**. Якщо вийшло більше — пройдись
+  по cut list і викинь усе, до чого LLM додумається з кількох
+  `Read`/`Grep`. Більше 150 рядків — майже завжди ознака, що ти цитуєш
+  код, який LLM прочитає сама.
+- **Без галюцинацій:** не вигадуй полів `package.json`, версій, шляхів,
+  номерів рядків — лише те, що реально прочитав з CWD. Якщо чогось
+  бракує — явно так і напиши ("`engines.node` відсутнє").
 - **Без імперативного тону до користувача:** промпт адресований **іншому
   агенту**, не людині. Використовуй "зроби", "онови", "додай".
-- **Без секцій-пустушок:** якщо немає `Обмежень` — пропусти секцію.
+- **Без секцій-пустушок:** якщо немає `Обмежень` чи `Симптому` — пропусти
+  секцію цілком.
 - **Не вмикай у промпт:** секрети, `.env`, `node_modules`, бінарні файли,
-  довгі логи.
+  довгі логи, дампи `tree`, повні JSON конфігів, цитати існуючих
+  helpers/функцій з CWD.
 - **Усе в одному блоці:** результат — це **один** ` ```markdown ` блок;
   ніяких додаткових міркувань поза ним (крім фінального підпису
   "готово до копіювання").
@@ -163,47 +207,32 @@ description: >-
 /n-llm-patch у @nitra/eslint-config підняти engines.node до >=25
 ```
 
-Очікуваний вивід (схематично):
-
-````
+Очікуваний вивід:
 
 ````markdown
+```markdown
 # Завдання
 
-Підняти `engines.node` у `@nitra/eslint-config` до `>=25` і переглянути
-сумісність peer-залежностей з новою версією.
+Підняти `engines.node` у `@nitra/eslint-config` з `>=22` до `>=25`,
+переконатися що peer `eslint ^9` сумісний з Node 25.
 
-# Контекст проєкту
+# Точки правки
 
-- Назва / версія: `@nitra/eslint-config@2.4.0`
-- Тип: shared eslint preset (library)
-- Стек: Node `>=22` (поточне), ESM, eslint `^9`
-- Документи правил: `.cursor/rules/n-js-lint.mdc`
+- `package.json:18` — `engines.node`
+- `CHANGELOG.md` — додати запис; bump `version` (minor)
 
-## Структура (skim)
-
-…
+# Обмеження
 
-# Релевантні файли
+- Дотриматись `.cursor/rules/n-js-lint.mdc`.
+- Якщо `eslint ^9` офіційно не підтримує Node 25 — підняти peer range.
 
-## `package.json`
+# Як перевірити
 
-```json
-{ "engines": { "node": ">=22" }, "peerDependencies": { "eslint": "^9" } }
+- `bun test` — зелений
+- `node -p "require('./package.json').engines.node"` → `>=25`
 ```
 ````
 
-# Що треба зробити
-
-- `package.json` → `engines.node`: `>=22` → `>=25`
-- Перевірити, чи `peerDependencies.eslint ^9` сумісне з Node 25
-- Bump `version` (minor) + запис у `CHANGELOG.md`
-
-# Як перевірити
-
-- `bun test`
-- `node -v` у CI ≥ 25
-
 ```
 готово до копіювання — встав у чат з агентом у цільовому проєкті
 ```