@rt-tools/agent-kit 0.3.0 → 0.4.0

package/assets/checks/check-styles.mjs

@@ -0,0 +1,109 @@
+#!/usr/bin/env node
+/**
+ * Проверка того, что класс элемента BEM подкреплён правилом.
+ *
+ * Класс без правила заводится молча: раскладка переезжает из файла экрана в
+ * общий слой, а `rtElem` остаётся в шаблоне и больше ничему не соответствует.
+ * Ни линт, ни сборка, ни браузер этого не показывают — лишний класс просто
+ * ничего не делает, и разметка обрастает именами, за которыми ничего нет.
+ *
+ * Совпадение считается по имени элемента, а не по паре «блок — элемент»:
+ * `rtElem` берёт имя блока у ближайшего предка с `rtBlock`, и повторить этот
+ * разбор по тексту шаблона нечем. Из-за этого проверка пропускает класс, у
+ * которого правило есть, но у чужого блока, — направление выбрано в сторону
+ * ложных пропусков, а не ложных отказов.
+ *
+ * Динамическое `[rtElem]` не считается: имя там известно только в рантайме.
+ *
+ * Накопленное к моменту заведения проверки лежит в tools/styles-allowlist.json
+ * и отказом не считается: гейт падает на НОВОМ классе без правила, а старое
+ * остаётся видимым числом в сводке.
+ *
+ * Ненулевой код возврата и перечень расхождений.
+ */
+import { readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+
+import { allowlistOf, CONFIG, ROOT } from './rt-kit-checks.config.mjs';
+
+const ALLOWLIST = allowlistOf('styles');
+const SOURCE_ROOTS = CONFIG.sourceRoots;
+const SKIPPED_DIRS = CONFIG.skippedDirs;
+
+const ELEM_RE = /rtElem="([a-z0-9-]+)"/g;
+/** Объявление элемента: и вложенное `&__item`, и полное `.<блок>__item` */
+const RULE_RE = /__([a-z0-9-]+)/g;
+
+const allowlist = JSON.parse(readFileSync(join(ROOT, ALLOWLIST), 'utf8'));
+const known = new Set([...(allowlist.accepted ?? []), ...(allowlist.debt ?? [])]);
+const debt = new Set(allowlist.debt ?? []);
+
+function collectFiles(dir, extension) {
+    const files = [];
+    for (const entry of readdirSync(join(ROOT, dir), { withFileTypes: true })) {
+        if (SKIPPED_DIRS.includes(entry.name)) {
+            continue;
+        }
+        const path = `${dir}/${entry.name}`;
+        if (entry.isDirectory()) {
+            files.push(...collectFiles(path, extension));
+        } else if (entry.name.endsWith(extension)) {
+            files.push(path);
+        }
+    }
+    return files;
+}
+
+const declared = new Set();
+const usedIn = new Map();
+
+for (const root of SOURCE_ROOTS) {
+    for (const path of collectFiles(root, '.scss')) {
+        for (const match of readFileSync(join(ROOT, path), 'utf8').matchAll(RULE_RE)) {
+            declared.add(match[1]);
+        }
+    }
+
+    for (const path of collectFiles(root, '.html')) {
+        for (const match of readFileSync(join(ROOT, path), 'utf8').matchAll(ELEM_RE)) {
+            const name = match[1];
+            if (!usedIn.has(name)) {
+                usedIn.set(name, new Set());
+            }
+            usedIn.get(name).add(path);
+        }
+    }
+}
+
+const findings = [];
+
+for (const [name, files] of [...usedIn].sort(([first], [second]) => first.localeCompare(second))) {
+    if (declared.has(name)) {
+        continue;
+    }
+    const where = [...files].sort().join(', ');
+    findings.push({ key: `elem ${name} @ ${where}`, text: `rtElem="${name}" — правила нет ни в одном файле стилей: ${where}` });
+}
+
+const fresh = findings.filter((finding) => !known.has(finding.key));
+const staleKeys = [...known].filter((key) => !findings.some((finding) => finding.key === key));
+
+if (process.argv.includes('--baseline')) {
+    console.log(JSON.stringify({ ...allowlist, debt: findings.map((finding) => finding.key).sort() }, null, 4));
+    process.exit(0);
+}
+
+const problems = [
+    ...fresh.map((finding) => finding.text),
+    ...staleKeys.map((key) => `${key}: значится в ${ALLOWLIST}, но класс уже подкреплён правилом — строку убрать`),
+];
+
+if (problems.length > 0) {
+    console.error(`check-styles: расхождений ${problems.length}\n`);
+    problems.forEach((problem) => console.error(`  ${problem}`));
+    process.exit(1);
+}
+
+console.log(
+    `check-styles: классов без правила ${findings.length}, из них принято ${findings.length - debt.size}, долг ${debt.size} — новых нет`
+);

package/assets/checks/rt-kit-checks.config.mjs

@@ -0,0 +1,134 @@
+#!/usr/bin/env node
+/**
+ * Настройки проверок: что считать исходниками, куда не ходить и где лежат списки долгов.
+ *
+ * Проверки везёт пакет, а корни и имена — своё у каждого дерева: где-то `apps` и `libs`,
+ * где-то `projects`. Держать их в каждом скрипте отдельно значило бы править девять файлов
+ * ради одного переименования, и девятый забывался бы молча.
+ *
+ * Умолчания здесь, надстройка — `.claude/rt-kit/checks.json` в дереве проекта. Нет файла —
+ * действуют умолчания; есть — его ключи ложатся поверх, по одному, а не целиком: проект,
+ * назвавший только корни, не теряет список пропускаемых каталогов.
+ *
+ * Слияние идёт по вложенным ключам: дерево, назвавшее один ключ борды, сохраняет остальные.
+ * Пока слияние было одноуровневым, вложенный объект замещался целиком, и такое дерево видело
+ * отказ «нет токена бота» — то есть читало неполный конфиг как неполадку машины.
+ *
+ * Глубже вложенных объектов слияние не идёт: список, названный деревом, замещает умолчание
+ * целиком. Дописывать в список нельзя — иначе `skippedDirs`, из которого дерево что-то убрало,
+ * приезжал бы обратно, и убрать оттуда стало бы невозможно вовсе.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+/** Корень дерева: проверки лежат в его `tools/`, поэтому на уровень выше. */
+export const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+
+const CONFIG_PATH = '.claude/rt-kit/checks.json';
+
+const DEFAULTS = {
+    /** Где лежит код, который проверки читают. */
+    sourceRoots: ['apps', 'libs'],
+    /** Куда не ходить никогда: сборка, зависимости, порождённое. */
+    skippedDirs: ['node_modules', 'dist', '.git', '.nx', 'tmp', 'coverage', 'worktrees', 'gen', 'generated'],
+    /** Где лежат тексты проекта. */
+    docsDir: 'docs',
+    /** Отложенное: про него проверки молчат — оно описывает прошлое, а не дерево. */
+    archiveDir: 'docs/archive/',
+    /** Где лежат спеки доменов; пусто — их в дереве нет, и сверка спеков не запускается. */
+    specsDir: 'docs/specs',
+    tasksDir: 'docs/tasks',
+    /** Куда сложены списки принятых долгов. */
+    allowlistDir: 'tools',
+    /** Корни сквозных тестов; пусто — их в дереве нет. */
+    e2eRoots: ['apps/site-e2e', 'apps/admin-e2e'],
+    /** Корни бэкенда: у него нет ни компонентов, ни шаблонов, и часть признаков к нему не применяется. */
+    backendRoots: ['libs/api/', 'apps/api/'],
+    /** Схема хранилища и её миграции; пусто — хранилища в дереве нет. */
+    schemaFile: 'prisma/schema.prisma',
+    migrationsDir: 'prisma/migrations',
+    /** Каталог, под которым лежат семьи либ: `<корень>/<семья>/<домен>/<слой>`. */
+    libsRoot: 'libs',
+    /** Семьи фронтовых либ: `<корень либ>/<семья>/<домен>/<слой>`. */
+    families: ['site', 'admin'],
+    /** Семья бэкенда под тем же корнем: у её доменов своя лесенка слоёв. */
+    apiFamily: 'api',
+    /** Область алиасов импорта: `@область/<семья>/<домен>/<слой>` в `tsconfig.base.json`. */
+    importScope: '@app',
+    /**
+     * Признаки боевого хранилища: порт, адрес, имя домена. Проверки туда не ходят ни читать,
+     * ни писать — схема на проде меняется выкаткой. Пусто — признаков нет, и адрес боевым
+     * не считается никогда.
+     */
+    productionMarks: [],
+    /** Очередь работ: владелец, репозиторий, борда и учётная запись машинной работы. */
+    board: {
+        owner: '',
+        repo: '',
+        projectId: '',
+        /** Ключ задач: даёт ветку `<ключ>-<номер>-<slug>` и заголовок `[<ключ>-<номер>]`. */
+        taskKey: '',
+        bot: '',
+        tokenPath: '',
+        reviewer: '',
+    },
+};
+
+function readOverrides() {
+    const path = join(ROOT, CONFIG_PATH);
+    if (!existsSync(path)) {
+        return {};
+    }
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    } catch (error) {
+        console.error(`${CONFIG_PATH} — не разбирается как JSON: ${error.message}`);
+        process.exit(1);
+    }
+}
+
+/**
+ * Слияние надстройки с умолчанием по вложенным ключам.
+ *
+ * Объект сливается ключ за ключом, всё остальное — замещается: список, названный деревом,
+ * приходит целиком, потому что «дописать в список» и «убрать из списка» — разные действия, а
+ * различить их в JSON нечем.
+ */
+const mergeDeep = (base, over) => {
+    const isPlain = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+    if (!isPlain(base) || !isPlain(over)) {
+        return over === undefined ? base : over;
+    }
+    const merged = { ...base };
+    for (const [key, value] of Object.entries(over)) {
+        merged[key] = mergeDeep(base[key], value);
+    }
+
+    return merged;
+};
+
+/** Настройки этого дерева: умолчания пакета, поверх них — то, что назвал проект. */
+export const CONFIG = mergeDeep(DEFAULTS, readOverrides());
+
+/** Путь к списку принятых долгов по имени проверки: `dupes` → `tools/dupes-allowlist.json`. */
+export const allowlistOf = (name) => join(CONFIG.allowlistDir, `${name}-allowlist.json`);
+
+/**
+ * Список долгов; нет файла — пустой. Заводить его руками не требуется: проверка, встреченная
+ * впервые, покажет всё найденное как новое, и это честнее, чем молчать из-за отсутствия файла.
+ */
+export const readAllowlist = (name) => {
+    const path = join(ROOT, allowlistOf(name));
+
+    return existsSync(path) ? JSON.parse(readFileSync(path, 'utf8')) : {};
+};
+
+/** Есть ли в дереве то, без чего проверке нечего делать. Нет — она выходит с нулём и говорит это. */
+export const skipUnless = (present, what) => {
+    if (present) {
+        return false;
+    }
+    console.log(`пропущено: в дереве нет ${what}`);
+    process.exit(0);
+};

