{"slug":"quality-gate","title":"quality-gate","summary":"Оркестратор контроля качества 1С-разработки. Определяет профиль изменения по трём осям (объём правки, архетипы кода, сложность), выбирает глубину каждого контура, запускает проверки, формирует отчёт с машиночитаемым следом и снимает блокирующий гейт. Вызывать после правок BSL или","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-09-14T21:09:27.214881Z","repo":{"url":"https://github.com/Romandredan/1c-quality-gate","stars":28,"forks":6,"license":null,"updatedAt":"2026-09-25T07:40:14Z"},"bodyHtml":"
\n

name: quality-gate\ndescription: >-\nОркестратор контроля качества 1С-разработки. Определяет профиль изменения по трём осям\n(объём правки, архетипы кода, сложность), выбирает глубину каждого контура, запускает\nпроверки, формирует отчёт с машиночитаемым следом и снимает блокирующий гейт.\nВызывать после правок BSL или XML метаданных 1С, перед завершением работы и коммитом.\nТриггеры: «прогони гейт качества», «проверь код перед коммитом», «сними гейт»,\n«отревьюй что я написал», «проверь по стандартам», «готов ли код к коммиту».\nlicense: MIT

\n

quality-gate — оркестратор контроля качества 1С

\n

Единственная точка входа плагина. Контуры (code, arch, xml, hygiene) не вызываются\nнапрямую: сначала считается профиль изменения, он решает глубину.

\n
\n

Главное правило. Полный прогон на правке комментария — налог, из-за которого гейт\nначинают обходить; пропуск без следа — ложная зелень. Глубина адаптивная, но любой\nпропуск фиксируется явной записью с причиной.

\n
\n

<ЖЁСТКИЙ-ШЛЮЗ>\nПо умолчанию — только проверка и отчёт. НЕ переписывай бизнес-логику и НЕ меняй метаданные по\nсвоей инициативе. Правки — только в режиме --fix, из безопасных категорий. Critical и любые\nизменения логики, проведения, запросов, прав — никогда без явного подтверждения пользователя.\n</ЖЁСТКИЙ-ШЛЮЗ>

\n
\n

Инварианты прогона

\n

Девять утверждений: усвоен только этот блок — прогон ещё имеет смысл; нарушено любое —\nуже нет.

\n
    \n
  1. Профиль считается один раз, до контуров; контуры его не пересчитывают.
    2. \n
  2. Глубина — по профилю, не по привычке: не гонять архитектуру на опечатке, не\nограничиваться гигиеной на новом модуле проведения.
    3. \n
  3. Контур исполняется вызовом навыка, а не по памяти.
    4. \n
  4. Строку следа печатает инструмент, где он есть — не модель по смыслу.
    5. \n
  5. Любой пропуск — запись skipped с причиной. Молчание неотличимо от выполнения.
    6. \n
  6. Вердикт «чисто» признаёт непроверяемое — записью not_verified.
    7. \n
  7. Находка — с номером стандарта, кодом диагностики или эвристикой и значением против\nпорога; \uD83D\uDD34/\uD83D\uDFE0 блокируют «Чисто», вне --fix — только отчёт.
    8. \n
  8. Гейт снимается утилитой gate.mjs release, а не удалением файла состояния.
    9. \n
  9. План печатает gate.mjs plan; модель вправе поднять глубину с причиной, понизить —\nнет.
    10. \n
\n
\n

Шаг 1. План

\n

Путь к инструментам плагина ($QG)

\n

Все команды ниже используют $QG — каталог плагина. Под OpenCode он готов в QG_ROOT; в\nClaude Code CLAUDE_PLUGIN_ROOT доступна хукам, но не оболочке — путь через неё схлопнулся\nбы в /tools/....

\n

Разреши путь первой командой прогона, дальше подставляй значение буквально. Кандидат —\nтолько после test -d \"$QG/tools\": переменная сама по себе не гарантирует актуальный плагин.

\n
QG=\"${QG_ROOT:-}\"\n[ ! -d \"$QG/tools\" ] && QG=\"${CLAUDE_PLUGIN_ROOT:-}\"\n[ ! -d \"$QG/tools\" ] && QG=\"$(node -e \"const p=require(require('node:os').homedir()+'/.claude/plugins/installed_plugins.json').plugins;const k=Object.keys(p).find(n=>n.startsWith('1c-quality-gate@'));if(k&&p[k][0])process.stdout.write(p[k][0].installPath)\" 2>/dev/null)\"\n[ ! -d \"$QG/tools\" ] && QG=\"$(ls -d ~/.claude/plugins/cache/*/1c-quality-gate/*/ 2>/dev/null | sort -V | tail -1)\" && QG=\"${QG%/}\"\ntest -d \"$QG/tools\" && echo \"$QG\" || { echo \"Плагин не найден ни в одном харнессе\" >&2; exit 1; }\n
\n

sort -V не декоративен: без него сессия честно отчитывается, что проверок «не существует»,\nработая инструментами устаревшей версии. Разбор — references/run-environment.md.

\n

Профиль и план прогона

\n
node \"$QG/tools/gate.mjs\" plan --files <f> [<f> ...] [--no-analyzer]\n
\n

Без --files — состав из взведённой сессии (gate.mjs status). Печатает профиль по трём\nосям, строку scope (с config=...), инструменты по порядку, что закрыть в следе.\n--no-analyzer — когда анализатор недоступен или падает; ось сложности тогда not_computed,\ndriver не бывает complexity:*.

\n

Строку [qg scope: ...] перенеси в отчёт дословно — валидатор пересчитывает профиль сам.\nРасхождение — сверь порог: node \"$QG/tools/config.mjs\" show. Профиль можно поднять,\nнельзя понизить: увидел то, чего план не видит (правка тише архетипа, но трогает деньги) —\nподними, добавь «глубина поднята: <причина>»; обратное валидатор не пропустит.

\n

Почему оси устроены так — references/profile-axes.md; данные — tools/profile.mjs,\ntools/gate.mjs.

\n
\n

Шаг 2. Инструменты

\n

Выполни команды раздела «## Инструменты» плана по порядку — файлы уже подставлены. У части\nесть исполняемый инструмент: он печатает строку следа ([qg applied: ...] / [qg skipped: ...]) сам — переноси дословно, не сочиняй.

\n

Прогон отмечается в журнале qg-runs.jsonl: валидатор сверяет по нему каждую запись\napplied — инструмент видел весь состав правки, а не файл из десяти; skipped ... reason=not_applicable — тоже утверждение о работе. Прогоны по частям складываются.\nplatform-context-run.mjs, когда включён планом, обязателен: анализатор знает имена\nконфигурации, но не платформы. query-lint берёт и изменённые XML, не только .bsl.

\n

Перед повторным прогоном слоя проверь gate.mjs status: отработавший по этому\nсодержимому слой пропускается с причиной verified_earlier (references/evidence-format.md).

\n
\n

Шаг 3. Контуры

\n

Запускай контуры и глубины из resolved: code=... arch=... xml=... hygiene=... плана.\nКаждый контур обязан вернуть applied либо skipped — молчание не допускается.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
КонтурНавык
codebsl-code-review
archbsl-architecture-review
xmlxml-structure-review
hygienefile-hygiene
\n

Передавай контуру профиль целиком: класс, архетипы, файлы.

\n

Контур исполняется вызовом навыка, а не по памяти

\n

Таблица называет навыки, а не проверки: чем проверяется признак — в SKILL.md контура. Прогон\nбез открытия навыка — чеклист для чтения глазами, не проверка\n(references/run-environment.md).

\n

Субагенты в составе прогона

\n

Четыре штатных, только читающие: возвращают факты, запись формирует контур. Три дешёвые;\nantipattern-reader — на модели уровня контура: семантика LLM-антипаттернов не\nмеханизируется до haiku.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
СубагентВызываетФактыСпавнов
bsl-verifiercodeсигнатуры платформы, экспортность модулей, метаданныена список файлов
antipattern-readercodeкандидаты с цитатами; аттестует tools/catalog.mjsна контур
bsl-scoutarchвызывающие, экспорты, триггеры XMLпо вопросу
xml-runnerxml«диск ↔ состав», валидаторы структурына контур
\n

Недоступность субагента, контура или инструмента проверку не отменяет — она проходит сама\nлибо получает skipped с причиной (references/run-environment.md).

\n
\n

Слой 3: состязательный аудит

\n

Самая дорогая проверка, никогда не запускается сама: контуры предлагают её при классе C3 с\nнаходками \uD83D\uDD34/\uD83D\uDFE0, запуск — только по явному согласию пользователя\n(references/adversarial-audit.md).

\n
\n

Шаг 4. Sentinel — проверка живости источника стандартов

\n

Один раз за прогон запроси через MCP v8std стандарт, чей номер — sentinel.id настройки\n(умолчание std454): v8std_get_page(\"<id>\"), ожидание — страница найдена.

\n

Без неё «нарушений не найдено» неотличимо от «сервис недоступен»: неподтверждённый часовой\nделает прогон недостоверным (references/run-environment.md).

\n
\n

Шаг 5. Отчёт и след

\n

Отчёт для человека — находки по важности (\uD83D\uDD34 Critical / \uD83D\uDFE0 Major / \uD83D\uDFE1 Minor). Ниже, в\n## quality evidence, — машиночитаемый след: строка на проверку\n(references/evidence-format.md).

\n

Каждая запись not_verified повторяется в человекочитаемой части фразой: «Ошибок: 0»\nрядом с невидимым not_verified читается как «проверено».

\n

Минимум следа: scope (Шаг 1), sentinel (Шаг 4), запись от каждого контура и всё из плана\n«Закрыть в следе» — включая not_verified: dimension=compilation, если платформа не\nзапускалась (её не проверяет ничто другое).

\n

Сработал архетип «Запрос» — выполни запрос до вердикта (консоль запросов, тестовые\nпараметры): текст остаётся строковым литералом, «Неоднозначное поле» доживает до продуктива.\nВыполнить негде — законный исход, но записанный:

\n
[qg applied: layer=code, scope=query-execution, ids=[qg:QRY-EXECUTED], verdict=clean]\n[qg not_verified: dimension=query-execution, reason=no_platform]\n
\n

Файл, до которого не добрался анализатор, не проверен — analyzer-run.mjs печатает\nзапись сам, переноси дословно.

\n
node \"$QG/tools/evidence-validator.mjs\" <файл отчёта> --gate\n
\n
\n

Шаг 6. Снятие гейта

\n

Гейт снимается только утилитой, не удалением файла состояния:

\n
node \"$QG/tools/gate.mjs\" release --evidence <файл отчёта>        # по результатам прогона\nnode \"$QG/tools/gate.mjs\" release --class C0 --reason \"<почему>\"  # C0/C1 без прогона\n
\n

НЕ снимай гейт, если прогон прерван на полпути и отчёт не сформирован: он должен остаться\nдля повторной проверки.

\n

Чужие сессии не трогай. Гейт разделён по сессиям: несколько в gate.mjs status —\nverify/release без --session <id> отказывают, «самая свежая» может быть чужой.\nИдентификатор — в подсказке при взводе и в сообщении о блокировке\n(references/run-environment.md).

\n","files":[{"path":"references/adversarial-audit.md","sizeBytes":9708,"isText":true},{"path":"references/evidence-format.md","sizeBytes":44040,"isText":true},{"path":"references/glossary.md","sizeBytes":6782,"isText":true},{"path":"references/profile-axes.md","sizeBytes":20659,"isText":true},{"path":"references/run-environment.md","sizeBytes":12519,"isText":true},{"path":"SKILL.md","sizeBytes":14829,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-09-27T19:48:11.719468Z","sha256":"AADE13753785C5FDB277B5FA6341B3DD3B32F8EAEA1BF7E21113225C4F7DF923","sizeBytes":37514},"review":null,"source":{"repositoryUrl":"https://github.com/Romandredan/1c-quality-gate","path":"skills/quality-gate","license":null,"commit":"d27fc8f7f27bb109c5d8977a7452184e7c3da851","subtreeSha":"382A29D0B50B1881BC0147DE0ACAE3895282418EBD27D99D416ABFF00C5DEB54","lastSyncedAt":"2026-09-27T19:47:56.426024Z"},"reviewedAt":"2026-09-27T19:48:21.147578Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/Romandredan/1c-quality-gate/tree/main/skills/quality-gate"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install romandredan-1c-quality-gate@llmmart"},{"target":"git","command":"git clone https://github.com/Romandredan/1c-quality-gate.git"}]}