Один markdown-файл в корне проекта меняет поведение Claude сильнее любого промпта

Один markdown-файл в корне проекта меняет поведение Claude сильнее любого промпта.

26 января Карпаты написал в X: за последние недели его workflow ушёл с 80% ручного кодинга на 80% агентов. И заметил то, что чувствовал каждый, кто работал с Claude дольше недели:

— модели делают неверные предположения и молча идут дальше

— усложняют там, где не просили

— трогают код, который трогать не нужно

Через сутки разработчик Forrest Chang упаковал эти наблюдения в один markdown-файл. 110 000 звёзд на GitHub. 28 недель в топе trending.

Внутри — 4 принципа:

➖ Думай перед тем как кодить. Не угадывай. Если задача допускает несколько трактовок — озвучь их и спроси.

➖ Простота. Минимум кода, который решает задачу. Никаких "пока я здесь, заодно отрефакторю".

➖ Хирургические изменения. Трогай только то, что нужно. Не чисти соседний код. Следуй стилю проекта, не навязывай свой.

➖ Исполнение от цели. Перед кодом сформулируй проверяемый критерий: "это работает, если X". Проверь — потом считай задачу выполненной.

Готовый файл — кладёшь в корень проекта как CLAUDE.md:

# Project Guidelines

## Before coding

- State your assumptions explicitly before writing any code

- If the request is ambiguous, list interpretations and ask which one

- Never proceed with uncertainty — surface it

## Simplicity

- Implement only what was explicitly requested

- No speculative features, no "while I'm here" additions

- No premature abstraction — 3 similar lines > 1 clever abstraction

- No unnecessary error handling for scenarios that cannot happen

## Surgical changes

- Touch only files directly related to the task

- Match existing code style and naming conventions

- Do not refactor unrelated code unless explicitly asked

- Do not add comments unless the logic is genuinely non-obvious

## Goal-driven execution

- Before implementation, state: "This is done when [specific check]"

- Define success criteria per step, not per feature

- Verify against criteria before marking complete

Положи файл в каждый проект — и Claude поведёт себя иначе с первого же запроса.

Репозиторий