| name | pre-delivery-gate |
| description | Автоматичний гейт перевірок ПЕРЕД наданням користувачу будь-чого готового (скіл, оновлення, аплікація, артефакт, файл). Оркеструє validation-mesh + safety-compliance-gate + прогін evals + guard + перевірку повноти доставки + анти-втрату стану. ALWAYS use ПЕРЕД тим, як віддати користувачу готовий скіл/оновлення/застосунок/файл — автоматично, без нагадування. Also: pre-delivery checks, release gate, перед видачею, прогони всі тести перед доставкою, delivery checklist, перед оновленням скіла, фінальна перевірка. Запобігає помилкам: втрата пам'яті/контексту, втрата напрацювань, неповна доставка, дрейф схеми evals, забуті перевірки, дублі версій. DO NOT use як заміну окремим гейтам — він їх ВИКЛИКАЄ, не дублює; не для пошуку втраченого (gsre-recovery); не для періодичної ревізії всієї екосистеми (skill-ecosystem-auditor) — тут гейт ОДНОГО артефакту перед видачею. |
| license | Apache-2.0 — повні умови в LICENSE.txt кореня екосистеми |
| metadata | {"version":"1.3.0","author":"Melania (Master Administrator)","category":"governance-safety","created":"2026-06-26T00:00:00.000Z","last_updated":"2026-07-26T00:00:00.000Z"} |
Pre-Delivery Gate — v1.3.0 — автоматична перевірка перед видачею
Пояснення — українською за замовчуванням (українською-перша); назви інструментів та ідентифікатори лишаються англійською.
🛡️ Протокол Збереження Перед Оновленням
Перед БУДЬ-ЯКОЮ зміною цього скіла — канон у melania (секції «Протокол Збереження» + «Update Workflow» + Core Rule 10).
Critical Facts
- [C] «Автоматично» в чаті — дисципліна, не код. У чаті Claude не може технічно заблокувати сам себе; гейт тримається на правилі + governance. Реальне блокування кодом можливе лише там, де налаштовані hooks.
- [E] В ai-lab механічну частину чек-листа виконує
maintain.py verify — цілісність MANIFEST, guard, safety-скан і доказовість тверджень; тест на підключення гейта є в наборі. (melania-skills-ecosystem/scripts/maintain.py, tests/run-tests.sh, 2026-07-26)
- [C] Пакувальник скіл-стору вирізає
evals/ з .skill. Тому source-теку з тестами треба віддавати ОКРЕМО — інакше при install тести губляться, а скіл лишається «з evals» лише на словах.
- [C] Гейт нічого не валідує сам. Він оркеструє інші скіли; дублювати їхні правила тут — шлях до розходження версій правди.
Що це і коли спрацьовує
Гейт запускається АВТОМАТИЧНО перед КОЖНОЮ видачею готового артефакту (скіл / оновлення / застосунок / файл / результат).
Чесно про «автоматично»:
- У ЧАТІ (тут): це жорстке ПРАВИЛО, якого Claude дотримується щоразу перед видачею (підкріплене governance
melania + user-preferences). Це не код-хук — виконання через дисципліну Claude. Я НЕ можу технічно «заблокувати» сам себе кодом у чаті; я зобов'язуюсь пройти чек-лист.
- У CLAUDE CODE: жорстко через
skill_guard hooks — код реально блокує доставку, доки перевірки не пройдено.
✅ Чек-лист гейту (УСЕ має пройти ПЕРЕД видачею)
- Валідація —
validation-mesh → вердикт VALID (не INVALID/UNKNOWN). Інакше — спершу полагодити.
- Безпека / IP —
safety-compliance-gate (особливо публікація / іменування за чужим брендом / untrusted вхід / монетизація).
- Тести —
evals присутні у канон-схемі (name+assertions+version) і концептуально проходять. Якщо evals нема — створити або явно зафіксувати причину.
- Guard —
--snapshot/--validate для скілів (структура не зламана, без усадки).
- Гігієна changelog — версію піднято (bump) + запис у CHANGELOG; без непояснених дублів номерів версій.
- Доказовість тверджень (Core Rule 14) — жодного фактичного твердження без тега [E]/[C]/[S]; жодного
[E] без вказівника, і вказівник мусить існувати (формат ≠ доказ: саме так колись пройшли «claimed-but-missing» evals). Механіка — maintain.py verify, методика — validation-mesh (Claim-Evidence Layer). Нема доказу → звузити формулювання.
- ПОВНОТА доставки (маніфест) — перелічити ВСІ змінені артефакти й переконатися, що віддано КОЖЕН, а не вибірку. (Запобігає «віддав 4 з 19».)
- АНТИ-ВТРАТА стану —
continuation-memory snapshot + оновлення довготривалої пам'яті ключовими фактами/рішеннями. (Запобігає втраті при стисненні контексту / перериванні сесії.)
- Source + evals окремо — для скілів: віддати source-теку з
evals/ ОКРЕМО (бо пакувальник виключає evals/ з .skill → інакше тести губляться при install).
Лише коли ВСЕ пройдено → віддати користувачу. Якщо щось не пройшло — спершу виправити, потім видавати. Гейт не «косметичний»: він реально не пускає неготове.
🛑 Помилки, які гейт ЗАПОБІГАЄ (зібрано з реального досвіду)
| Помилка (що сталося) | Механізм запобігання |
|---|
| Втрата пам'яті/контексту при стисненні + перериванні | П.8: обов'язковий continuation-memory snapshot + довготривала пам'ять на кожному рубежі |
| Втрата напрацювань (evals «claimed-but-missing») | П.3+П.6+П.9: заявлений артефакт мусить існувати (гейт доказовості це перевіряє машинно); віддавати source+evals окремо |
| Неповна доставка (показано частину файлів) | П.7: маніфест-перевірка — усі змінені артефакти віддано |
| Дрейф схеми evals (не той формат) | П.3: валідація канон-схеми name+assertions+version |
| Забуті перевірки (доки не нагадали) | Сам гейт — автоматичний runner усіх перевірок |
| Дублі версій у changelog накопичуються | П.5: гігієна changelog (bump + без непояснених дублів) |
Область
Працює для скілів, оновлень І аплікацій/артефактів. Для майбутніх аплікацій можна спеціалізувати окремий профіль перевірок (напр. app-delivery-gate), що успадковує цей чек-лист.
Координація (викликає, НЕ дублює)
ВИКЛИКАЄ: validation-mesh, safety-compliance-gate, continuation-memory. Для скілів — melania Pre-save gate + guard. Для пошуку втраченого перед видачею — gsre-recovery. Намір-роутинг — semantic-router.
Зміни
- v1.3.0 (2026-07-26) — Секція Critical Facts: фактичні твердження скіла винесено окремо й протеговано за Core Rule 14. Пункт 6 чек-листа посилено: вказівник
[E] мусить існувати — формат вказівника не є доказом (саме так колись пройшли «claimed-but-missing» evals). Виправлено перехресні посилання в таблиці запобігання: після вставки нового пункту 6 нумерація П.6/П.7/П.8 з'їхала на один. Лише додавання й корекція.
- v1.2.0 (2026-07-26) — У чек-лист гейту додано доказовість тверджень (Core Rule 14): артефакт не віддається, якщо містить фактичні твердження без тегів [E]/[C]/[S] або [E] без вказівника на перевірку. Механіка —
maintain.py verify, методика — validation-mesh; гейт викликає, не дублює. Лише додавання.
- v1.1.0 (2026-07-19) — Self-Dev Wave 2 (аудит 2026-07-18): DO NOT-межа з
skill-ecosystem-auditor (гейт одного артефакту ≠ ревізія екосистеми) [#20]; роль щодо validation-mesh зафіксовано в парі з mesh v1.6.0 — PDG вхідна точка видачі, mesh виконавець [#17]; ліцензійний покажчик на корінь екосистеми (локального LICENSE.txt не існувало) [#25/#44]; H1 з версією. Лише опис/метадані.
- v1.0.0 (2026-06-26) — Первинний скіл: автоматичний гейт перед видачею (8-пунктовий чек-лист), що оркеструє наявні гейти й додає повноту-доставки + анти-втрату стану. Вшито таблицю запобігання 6 реальним помилкам сесії. Чесно розмежовано «автоматично» в чаті (правило-дисципліна) vs Claude Code (hook-блокування).
