agentleFS
Valeriy1980Valeriy1980/claude-skills/skills/reality-check/SKILL.md

reality-check

Skill0 starsChanged 3 months agoMITView on GitHub

5-хвилинна звірка твердження з живим джерелом ПЕРЕД тим, як витрачати години на реакцію. Бери ЩОРАЗУ, коли документ, аудит, CLAUDE.md, MEMORY, стара сесія, лист або чиясь фраза стверджує факт про стан коду/інфри/задачі — «це поле мертве», «задача критична/відкрита», «у нас N вразливостей», «ми на базі/хостингу X», «це вже зламано». Активуйся до того, як почати чинити або панікувати. Закриває повторюваний біль користувача: документи застарівають, а він гає години на тривоги, яких у реальності вже немає. Не плутати з /verify (той — «чи фіча працює») і /pre-deploy (той — момент релізу).

14 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

/reality-check — звір із реальністю, перш ніж діяти

Головна ідея: документ — це фото минулого. Код та інфра — це «зараз». Перш ніж витратити годину на те, що каже документ/аудит/лист — витрать 5 хвилин, щоб перевірити, чи це ще правда.

Твоя ціна питання (з реальних випадків): 3 «критичні тривоги» виявились давно закритими → 1.5 год марно. «Ми на Neon» → насправді Railway → 2 год інфра-аудиту не туди. Цей скіл ловить саме такі.


Крок 1 — стоп, не починай діяти

Почув/прочитав твердження про стан («X зламано», «Y мертве», «задача критична», «N багів», «ми юзаємо Z») — НЕ кидайся чинити чи панікувати. Спершу постав одне питання:

Звідки це твердження і коли воно писалось?

Джерела за спаданням довіри: живий код/інфра (істина) → свіжий лог/тест (майже істина) → PR/git (недавнє) → CLAUDE.md/MEMORY/аудит/лист (могло застаріти) → чиясь памʼять (найризикованіше).

Крок 2 — знайди ЖИВЕ джерело для цього типу твердження

Не вір документу — піди до першоджерела, що показує стан ЗАРАЗ:

Твердження каже…Жива перевірка (істина зараз)
«символ/поле/функція мертві, не використовуються»grep по всьому коду — і по рядкових ключах теж (може викликатись через await import, рядок конфіга, шаблон)
«задача критична / досі відкрита / не зроблена»Сам код + git log/PR по темі — а не статус у документі чи листі
«ми на базі/хостингу/сервісі X»Панель провайдера + env/конфіг у репо — не опис у README/CLAUDE.md
«у нас N вразливостей / застарілих пакетів»Перезапусти аудит ЗАРАЗ (npm audit тощо) — стара цифра майже завжди інша
«це вже зламано / не працює»Відтвори сам: виклич ендпоінт, відкрий сторінку, запусти тест

Крок 3 — звір: твердження == реальність?

  • Збіглось → тривога справжня, дій (можеш перейти до /pre-deploy чи debug).
  • Не збіглось → це міф застарілого документа. НЕ витрачай години. Зроби дві речі:
    1. Скажи прямо: «перевірив — насправді Y, документ застарів».
    2. Онови документ (CLAUDE.md/MEMORY/лист) на місці — щоб та сама брехня не зʼїла час наступного разу.

Крок 4 — рахуй, скільки зекономив

Одне речення в кінці: «звірка зайняла 5 хв, зберегла ~N год марної роботи». Це робить користь відчутною і закріплює звичку.


Правило скіла

Жодне твердження про стан коду/інфри/задачі не запускає роботу, поки не звірене з живим джерелом. «Документ так каже» — це привід перевірити, а не привід діяти. Три застарілі тривоги за один день довели: сумнів дешевший за годину не туди.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.