agent-quality-kit 0.2.4 → 0.3.0

package/tool/i18n/ru.mjs

@@ -0,0 +1,424 @@
+// tool/i18n/ru.mjs — русский каталог строк вывода.
+//
+// Правка здесь обязана иметь пару в en.mjs с тем же ключом: расхождение ловит модульная
+// проверка «оба каталога несут одни и те же ключи». Иначе один язык молча отстаёт, а
+// обещание «два языка» превращается в слова.
+
+import { templates } from "./templates-ru.mjs";
+
+export const ru = {
+  templates,
+  help: {
+    tagline: "оснастка для разработки с агентами",
+    name: "<имя>",
+    init: "разложить правила и методички в текущий проект",
+    initForce: "перезаписать уже существующие файлы",
+    start: "кода ещё нет: сторожа дня 0 и порядок работы",
+    doctor: "проверить, что разложено и чего не хватает",
+    doctorRun: "ещё и запустить объявленные гейты",
+    add: "поставить гейт из каталога в проект",
+    find: "есть ли уже такой гейт — сверка по намерению",
+    why: "поймал ошибку — почему её не поймал сторож",
+    ratchet: "храповик: старые нарушения — долг, новые не пускать",
+    new: "заготовка своего гейта для каталога",
+    note: "записать урок в общий журнал шишек",
+    blob: "собрать методички в один файл GOD_AI.md",
+    report: "обязательная форма отчёта: что стоит, что нет, что не прочитано",
+    noInstall: "Без установки:  npx agent-quality-kit init",
+    language: "Язык вывода: AQK_LANG=en (или ru), иначе по системной локали",
+  },
+
+  doctor: {
+    docsKit: "методички — здесь оригиналы, а не копия",
+    docs: "методички",
+    rulesKit: "стандарты — здесь оригиналы, а не копия",
+    rules: "стандарты",
+    agents: "точка входа для агентов",
+    gitignore: "гигиена репозитория",
+    git: "проект под контролем версий",
+
+    emptyCommands: (n) => `В AGENTS.md ${n} незаполненных команд.`,
+    emptyCommandsWhy: "Агент не может выполнить пустую строку.",
+
+    levelHeading: "Уровень соответствия AQK",
+    levelNone: "нет",
+    levelNotSet: "Уровень: стандарт в этом репозитории не заведён.",
+    levelNotSetWhy: [
+      "Это не оценка проекта. Уровень мерит не зрелость практики, а то, можно ли",
+      "прочитать её машиной. Проверки могут стоять и работать — но пока они не",
+      "объявлены в .aqk.yml, ни агент, ни конвейер, ни новый человек о них не знают.",
+    ],
+    levelManifestNoZero: "Уровень: манифест есть, но AQK-0 не пройден.",
+    level: (n) => `Уровень: AQK-${n}.`,
+    toReach: (n) => `Чтобы достичь AQK-${n}:`,
+    gives: (what) => `Что это даст: ${what}`,
+    allDone: "Все ступени пройдены.",
+
+    gatesHeading: "Гейты",
+    langs: "языки",
+    langsUnknown: "не определены",
+    files: "файлов",
+    hasThings: "есть",
+    install: (cmd) => `поставить: ${cmd}`,
+    notApplicable: (n) => `Не применимо к этому репозиторию (${n}):`,
+    total: "Итого:",
+    totalHeld: (n) => `держит машина ${n}`,
+    totalTodo: (n) => `применимо но не поставлено ${n}`,
+    totalSkip: (n) => `скрыто ${n}`,
+
+    runHeading: "Прогон объявленных гейтов",
+    timeout: "не уложился в 5 минут",
+    exitCode: (code) => `код ${code}`,
+    moreLines: (n) => `… и ещё ${n} строк`,
+    declaredNotRun: (n) => `${n} гейтов объявлено, но не запускалось.`,
+    declaredNotRunWhy: (cmd) => ` «Объявлен» и «работает» — разные утверждения: ${cmd}`,
+
+    thresholdPass: (min) => `Порог AQK-${min} пройден.`,
+    thresholdFail: (min, now) => `Порог AQK-${min} НЕ пройден: сейчас AQK-${now}.`,
+  },
+
+  trigger: {
+    noLangs: (langs) => `нет языков: ${langs}`,
+    tooFewFiles: (n) => `меньше ${n} файлов — рано`,
+    tooManyFiles: (n) => `больше ${n} файлов`,
+    notSet: "триггер не задан",
+    unknown: (key) => `условие «${key}» программа не умеет считать`,
+    flags: {
+      has_gates: ["в манифесте не объявлено ни одного гейта", "гейты уже объявлены"],
+      has_ci: ["в репозитории нет конвейера", "конвейер уже есть"],
+      has_db: ["не видно базы данных: ни миграций, ни sql", "база данных есть"],
+      has_docker: ["нет Dockerfile или compose", "docker уже есть"],
+      has_deps: ["не видно файла зависимостей", "зависимости объявлены"],
+      has_tests: ["не видно тестов", "тесты есть"],
+      has_env: ["нет файла окружения", "файл окружения есть"],
+    },
+  },
+
+  recipe: {
+    skipped: (lang, prog) => `рецепт под ${lang} пропущен: «${prog}» не установлен`,
+    none: "рецепт не описан",
+  },
+
+  manifest: {
+    noGatesBlock: "в .aqk.yml нет блока gates:",
+    alreadyDeclared: "уже объявлен",
+  },
+
+  add: {
+    noSuchGate: (slug, cmd) => `Нет такого гейта: ${slug}\nСписок применимых — ${cmd}`,
+    noRecipe: (slug, stack) => `У записи ${slug} нет команды ни под ${stack}, ни общей.`,
+    thisStack: "этот стек",
+    needName: (cmd, doctor) => `Укажи имя гейта: ${cmd}. Список — ${doctor}`,
+    noManifest: (cmd) => `Нет .aqk.yml — сначала ${cmd}`,
+    notApplicable: (why) => `Этот гейт к репозиторию не применим: ${why}`,
+    installAnyway: "Ставлю всё равно — решение твоё, но сторожить ему нечего.",
+    copied: (n) => `${n} файлов: проверка и образцы`,
+    declared: (cmd) => `гейт объявлен: ${cmd}`,
+    notDeclared: (why, slug, cmd) => `не тронут (${why}). Впиши сам: ${slug}: "${cmd}"`,
+    nextTitle: "Дальше:",
+    next1: "Проверь, что он краснеет и молчит там, где должен:",
+    expectFail: "→ ожидается отказ",
+    expectSilence: "→ ожидается тишина",
+    next2: "Впиши команду в хук коммита и в конвейер.",
+    next2Why: "Гейт, который никто не запускает, — не гейт.",
+    next3: (cmd) => `Прогон всех объявленных: ${cmd}`,
+  },
+
+  gnew: {
+    needName: (cmd) => `Укажи имя: ${cmd}`,
+    badName: (slug) => `Имя «${slug}» не годится: латиница через дефис, например secrets-not-in-code.\nИмя читают в чужих проектах — оно часть словаря.`,
+    looksExisting: (slug) => `Похоже, такое уже есть: ${slug}`,
+    recipeNotGate: "Рецепт под другой стек — это строка в recipes существующей записи.",
+    forceHint: (cmd) => `Всё равно завести новую: ${cmd}`,
+    exists: (path) => `${path} уже существует.`,
+    nextTitle: "Дальше — по порядку:",
+    n1: "Проверь, нет ли готового правила",
+    n1Where: "в ruff, eslint, semgrep.",
+    n1Why: "Готовое точнее, подробнее и его поддерживают без тебя. Своя проверка — запасная.",
+    n2: "Положи образцы.",
+    n2Red: "— код, на котором проверка обязана сработать.",
+    n2Green: "— тот же код, но правильный.",
+    n2Why: "Зелёный важнее: он ловит проверку, которая краснеет на исправном коде.",
+    n3: "Напиши проверку",
+    n3Where: "в check.sh. В тексте отказа — что именно сделать.",
+    n4: "Заполни gate.yml:",
+    n4What: "намерение, триггер, доказательство отказом.",
+    n5: "Прогони:",
+    n5Why: "Арбитр обязан покраснеть на red/ и промолчать на green/. Не прошло — не запись.",
+  },
+
+  ratchet: {
+    needName: (cmd) => `Укажи гейт: ${cmd}. Он должен быть уже объявлен в .aqk.yml`,
+    noManifest: (cmd) => `Нет .aqk.yml — сначала ${cmd}`,
+    notDeclared: (slug, cmd) => `Гейт «${slug}» не объявлен в .aqk.yml. Сначала: ${cmd}`,
+    already: (slug) => `На гейте «${slug}» храповик уже стоит.`,
+    notRunnable: (slug, cmd) =>
+      `Гейт «${slug}» не запускается: ${cmd}\n` +
+      `Снимать долг с несуществующего сторожа нельзя — в реестр попадут его же сообщения\n` +
+      `об ошибке, и он станет разрешением. Сначала почини команду.`,
+    registryHead: (slug, stamp) =>
+      `# Реестр долга: ${slug}\n` +
+      `# Снят ${stamp}. Список разрешается ТОЛЬКО укорачивать.\n` +
+      `# Новое нарушение красит гейт; исправленное вычёркивается автоматически.\n`,
+    recorded: (n) => `${n} нарушений записано долгом`,
+    libCopied: "обёртка скопирована в проект",
+    wrapped: "команда завёрнута в храповик",
+    changesTitle: "Что это меняет:",
+    fromToday: "со дня установки",
+    changes1: (fromToday) => `Правило действует ${fromToday}. Старый код трогать не надо, но новое`,
+    changes2: "нарушение того же класса гейт не пропустит.",
+    test1: "Проверка, что это храповик, а не советчик: «может ли новый код добавить нарушение",
+    test2: "и пройти?» Может — значит гейта нет.",
+    run: (cmd) => `Прогнать: ${cmd}`,
+  },
+
+  find: {
+    needQuery: (cmd) => `Опиши намерение словами: ${cmd}`,
+    example: 'find "отладочная печать не доезжает до прода"',
+    exists: "Такое уже есть — новую запись заводить не надо:",
+    match: (pct) => `совпадение ${pct}%`,
+    recipes: (langs) => `рецепты: ${langs}общий`,
+    existsWhy1: "Если у тебя рецепт под другой стек — это строка в recipes существующей",
+    existsWhy2: "записи, а не новый гейт. Намерение одно, исполнителей может быть много.",
+    near: "Точного совпадения нет, но рядом лежит:",
+    nearWhy: "Прочитай их README. Если намерение то же — дополняй, а не заводи новое.",
+    none: "Такого намерения в каталоге нет.",
+    journal: "В журнале есть шишка на эту тему:",
+    journalWhy: "Шишка записана — значит доказательство для новой записи уже есть.",
+    howTitle: "Как добавить свой гейт:",
+    how1: "Назови отказ.",
+    how1What: "Какой конкретный брак он поймал в живом проекте, чего это стоило.",
+    how1Why: "«Это хорошая практика» не принимается: так каталог набирает сотни пунктов и умирает.",
+    how2: "Заведи папку",
+    how2What: "— gate.yml, red/, green/, README.md.",
+    how2Why: "Норма записи со всеми полями — kit/gates/README.md",
+    how3: "Проверь машиной:",
+    how3Why: "Арбитр обязан покраснеть на red/ и промолчать на green/. Не прошло — не запись.",
+    how4: "Пришли изменением",
+    how4What: "в репозиторий комплекта.",
+  },
+
+  why: {
+    needQuery: (cmd) => `Опиши, что пропустили: ${cmd}`,
+    example: 'why "файл вырос до девяти тысяч строк"',
+    ciAtOnce: "разом: doctor --run",
+    ciOwnStep: "отдельным шагом",
+    unsure: "Уверенного совпадения нет. Похоже на эти записи:",
+    unsureByName: (cmd) => `Назови запись именем: ${cmd}`,
+    unsureNone: (cmd) => `Ни одна не подходит — значит сторожа не было: ${cmd}`,
+    decideTitle: "Дальше решаешь ты:",
+    decideQ: "это твоя частность или общий случай?",
+    decideWhy: "Общий — идёт в каталог и достаётся всем. Частный — остаётся у тебя.",
+    decideNote: (cmd) => `Урок в общий журнал в любом случае: ${cmd}`,
+    fix: "Почини так:",
+    noGuard: "Сторожа не было.",
+    noGuardWhy: "В каталоге нет записи с таким намерением.",
+    noGuardFix: (cmd) => `заведи запись — ${cmd}`,
+    noGuardHint: "Красный образец бери прямо из этой поломки: она уже случилась, выдумывать нечего.",
+    closest: (slug, pct) => `Ближайшая запись каталога: ${slug}  совпадение ${pct}%`,
+    notInstalled: "Сторож есть в каталоге, но в этом проекте не поставлен.",
+    notInstalledHint1: "Он покраснеет на старом коде — это нормально: старое закрывается храповиком,",
+    notInstalledHint2: (cmd) => `новое ловится со дня установки. ${cmd}`,
+    declaredAs: (cmd) => `Объявлен: ${cmd}`,
+    notRunning: "Сторож объявлен, но не запускается.",
+    notRunningWhy: "Худший случай: тишина читается как успех.",
+    notRunningFix: "путь или программа из команды не существуют — проверь их.",
+    notRunningHint: "Отсутствие сигнала неотличимо от успеха, поэтому это не «мелочь в конфиге».",
+    bypassed: "Сторож есть и эту поломку ловит — значит его обошли.",
+    noCiFix: "конвейера нет. Проверка, которую гоняет только человек,",
+    noCiHint: "работает ровно до первого «забыл».",
+    notInCiFix: "конвейер есть, но этот гейт в нём не запускается.",
+    notInCiHint: (cmd) => `Дешевле всего одним шагом: ${cmd} — он гоняет всё объявленное.`,
+    inCiFix: (how) => `конвейер его гоняет (${how}) — значит красный прогон`,
+    inCiHint1: "кто-то пропустил или обошёл. Перенеси правило из текста в механику:",
+    inCiHint2: "блокирующий шаг, а не необязательный; запрет слияния при красном.",
+    blind: "Сторож есть, стоит и запускается — но этой поломки не видит.",
+    blindFix: (dir) => `положи в ${dir} кусок кода из этой поломки`,
+    blindHint1: "и доведи проверку до красного на нём. Порядок обратный привычному: сначала",
+    blindHint2: "образец, потом правка — иначе непонятно, что именно починено.",
+    blindCheck: "Проверить после правки: bash tool/selfcheck/gates.sh",
+  },
+
+  init: {
+    noDocs: (dir) => `Не найден корпус методичек: ${dir}\nПохоже, пакет установлен не полностью.`,
+    created: (n) => `создано (${n}):`,
+    andMore: (n) => `… и ещё ${n}`,
+    kept: (n) => `уже были на месте, не тронуты (${n}):`,
+    overwrite: (cmd) => `перезаписать: ${cmd}`,
+    nextTitle: "Что дальше — по порядку:",
+    n1a: "Открой",
+    n1b: "и заполни раздел «Команды». Команда, которую нельзя",
+    n1c: "скопировать и выполнить, — не команда, а пожелание.",
+    n2a: "Прочитай",
+    n2b: "— это обязательный минимум",
+    n2c: "проекта без привязки к языку. Пройди сверху вниз и отметь, чего нет.",
+    n3a: "Заполни",
+    n3b: "— гейты, образцы, журнал. Уровень соответствия AQK",
+    n3c: (cmd) => `считается по нему: ${cmd}.`,
+    n4a: "Поднимайся по ступеням",
+    n4b: "по одной",
+    n4c: ". Гейт стережёт существующий артефакт:",
+    n4d: "проверка на код, которого ещё нет, — мёртвое правило.",
+    burned: (cmd) => `Обжёгся на чём-то — запиши: ${cmd}`,
+  },
+
+  feedback: {
+    title: "Если пригодилось:",
+    star: (url) => `Поставь звезду — ${url}`,
+    issue: "Нашёл баг или не подошло — заведи Issue, самая полезная обратная связь: и то и другое.",
+    once: "Это разовое сообщение: больше не покажется на этой машине.",
+  },
+
+  note: {
+    journalTitle: "Журнал шишек",
+    needTitle: (cmd) => `Нужен заголовок: ${cmd}`,
+    noJournal: (url) => `Клон журнала не найден.\nСделай один раз:\n  git clone ${url}.git ~/projects/aqk\nили укажи путь: export AQK_HOME=/путь/к/aqk`,
+    journalMissing: (path) => `Журнал не найден: ${path}`,
+    emptyBody: `Тело записи пустое. Передай его на стандартный ввод, например:\n\n  aqk note "заголовок" <<'EOF'\n  **Что случилось.** ...\n  **Чем это стоило.** ...\n  **Вывод.** 🔧 ...\n  EOF`,
+    noOutcome:
+      "В записи нет отметки решения. Урок без вывода — это история, а не урок.\n" +
+      "Припиши одну из трёх:\n" +
+      "  ✅ **Стало гейтом:** <имя записи каталога>\n" +
+      "  🔧 **Стало правкой оснастки:** <что именно изменено>\n" +
+      "  👤 **Гейтом не станет:** <почему>",
+    unknownProject: "неизвестно",
+    projectField: "Проект",
+    pushed: (title) => `Записано и отправлено: ${title}`,
+    localOnly: (cmd) => `Записано локально, push не прошёл. Отправить: ${cmd}`,
+  },
+
+  blob: {
+    noDocs: (dir) => `Не найдены методички: ${dir}`,
+    header: (stamp) =>
+      `<!-- СОБРАНО КОМАНДОЙ aqk blob ${stamp} из kit/docs. Не править руками:\n` +
+      `     правки затрёт следующая сборка. Источник — отдельные файлы. -->\n\n` +
+      `# AQK — методички одним файлом\n`,
+    source: (path) => `источник: ${path}`,
+    done: (n, kb) => `GOD_AI.md — ${n} файлов, ${kb} КБ`,
+    rebuilt: "Собирается заново каждой командой. Править надо оригиналы в kit/docs.",
+  },
+
+  start: {
+    initFailed: (cmd) => `Не получилось разложить комплект. Начни с ${cmd}`,
+    tooManyFiles: (n) => `В репозитории уже ${n} файлов кода — это другой сценарий.`,
+    useDoctor: (cmd) => `${cmd} осмотрит, что есть, и разделит записи на три списка:`,
+    threeLists: "держит машина · применимо и не поставлено · не применимо и почему.",
+    anyway: (cmd) => `Всё равно поставить сторожей дня 0: ${cmd}`,
+    expectRed: "Готовься к красному: сторож, поставленный на живой код, краснеет на нём весь.",
+    expectRedFix: (cmd) => `Это лечится храповиком — ${cmd}, — а не отключением.`,
+    installed: (n) => `Поставлено сторожей дня 0: ${n}`,
+    noDebt1: "Долга нет: на пустом проекте им нечего пропускать. Тот же сторож, поставленный",
+    noDebt2: "через полгода, покраснел бы на всём старом коде — и его бы выключили.",
+    allDeclared: "Все применимые записи уже объявлены.",
+    notYet: "Не применимо пока:",
+    notYetWhy: "Появится признак — запись покажется сама.",
+    orderTitle: "Порядок, в котором это делают:",
+    o1: "Задача словами.",
+    o1What: "Что и кому, без единого технического слова.",
+    o1Why: "Пока задача не описана словами, любая архитектура защищает неизвестно что.",
+    o2: "Ограничения.",
+    o2What: "Сроки, деньги, нагрузка, чем нельзя пользоваться.",
+    o2Why: "Ограничения выбирают решение куда чаще, чем вкус: без них выбирают вкусом.",
+    o3: "Сайзинг.",
+    o3What: "Сколько данных, запросов, людей — числами, хотя бы порядком.",
+    o3Why: "Число отделяет «нужна очередь» от «хватит таблицы». Без него спорят словами.",
+    o4: "Архитектура.",
+    o4What: "И только теперь — из первых трёх, а не до них.",
+    softNote1: "Этот порядок программа не проверяет: он в .aqk/docs/, и агент может его",
+    softNote2: "проигнорировать. Машина держит другое — сторожей выше. Разница между",
+    softNote3: "мягким и жёстким тут ровно такая: текст просят, команду выполняют.",
+    next: "Дальше:",
+    nextWhy: "— прогнать всё, что объявлено",
+  },
+
+  manifestDoc: {
+    head: [
+      "# .aqk.yml — манифест Agent Quality Kit",
+      "# Что это: машиночитаемое описание того, как в этом репозитории живут агенты.",
+      "# Уровень соответствия считает `aqk doctor`. Пустое поле = ступень не пройдена,",
+      "# и это честно: заполнять заглушками бессмысленно, проверяются файлы, а не слова.",
+    ],
+    entry: "# AQK-0 — что агент читает первым.",
+    rules: "# AQK-1 — где стандарты и какие проверки обязательны.",
+    gates: [
+      "  # Имя: команда, возвращающая 0 или не 0. Пустое объявление защиты не даёт и бракуется",
+      "  # проверкой «объявленный гейт запускается» — поэтому здесь примеры, а не заготовки.",
+      '  #   lint: "ruff check ."',
+      '  #   test: "pytest -q"',
+      "  # Поставить готовую запись из каталога вместе с образцами: aqk add <имя>",
+    ],
+    samples: [
+      "# AQK-2 — чем доказано, что гейты работают, и где реестры долга.",
+      "# samples: каталог с красными и зелёными образцами (гейт обязан краснеть на первом",
+      "# и молчать на втором). ratchets: списки известных нарушений, которые могут только",
+      "# укорачиваться.",
+    ],
+    lessons: "# AQK-3 — где копятся уроки. Путь или адрес.",
+  },
+
+  report2: {
+    title: "Отчёт AQK",
+    noManifest: (cmd) => `Нет .aqk.yml — отчитываться не о чем. Начни с ${cmd}`,
+    level: "Уровень",
+    holdsTitle: "Что держит машина (прогон, а не манифест)",
+    nothingRuns: "⬜ ни один гейт не объявлен",
+    native: (prog) => `родной рецепт: ${prog}`,
+    portable: "переносимая проверка",
+    weakerTitle: "Стоит слабее возможного",
+    weaker: (progs) => `в системе есть ${progs}, но гейт стоит на переносимой проверке — она ловит меньше`,
+    missingTitle: "Чего нет",
+    nothingMissing: "✅ все применимые записи поставлены",
+    needsTool: (prog) => `нужен ${prog} — его нет в системе`,
+    notInstalled: "применимо, но не поставлено",
+    hiddenTitle: "Не применимо к этому репозиторию",
+    readTitle: "Что комплект велел прочитать",
+    readWarn:
+      "Значок означает только наличие файла на диске. Прочитан он или нет, машина не знает и " +
+      "не притворяется, что знает: это отвечает тот, кто отчитывается.",
+    ignoreTitle: "Что спрятано .aqkignore",
+    ignoreNone: "файла .aqkignore нет — ничего не спрятано",
+    ignoreWarn:
+      "Скрытое молча — тот же класс, что молчащий гейт: гейты по этим путям не смотрят вовсе. " +
+      "Строка здесь означает, что защиты там нет и не будет.",
+    whyTitle: "Зачем это нужно — коротко",
+    whyNothing: "нечего добавлять: применимое уже стоит",
+    saved: (path) => `Сохранено: ${path}`,
+    docs: {
+      baseline: "обязательный минимум проекта, без привязки к языку",
+      readyMade: "карта готовых правил: сперва ищи готовое, потом пиши своё",
+      rulesGeneral: "общие правила работы",
+      rulesTesting: "правила про тесты",
+      rulesSecurity: "правила про безопасность",
+    },
+  },
+
+  levels: [
+    {
+      title: "манифест и точка входа",
+      need: "создай .aqk.yml и укажи в entry файл, который агент читает первым (AGENTS.md)",
+      gives: "любой инструмент понимает, что читать в этом репозитории",
+    },
+    {
+      title: "правила и работающие гейты",
+      need: "укажи rules (каталог стандартов) и заполни хотя бы один гейт в gates реальной командой",
+      gives: "проверки объявлены командами, а не описаны словами",
+    },
+    {
+      title: "гейты доказаны, долг под храповиком",
+      need: "заведи samples (красные и зелёные образцы гейтов) и ratchets (реестры долга)",
+      gives: "гейт доказал, что ловит брак и молчит на исправном коде",
+    },
+    {
+      title: "уроки возвращаются в работу",
+      need: "укажи lessons — путь или адрес журнала, где каждый инцидент даёт вывод",
+      gives: "проект учится: одна и та же шишка не набивается дважды",
+    },
+  ],
+
+  report: {
+    title: "aqk doctor --run",
+    version: "версия",
+    level: "уровень",
+    summary: (ok, all) => `итого: ${ok} из ${all} зелёных`,
+  },
+};