package/assets/checks/task-new.github.mjs

@@ -0,0 +1,198 @@
+#!/usr/bin/env node
+/**
+ * Заведение задачи, с которой начинается правка.
+ *
+ * Заведение состоит из четырёх шагов, и правка начинается только после всех
+ * четырёх: тикет, номер в его заголовке, добавление на борду, состояние
+ * «Backlog». Пока шаги переписывались руками из паттерна, промах на любом из
+ * них давал задачу, которой нет в очереди работ: две такие простояли месяц.
+ *
+ * Ветку команда не заводит — печатает готовую строку. Заведение ветки отдельным
+ * вызовом требует гард главной ветки: составную «создать ветку и сразу
+ * коммитить» он отклоняет целиком.
+ *
+ *   npm run task:new -- --title 'Письма владельцу не уходят' --label bug --label area:api
+ *   npm run task:new -- --title '…' --slug mail-owner-silence < описание.md
+ *
+ * Тело читается со стандартного ввода. Автор и исполнитель — учётная запись бота,
+ * та же, от которой идут коммиты; `--assignee` перекрывает исполнителя.
+ */
+import { existsSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import {
+    BACKLOG_OPTION_ID,
+    BOT,
+    IN_PROGRESS_STATUS,
+    OfflineError,
+    OWNER,
+    PROJECT_ID,
+    REPO,
+    STATUS_FIELD_ID,
+    TASK_KEY,
+    TOKEN_PATH,
+    botToken,
+    gh,
+    ghJson,
+    graphql,
+    numberFromTitle,
+} from './board.mjs';
+
+function parseArgs(argv) {
+    const args = { labels: [], assignee: BOT, title: null, slug: null };
+    for (let index = 0; index < argv.length; index += 1) {
+        const value = argv[index + 1];
+        switch (argv[index]) {
+            case '--title':
+                args.title = value;
+                index += 1;
+                break;
+            case '--label':
+                args.labels.push(value);
+                index += 1;
+                break;
+            case '--assignee':
+                args.assignee = value;
+                index += 1;
+                break;
+            case '--slug':
+                args.slug = value;
+                index += 1;
+                break;
+            default:
+                fail(`неизвестный ключ ${argv[index]}`);
+        }
+    }
+    return args;
+}
+
+function fail(message) {
+    console.error(`task-new: ${message}`);
+    process.exit(1);
+}
+
+function readBody() {
+    if (process.stdin.isTTY) {
+        return '';
+    }
+    try {
+        return readFileSync(0, 'utf8').trim();
+    } catch {
+        return '';
+    }
+}
+
+const args = parseArgs(process.argv.slice(2));
+if (!args.title) {
+    fail("нужен --title '<Что не так>'");
+}
+if (numberFromTitle(args.title) !== null || args.title.startsWith(`[${TASK_KEY}-`)) {
+    fail('номер в заголовок не пишется руками: он известен только после заведения и дописывается сам');
+}
+if (args.slug !== null && !/^[a-z0-9][a-z0-9-]*$/.test(args.slug)) {
+    fail('slug — строчные латинские буквы, цифры и дефисы: имя ветки читают в списке из полусотни строк');
+}
+
+const token = botToken();
+if (!token) {
+    fail(`нет токена бота (${TOKEN_PATH}): задача завелась бы от чужого имени`);
+}
+
+let number = null;
+try {
+    const created = gh(
+        [
+            'issue',
+            'create',
+            '--repo',
+            `${OWNER}/${REPO}`,
+            '--title',
+            args.title,
+            '--body',
+            readBody(),
+            '--assignee',
+            args.assignee,
+            ...args.labels.flatMap((label) => ['--label', label]),
+        ],
+        { token }
+    ).trim();
+    number = Number(created.split('/').pop());
+    if (!Number.isInteger(number)) {
+        fail(`не разобрать номер заведённой задачи в ответе: ${created}`);
+    }
+
+    // Номер известен только теперь, поэтому заголовок дописывается вторым вызовом.
+    gh(['api', '-X', 'PATCH', `repos/${OWNER}/${REPO}/issues/${number}`, '-f', `title=[${TASK_KEY}-${number}] ${args.title}`], {
+        token,
+    });
+
+    const issueId = ghJson(['api', `repos/${OWNER}/${REPO}/issues/${number}`, '--jq', '{id:.node_id}'], { token }).id;
+    const itemId = graphql(
+        `mutation { addProjectV2ItemById(input: {projectId: "${PROJECT_ID}", contentId: "${issueId}"}) { item { id } } }`,
+        { token }
+    ).data.addProjectV2ItemById.item.id;
+    graphql(
+        `mutation { updateProjectV2ItemFieldValue(input: {projectId: "${PROJECT_ID}", itemId: "${itemId}", fieldId: "${STATUS_FIELD_ID}", value: {singleSelectOptionId: "${BACKLOG_OPTION_ID}"}}) { projectV2Item { id } } }`,
+        { token }
+    );
+} catch (error) {
+    const reason = error instanceof OfflineError ? `нет связи с GitHub: ${error.message}` : String(error.message ?? error);
+    if (number === null) {
+        fail(reason);
+    }
+    // Тикет уже есть, а на борде его может не быть — ровно то состояние, из-за которого
+    // задачи и терялись. Молчать здесь нельзя: номер печатается, чтобы доделать руками.
+    console.error(`task-new: задача #${number} заведена, но доведена не до конца — ${reason}`);
+    console.error(`task-new: проверь и доправь — npm run check:board`);
+    process.exit(1);
+}
+
+const branch = args.slug ? `${TASK_KEY}-${number}-${args.slug}` : `${TASK_KEY}-${number}-<короткий-slug>`;
+
+/**
+ * Папка задачи переименовывается здесь, потому что номер и имя ветки в этот момент известны
+ * единственный раз за всю работу. Разбор просьбы владельца идёт до заведения задачи — до
+ * конца разбора неизвестно даже, сколько задач из него выйдет, — и лежит в
+ * `docs/tasks/_draft-<slug>`. Оставленный черновиком, он остаётся вне истории, а следующий
+ * заход его не находит: хук запуска ищет папку по имени ветки.
+ */
+function adoptDraft() {
+    if (!args.slug) {
+        console.log(`\nПапка задачи: --slug не задан, переименовать черновик нечем.`);
+        return;
+    }
+    const root = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+    const draft = join(root, 'docs/tasks', `_draft-${args.slug}`);
+    const target = join(root, 'docs/tasks', branch);
+
+    if (existsSync(target)) {
+        console.log(`\nПапка задачи уже на месте: docs/tasks/${branch}/`);
+    } else if (existsSync(draft)) {
+        renameSync(draft, target);
+        console.log(`\nПапка задачи: docs/tasks/_draft-${args.slug}/ → docs/tasks/${branch}/`);
+    } else {
+        console.log(`\nПапка задачи собирается с образца:\n  cp -r docs/tasks/_template docs/tasks/${branch}`);
+        return;
+    }
+
+    // Шапку замысла читает гард: по ней он находит договорённость о продукте. Номер в ней
+    // проставляется здесь же — руками его переписывают из подсказки и ошибаются.
+    const plan = join(target, 'plan.md');
+    if (!existsSync(plan)) {
+        return;
+    }
+    const before = readFileSync(plan, 'utf8');
+    const after = before.replace(/^\*\*Задача:\*\*.*$/m, `**Задача:** ${TASK_KEY}-${number} · **Ветка:** ${branch}`);
+    if (after !== before) {
+        writeFileSync(plan, after);
+        console.log(`Шапка замысла проставлена: docs/tasks/${branch}/plan.md`);
+    }
+}
+
+adoptDraft();
+
+console.log(`[${TASK_KEY}-${number}] ${args.title}`);
+console.log(`https://github.com/${OWNER}/${REPO}/issues/${number}`);
+console.log(`\nВетка заводится отдельным вызовом:\n  git checkout -b ${branch}`);
+console.log(`Взятая в работу задача переставляется на борде:\n  npm run task:move -- ${number} ${IN_PROGRESS_STATUS}`);

package/assets/commands/skill-curator.md

@@ -0,0 +1,70 @@
+---
+description: Разбор закрытой задачи глазами правил дерева — что грузилось, что помогло, чего не хватило
+argument-hint: '[пусто | <акцент, на что смотреть в первую очередь>]'
+---
+
+Запусти агента `skill-curator` на разбор только что закрытой задачи. Акцент от пользователя:
+`$ARGUMENTS`
+
+Вызывается **после того, как задача сделана и проверена**, до перехода к следующей. Агент ничего
+не правит — приносит готовые формулировки, а решение вставлять их принимает пользователь.
+
+## 1. Найди список загруженного
+
+Гейт правил пишет его по одному файлу на сессию:
+
+```bash
+ls -t "${TMPDIR}claude-skill-gate/"*.loaded | head -5
+```
+
+Нужен файл **текущей** сессии: её идентификатор стоит в пути скретчпада из системного
+приглашения. Брать самый свежий по времени вслепую нельзя — параллельная сессия в другом окне
+обгонит твою, и разбор уедет на чужую задачу.
+
+Запись обнуляется при сжатии контекста, поэтому список покрывает последний отрезок сессии. Если
+знаешь, что грузилось раньше, — допиши это в сводку словами, а не выдавай список за полный.
+
+## 2. Собери сводку
+
+Без неё разбор выродится в пересказ правил: агент не видел ни задачи, ни того, где ты
+спотыкался. В сводке:
+
+- **что делали** — задача одной фразой, объём числами (файлов, коммитов, ветка);
+- **что пошло не так** — по пунктам, и это главная часть. Каждый: что сломалось, чем ловилось
+  (или почему не поймалось ничем), нашёл ты сам или проверка;
+- **что было под рукой** — какие правила грузились и что каждое дало: где сработало, где
+  промолчало, где увело не туда. Правило, которое загрузилось и не пригодилось, — такая же
+  находка, как недостающее;
+- **грабли окружения** — правило линтера, ограничение инструмента, поведение стенда, на которые
+  наткнулись и которых нет ни в одном правиле.
+
+Честность здесь дороже полноты: «нашёл разбор, а не я» и «пункт был помечен сделанным по работе,
+которой не было» — ровно то, из чего получаются правила. Приглаженная сводка даёт приглаженный
+разбор.
+
+## 3. Запусти агента
+
+Инструментом `Agent`, `subagent_type: 'skill-curator'`. В промпт — путь к `.loaded` и сводку
+целиком.
+
+## 4. Отдай результат
+
+Покажи предложения агента **как есть**: он пишет готовый текст для вставки, и пересказ его
+портит. По каждому скажи своё — согласен или нет и почему; правило, с которым ты не согласен,
+вставлять не надо.
+
+У каждого предложения агент ставит пометку «пакет», «компаньон» или «дерево»: тексты приезжают
+из `@rt-tools/agent-kit`, и правка разложенного файла на месте теряется на следующем
+`agent-kit sync`. Пометку оставляй в тексте предложения — решает по ней человек.
+
+Куда что идёт:
+
+- **пакет** — правка ресурса в `@rt-tools/agent-kit`; сюда же попадает всё, что верно любому
+  дереву мастерской;
+- **компаньон** — `implementation.md` рядом с правилом: имена этого дерева и привязка статей;
+- **дерево** — надстройка: `.claude/rt-kit/overrides/<идентификатор>` для текстов,
+  `.claude/rt-kit/gate-map.sh` и `project.sh` для карты и профиля.
+
+Правило и его компаньон меняются вместе: расхождение между ними хуже отсутствия правила. Новое
+правило требует ещё и записи в карте гейта, иначе его никто не загрузит, — а после правки карты
+или хука обязателен прогон их сценариев целиком.

package/assets/defaults/gate-map.sh

@@ -0,0 +1,100 @@
+#!/usr/bin/env bash
+# Карта «что правится — какое правило». Умолчание пакета: настоящие пути, а не образцы.
+#
+# Деревья этой мастерской устроены одинаково — Nx, `apps/` и `libs/`, те же расширения и те же
+# имена каталогов, — поэтому карту везёт пакет, а не пишет каждый проект заново. Пятнадцать её
+# редакций расходились бы молча, и заметить расхождение можно было бы только по тому, что гейт
+# перестал требовать правило там, где оно есть.
+#
+# Своё дерево дописывает надстройкой — `.claude/rt-kit/gate-map.sh`. Она грузится второй,
+# объявляет `skill_for` заново и зовёт отсюда `skill_for_default` для всего, чего не назвала.
+#
+# Функция печатает ИМЯ ПРАВИЛА или молчит. Молчание — «правила на это нет», и гейт пропускает.
+# Имён может быть несколько, по одному в строке: первое — доменное правило файла, следующие —
+# те, что действуют вторым слоем. Гейт потребует первое незагруженное.
+#
+# Порядок веток решает: первое совпадение выигрывает, поэтому частное идёт раньше общего.
+
+# Правила, которые вступают не от рода файла, а от того, что в него пишут.
+#
+# Обращение к среде исполнения приходит в обычный сервис, а число-настройка и перечисление —
+# в обычный класс: по имени файла ни то ни другое не видно, и правило, требуемое только по
+# расширению, здесь молчало бы.
+skill_for_written() {
+    target="$1"
+    written="$2"
+
+    [ -z "$written" ] && return 0
+
+    case "$target" in
+        *.spec.ts | */docs/* | *.md) return 0 ;;
+    esac
+
+    printf '%s' "$written" | grep -qE '(globalThis|window\.|document\.defaultView|PLATFORM_ID|isPlatformBrowser|localStorage|sessionStorage)' \
+        && printf '%s\n' 'platform-access'
+
+    case "$target" in
+        *.ts)
+            printf '%s' "$written" | grep -qE '^[[:space:]]*(export[[:space:]]+)?(const[[:space:]]+[A-Z][A-Z0-9_]*[[:space:]]*(:[^=]*)?=[[:space:]]*-?[0-9]|enum[[:space:]])' \
+                && printf '%s\n' 'shared-code'
+            ;;
+    esac
+
+    return 0
+}
+
+skill_for_default() {
+    kind="$1"
+    target="$2"
+    written="$3"
+
+    case "$kind" in
+        edit)
+            case "$target" in
+                # Файлы самого агента правятся без правила: правило на них — это оно само.
+                */.claude/skills/* | */.claude/agents/* | */.claude/commands/* | */.claude/workflows/*) return 0 ;;
+
+                # Тексты проекта. Спек держит устройство домена, закон — договорённость,
+                # и оба правятся не так, как правится код.
+                */docs/specs/*) printf '%s\n' 'spec-driven' ;;
+                */docs/tasks/*) printf '%s\n' 'task-flow' ;;
+                */docs/constitution/*) printf '%s\n' 'spec-driven' ;;
+                *.md) printf '%s\n' 'doc-style' ;;
+
+                # Поставка: состав зависимостей — это то, что приезжает на прод.
+                */package.json | */pnpm-lock.yaml | */pnpm-workspace.yaml | */package-lock.json) printf '%s\n' 'dependencies' ;;
+
+                # Границы между либами: манифест, алиасы, барель.
+                */project.json | */tsconfig.base.json | */eslint/boundaries/* | */src/index.ts | */public-api.ts | */ng-package.json)
+                    printf '%s\n' 'lib-layers' ;;
+
+                *.spec.ts) printf '%s\n' 'testing' ;;
+                *.component.ts | *.component.html) printf '%s\n' 'component-structure' ;;
+                *.scss) printf '%s\n' 'styling-bem' ;;
+
+                # Классы каркаса: состояние, потоки и место подписки. Бэкенд сюда не идёт —
+                # ни компонентов, ни подписок в шаблоне у него нет.
+                */libs/api/* | */apps/api/*) printf '%s\n' 'typescript-conventions' ;;
+                *.store.ts | *.service.ts | *.directive.ts | *.pipe.ts | *.guard.ts | *.interceptor.ts) printf '%s\n' 'angular-patterns' ;;
+
+                *.ts) printf '%s\n' 'typescript-conventions' ;;
+            esac
+            skill_for_written "$target" "$written"
+            ;;
+        bash)
+            case "$target" in
+                *git\ commit* | *git\ push* | *git\ merge* | *git\ rebase* | *git\ cherry-pick* | *gh\ pr\ * | *glab\ mr\ * | *az\ repos\ *)
+                    printf '%s\n' 'git-workflow' ;;
+                *prisma\ migrate* | *prisma\ db\ *) printf '%s\n' 'git-workflow' ;;
+                *curl\ *localhost* | *wget\ *localhost*) printf '%s\n' 'browser-verification' ;;
+            esac
+            ;;
+    esac
+
+    return 0
+}
+
+# Без надстройки проекта карта — это умолчание. С надстройкой она объявит `skill_for` заново.
+skill_for() {
+    skill_for_default "$@"
+}