4 月 13 日 abmedia раніше повідомляли, що Forrest Chang перетворив нараду Карпаті з приводу «CLAUDE пише код» у «4 правила CLAUDE.md», тоді на GitHub repo було накопичено 15 000 зірок; 5 травня 12-го числа кількість зірок цього repo вже перевищила 126 000 — за менш ніж 1 місяць зростання склало у 8 разів. Після цього в ком’юніті з’явилося багато спроб «розширених версій», серед яких допис інженера Mnilax (@Mnimiy) від 9 травня «на основі 4 додаю 8, стає повна версія з 12» набрав 5 968 лайків і є одним із найобговорюваніших одиночних матеріалів у недавньому спільноті Claude Code.
4 правила як відкат: Forrest Chang перетворив нарікання Карпаті на виконувані шаблони
Оригінальні 4 правила Forrest Chang (кожне відповідає одному з провалів, на які Карпаті в січні на X прямо вказував):
Think Before Coding（спершу думай, потім пиши）：не роби неявних припущень — формулюй, що саме припускаєш; зіставляй trade-off і розкривай їх; якщо не впевнений — одразу питай, не вгадуй; якщо існує простіший спосіб — виступай проти складних рішень
Simplicity First（спершу простота）：пиши мінімальний код, який розв’язує проблему; не додавай припущувані функції; не виділяй абстракції для одноразового коду; досвідчені інженери скажуть, що надто складний дизайн треба спрощувати
Surgical Changes（хірургічні зміни）：внось лише те, що справді треба, не «покращуй попутно» сусідні ділянки коду, коментарі або формат; не рефакторь нічого, що не зламане; дотримуйся наявного стилю
Goal-Driven Execution（виконання, кероване цілями）：визнач успіх і ітеруй аж до валідації; не розписуй Claude покрокові дії — скажи, як виглядає «успіх», щоб він сам робив loop
Насправді офіційна документація Anthropic говорить дуже прямо: CLAUDE.md — це «advisory»-файл, і Claude десь у 80% випадків його дотримується; після понад 200 рядків частка відповідності різко падає, бо важливі правила тоне в шумі. Рішення Forrest Chang — стиснути правила до 65 рядків, 4 правил і досягти «floor» (мінімального порогу).
Mnilax додає 8 правил: доповнення до нових сценаріїв провалів епохи agent у 2026/5
Позиція Mnilax: зауваження Карпаті в січні були зосереджені на сценарії «Claude пише код», але станом на травень Claude Code-середовище еволюціонувало до багатьох agent-ів, співпраці, під’єднань через hook-и, конфліктів завантаження skill-ів, багатокрокових воркфлоу на переходах між session тощо — тож потрібні додаткові правила. Ось 8 рядків, які він додав (впорядковано за оригінальним порядком):
Rule 5：використовуй Claude лише для завдань, де потрібне судження (класифікація, рерайт/драфт, підсумування, екстракція), а детерміністичні рішення (ретраї 503, роутинг, обробка status code, детерміністичні конверсії) обробляй звичайним кодом
Rule 6：Token budget — це не рекомендація: ліміт 4,000 токенів на одне завдання і 30,000 токенів на одну session; коли наближаєшся до budget — активно роби summary і перезапуск, не проривай мовчки
Rule 7：два конфліктні патерни коду потрібно «явно змусити вибрати один» (брати більш новий або той, що має більше тестів), пояснити, чому саме його, і позначити інший як такий, що треба прибрати; змішування двох патернів — найгірший варіант
Rule 8：перед написанням коду спершу розберися — прочитай exports, напряму caller-ів, спільні utility; фраза «виглядає непов’язаним (looks orthogonal)» — найнебезпечніше формулювання; якщо не впевнений — питай
Rule 9：тести мають верифікувати «намір», а не лише «поведінку» — тест, який падає при зміні бізнес-логіки, можна вважати коректним; інакше ти просто даєш Claude більше впевненості, а фактичного захисту нема
Rule 10：багатокрокові завдання треба checkpoint-ити — після кожного кроку підсумуй «що зробив, що верифікував, що лишилось»; якщо не можеш чітко описати стан — не продовжуй
Rule 11：працюй у межах усталених конвенцій codebase, навіть якщо тобі вони не подобаються: якщо snake_case — то snake_case, якщо class component — то class component; якщо не погоджуєшся — винеси це як окрему дискусію, не роби однобічну вітку
Rule 12：про фейли треба говорити гучно — «migration завершено» не підходить, якщо ти пропустив 30 записів, «тести пройшли» не підходить, якщо ти пропустив хоча б один; за замовчуванням «активно розкривай невизначеність», не «ховай невизначеність»
Mnilax стверджує, що на 30 codebase і протягом 6 тижнів перевірив ці 12 правил, заявляючи, що rate помилок знизився з 41% до 3%, а відповідність правилам просіла лише незначно (78% → 76%). Спостереження цього медіа: ці цифри — самозвіт автора, без незалежної верифікації; втім 8 правил самі по собі змістовні й добре відповідають болям, які відповідають поточним сценаріям використання Claude Code з multi-agent (наприклад, Agent View з управлінням multiple session, Multi-Agent Layer у шести шарах архітектури).
Сценарії застосування та практичні поради
Mnilax також прямо називає, чого не варто робити:
Більше 14 рядків правил: відповідність падає до 52% (з 76% різке падіння), 200 рядків — фактична верхня межа
Використовувати приклади замість правил: токенова вартість 3 прикладів дорівнює 10 рядкам правил, а Claude легше переадаптується під один-єдиний приклад
Абстрактні інструкції на кшталт «Be careful / think hard / really focus»: низька перевірюваність, відповідність лише 30%
Просити Claude «поводитися як старший інженер»: identity prompt не працює на зміну поведінки, працюють лише правила-інструкції
Розраховувати на конкретні інструменти: «завжди використовуй eslint» при відсутньому встановленому eslint буде тихо ламатися; краще формулювання на кшталт «узгодься зі стилем codebase», які інструментонезалежні
Практичний спосіб, який рекомендує це медіа: CLAUDE.md — це «контракт поведінки», а не список побажань: кожне правило має відповідати на питання «яку конкретну помилку воно запобігає». Якщо твоя робота не включає багатокроковий pipeline, Rule 10 (checkpoint) тобі майже не потрібне; якщо в codebase вже є lint, який примусово тримає єдиний стиль, Rule 11 (підлаштовуйся під конвенції) зайвий. Після прочитання 12 правил залиш лише версію, яка відповідає тим «камінцям», що ти реально вже обпік; решту можна прибрати.
Серед подій, які можна відстежити далі: чи Anthropic офіційно «регуляризує» правила CLAUDE.md (наразі це лише advisory), чи repo Forrest Chang увійде в офіційно рекомендовані шаблони, чи в ком’юніті з’являться кастомізовані версії під конкретні домени (frontend / backend / data engineering), і чи зміниться відповідність rules після оновлень версії моделей Claude.
Ця стаття Karpathy CLAUDE.md намагається набрати 126K зірок: добірка ком’юніті з просунутими 12 правилами вперше з’явилася в ABMedia як «Ланцюг новин ABMedia».