package/tool/i18n/templates-en.mjs

@@ -0,0 +1,164 @@
+// tool/i18n/templates-en.mjs — английские тексты, которые программа кладёт в чужой проект.
+//
+// Ключи обязаны совпадать с templates-ru.mjs: каталоги подмешивают их полем templates, и
+// модульная проверка «одни и те же ключи» заходит внутрь.
+
+const AGENTS_MD = `# AGENTS.md
+
+> The entry point for an agent. Keep this file short: a bloated rulebook pushes the actual task
+> out of the context window, and then every rule gets ignored at once. Anything long goes behind
+> the links below.
+
+## Hard rules
+
+- **A plan before code.** A non-trivial task starts with a plan a human approved in words.
+- **A red test before code.** First a check that fails, then the implementation.
+- **Three attempts maximum.** Not solved in three — stop and ask a human, not a fourth try.
+- **Secrets only in the environment.** Never in code, logs or commits.
+- **Only the files the task is about.** No fixing things "while we are here".
+- **Done = proven.** Name the arbiter: a test, a live run, a check against the source.
+  "Looks like it works" is not done.
+- **Never swallow an error.** Either handled and logged, or re-raised.
+- **A fork in the road is a question for a human.** Departing from an agreed decision is not
+  documented with a code comment.
+- **Report on your work with the kit with a command, not with words.** When you are done, run
+  \`aqk report\`. It is assembled from an actual run: a summary from memory always picks the
+  convenient parts and stays quiet about a gate standing on the weakest recipe.
+
+## The AQK tooling is your commands, not the human's
+
+This repository has the AQK kit installed. Its point: **a promise the project makes turns into a
+command with an exit code**, and from then on a machine holds it, not somebody's attention.
+"We do not leave debug printing" is text you can ignore; a command returning non-zero is not.
+
+Running them is your job. The human looks at the list of holes and decides which to close.
+
+| Command | What it does | When to reach for it |
+|---|---|---|
+| \`aqk doctor\` | inspects the repository and prints three lists: what a machine already holds, what is missing, and what this project does not need and why | starting work on quality; "what is even here" |
+| \`aqk doctor --run\` | **runs** the declared checks and shows which one found a defect | before handing work over; after changes; whenever you need a fact rather than a promise |
+| \`aqk add <name>\` | installs a check from the catalogue: copies it and its samples into the project, declares it in the manifest | the human agreed to close a hole from the \`doctor\` list |
+| \`aqk ratchet <name>\` | records existing violations as debt and stops letting new ones through | the check goes red on old code nobody is going to fix right now |
+| \`aqk find "…"\` | searches by meaning for an existing check | before inventing your own |
+| \`aqk note "…"\` | writes a lesson into the shared journal | the process or an instrument let you down: a check lied, a rule was bypassed |
+| \`aqk report\` | assembles a report from an actual run: what is in place and with which recipe, what is missing, what the kit told you to read | **mandatory** at the end of working with the kit — instead of a summary from memory |
+
+If there is no \`aqk\` command on the system, the kit was used without installing. Then write
+\`npx agent-quality-kit\` instead of \`aqk\`. Every command prints the invocation that will
+actually work for you.
+
+**Three things to understand rather than memorise:**
+
+1. **"Declared" and "works" are different claims.** \`doctor\` without \`--run\` honestly says it
+   ran nothing. Do not present the declared as the working.
+2. **A check without two samples proves nothing.** The red one is code it must fire on; the green
+   one is correct code it must stay quiet on. The green one matters more: without it, one day the
+   check goes red on correct code and gets switched off along with all the others.
+3. **A rule is introduced with a ratchet, not with a big cleanup.** The cleanup is postponed
+   forever, because it is big. The ratchet gives you a rule in force from the day it lands.
+
+**A defect of the same class repeating is not a reason to be more careful — it is a reason to add
+a check.** Discipline does not scale; mechanics do.
+
+## Third-party code inside the repository
+
+Code that lives here but was not written here (a reference copy, vendored code, generated
+clients) is excluded with \`.aqkignore\` in the root — one pattern per line. Editing the copy of
+\`_skip.sh\` is not configuration: the next \`aqk add\` overwrites it.
+
+## Where things live
+
+- \`.aqk/rules/\` — standards: general, tests, security
+- \`.aqk/docs/\` — guides: the project minimum, the harness, process, research
+- \`.aqk/docs/project-baseline.md\` — **start here** if the project is new
+
+## Commands
+
+<!-- Fill this in for your project. A command you cannot copy and run is not a command. -->
+
+- build: \`\`
+- tests: \`\`
+- linter: \`\`
+- everything at once before pushing: \`\`
+
+## What this project does not have
+
+<!-- Be honest here. An unwritten "no" is something the agent will assume is a "yes". -->
+`;
+
+const CLAUDE_MD = `# CLAUDE.md
+
+The rules for this project live in \`AGENTS.md\` — read that.
+
+One rulebook, several entry points: \`AGENTS.md\` for agents that understand it, \`CLAUDE.md\`
+for Claude Code. Keeping two diverging rulebooks is not an option: within a month they lie in
+different ways, and nobody knows which one is real.
+
+@AGENTS.md
+`;
+
+
+const GATE_YML_TEMPLATE = (slug) => `# An AQK catalogue entry. The format and every field — kit/gates/README.md
+# Until the lines below are filled in, the check will reject this entry — by design.
+
+# In one phrase: which class of defect it catches. Deduplication runs on this field.
+intent: FILL IN — which class of defect it catches
+intent_en: FILL IN — which class of defect it catches
+
+# When the entry is shown to a human. The condition must be a query about the repository
+# that the program can evaluate: always | langs: python, go | has_gates: true
+trigger:
+  always: true
+
+# The arbiter command per stack. {gate} is the entry folder, {dir} is what we check.
+# any — a portable command that needs no third-party programs.
+recipes:
+  any: bash {gate}/check.sh {dir}
+
+# A real failure this check caught. "A good practice" is not accepted:
+# point at a journal entry — incidents/README.md
+proof: FILL IN — which failure it caught and what that cost
+`;
+
+const CHECK_SH_TEMPLATE = `#!/usr/bin/env sh
+# A check. Returns 0 — clean, non-zero — defect. The failure text must SAY what to do:
+# it lands straight in the agent's context, and with an instruction the agent fixes it itself.
+DIR="\${1:-.}"
+. "$(dirname "$0")/../_skip.sh" 2>/dev/null || SKIP_NAMES=".git .aqk node_modules .venv"
+
+# own_samples_filter hides ONLY gates/<name>/red|green/ — not every folder with that name in
+# the project. --exclude-dir=red by bare name would one day hide a real user folder called
+# red/ (found on secrets-not-in-code — see the journal, 2026-09-04).
+HITS=$(grep -rnE $(skip_grep "$DIR") 'FILL_IN_SEARCH_PATTERN' "$DIR" 2>/dev/null | own_samples_filter "$DIR")
+if [ -n "$HITS" ]; then
+  echo "$HITS"
+  echo "  fix: FILL IN — what exactly to do"
+  exit 1
+fi
+exit 0
+`;
+
+const README_TEMPLATE = (slug) => `# FILL IN — a one-line title
+
+**Intent.** What must not reach the code, and why.
+
+**Which failure this caught.** What broke, in which project, and what it cost. Without this the
+entry is not accepted: "it is a good practice" collects hundreds of entries you cannot choose
+between.
+
+**Why a machine and not attention.** The moment at which a human misses this.
+
+**An off-the-shelf equivalent.** Does ruff, eslint or semgrep already have this check? If it
+does, the recipe for that language must use it, and your own check stays the fallback. If it does
+not, write down what exactly you checked: "did not look" and "there is none" are different claims.
+
+**What it does NOT catch.** Name the boundary honestly. A gate whose limits go unmentioned is
+more dangerous than a missing one: people will rely on it.
+
+**Samples.** \`red/\` — what is violated here. \`green/\` — the same thing, done right.
+`;
+
+export const templates = {
+  AGENTS_MD, CLAUDE_MD,
+  GATE_YML_TEMPLATE, CHECK_SH_TEMPLATE, README_TEMPLATE,
+};