Авторский курс Елизаровой НаталииAuthor's course by Nataliia Elizarova
Модуль 15 · Урок 15-29Module 15 · Lesson 15-29

Правила работы: исходники, сверка, пересборкаWorking rules: sources, reconciling, rebuilding

Одиннадцать правил, каждое из которых появилось после настоящей ошибки. Claude работает быстро, поэтому и ошибается быстро. Эти правила не дают ошибке дойти до директора.

Eleven rules, each born from a real mistake. Claude works fast, so it also makes mistakes fast. These rules stop a mistake before it reaches the director.

⏱ 15 минут⏱ 15 minutes 🎮 Тренажёр «Какое правило нарушено?»🎮 Drill: "Which rule is broken?" ✅ Тест из 5 вопросов✅ A 5-question quiz 🔎 Проверено: ноябрь 2026🔎 Checked: November 2026

После урока вы сможетеAfter this lesson you will be able to

  • работать с Claude так, чтобы исходные файлы компании оставались целыми;
  • ловить ошибку до отчёта: сверка с эталоном и пересборка;
  • делать отчёты, которые работают у любого коллеги;
  • вставить готовый блок правил в свой CLAUDE.md.
  • work with Claude so the company's source files stay intact;
  • catch a mistake before the report: reconciling and rebuilding;
  • build reports that work for any colleague;
  • paste a ready block of rules into your CLAUDE.md.
1

Словарик из пяти словA five-word glossary

ИсходникSource fileфайл компании, из которого берём данные: выгрузка, мастер-файл, бюджетthe company file we take data from: an export, a master file, a budget
ЭталонReferenceцифра, которой доверяют все: итог в учётной системе, утверждённый отчётa number everyone trusts: a total in the accounting system, an approved report
ПересборкаRebuildповторный запуск скрипта, чтобы отчёт получил новые цифрыrunning the script again so the report gets the new numbers
КэшCacheсохранённая копия уже скачанных данных, чтобы не качать их зановоa saved copy of data already downloaded, so you don't download it again
Относительный путьRelative pathпуть от папки отчёта («input\продажи.csv»), а не от диска C: конкретного ноутбукаa path from the report folder ("input\sales.csv"), not from the C: drive of one laptop
2

На пальцах: бухгалтер и первичкаIn plain words: an accountant and source documents

Хороший бухгалтер никогда не пишет на оригинале накладной. Он делает копию, считает на ней, сверяет итог с банковской выпиской и только потом подписывает отчёт. Если ошибся — оригинал цел, можно начать заново.

A good accountant never writes on the original invoice. They make a copy, calculate on it, reconcile the total with the bank statement, and only then sign the report. If they slip, the original is intact and they can start over.

Главная мысльKey idea С Claude то же самое, только темп в сто раз выше. Оригинал не трогаем, итог сверяем, отчёт пересобираем. Остальные правила — подробности этих трёх. With Claude it is the same, only a hundred times faster. Don't touch the original, reconcile the total, rebuild the report. The other rules are details of these three.
3

Одиннадцать правил и откуда они взялисьEleven rules and where they came from

Истории — из практики учебной компании «Долина напитков». Ошибки настоящие, названия изменены.

The stories come from the practice of the training company Valley Beverages. The mistakes are real, the names are changed.

1Исходники только читаемSources are read-only

Без правила:Without the rule: Claude «почистил» мастер-файл бюджета прямо в общей папке. Две колонки пропали, коллеги неделю работали с испорченным файлом.Claude "cleaned" the budget master file right in the shared folder. Two columns vanished, colleagues worked with a broken file for a week.
Как правильно:Do this: в запросе писать «исходные файлы не менять, результат — новым файлом рядом».write in the request "don't change source files, save the result as a new file next to them".

2Сначала понять источникUnderstand the source first

Без правила:Without the rule: Claude решил, что в колонке «Объём» литры. Там были штуки. Отчёт завысил продажи соков в полтора раза.Claude assumed the "Volume" column was in litres. It was in pieces. The report overstated juice sales one and a half times.
Как правильно:Do this: первым шагом — «открой файл, покажи листы, колонки, единицы и период. Ничего не додумывай».first step — "open the file, show sheets, columns, units and period. Don't guess anything".

3Сверка с эталоном — до отчётаReconcile with the reference — before the report

Без правила:Without the rule: красивый дашборд построили за день. На совещании выяснилось: итог на 21 % меньше, чем в учётной системе — потерялись строки без кода города.a nice dashboard was built in a day. At the meeting it turned out the total was 21% below the accounting system — rows without a city code were lost.
Как правильно:Do this: сначала одна цифра совпала с эталоном, потом — графики и оформление.first make one number match the reference, then charts and design.

4Поправили скрипт — пересоберите отчётFixed the script — rebuild the report

Без правила:Without the rule: ошибку в расчёте исправили, проверили промежуточную таблицу — всё верно. А отчёт не пересобрали, и директор получил старые цифры.the calculation bug was fixed and the intermediate table checked — all correct. But the report wasn't rebuilt, and the director got the old numbers.
Как правильно:Do this: после любой правки — запуск целиком и проверка в самом отчёте, а не в промежуточных данных.after any fix — run the whole thing and check in the report itself, not in the intermediate data.

5Не выкачивать зановоDon't download again

Без правила:Without the rule: скрипт каждый раз скачивал из учётной системы три года продаж. Час ожидания, а потом система упёрлась в лимит сессий.the script downloaded three years of sales from the system every time. An hour of waiting, then the system hit its session limit.
Как правильно:Do this: закрытые месяцы хранить в кэше, обновлять только текущий, незакрытый месяц.keep closed months in a cache, update only the current, open month.

6Никаких абсолютных путейNo absolute paths

Без правила:Without the rule: отчёт работал только у автора: в скрипте был путь «C:\Users\ivanova\…». В отпуске автора отчёт не собрал никто.the report worked only for its author: the script had the path "C:\Users\ivanova\…". While the author was on holiday, nobody could build it.
Как правильно:Do this: пути — от папки скрипта; проверить запуск на ноутбуке коллеги.paths from the script folder; test the run on a colleague's laptop.

7.bat — только латиницей.bat — Latin letters only

Без правила:Without the rule: в .bat написали «echo Готово». Окно мелькнуло и закрылось с ошибкой: кириллица ломает командную строку.the .bat had "echo Готово" (Cyrillic). The window flashed and closed with an error: Cyrillic breaks the command line.
Как правильно:Do this: в .bat только латиница и pause в конце; русские сообщения — внутри скрипта .py.only Latin letters in a .bat and pause at the end; Russian messages go inside the .py script.

8Открытый Excel ломает записьAn open Excel breaks writing

Без правила:Without the rule: один файл был открыт в Excel — скрипт упал на нём, и остальные пять отчётов тоже не обновились.one file was open in Excel — the script crashed on it, and the other five reports didn't update either.
Как правильно:Do this: каждый файл записывать отдельно и при ошибке писать «закройте файл X», а остальные доделывать.write each file separately; on error say "close file X" and finish the rest.

9Документация — о текущем состоянииDocs describe the current state

Без правила:Without the rule: README описывал первую версию отчёта. Коллега запустил старую команду и отправил отчёт по устаревшей логике.the README described the first version of the report. A colleague ran the old command and sent a report built on outdated logic.
Как правильно:Do this: после каждой правки просить Claude обновить README, CHANGELOG (что изменилось) и DECISIONS (почему так решили).after every change ask Claude to update README, CHANGELOG (what changed) and DECISIONS (why it was decided).

10«Спроси меня» и один вопрос за раз"Ask me" and one question at a time

Без правила:Without the rule: Claude не понял, какие коды считать новинками, угадал — и написал 300 строк кода на догадке. Всё переделывали.Claude didn't know which codes counted as new products, guessed — and wrote 300 lines of code on the guess. Everything was redone.
Как правильно:Do this: «если непонятно — спроси меня, по одному вопросу, с вариантами и рекомендацией»."if unclear, ask me — one question at a time, with options and a recommendation".

11Одна единица, числа — числамиOne unit, numbers as numbers

Без правила:Without the rule: в одной таблице тысячи, в соседней миллионы, а в Excel цифры пришли текстом — сумма не считалась.one table in thousands, the next in millions, and in Excel the numbers came as text — the sum didn't work.
Как правильно:Do this: одна единица на весь отчёт (например, тысячи литров), подпись единицы в заголовке, в Excel — числа, а не текст.one unit for the whole report (e.g. thousand litres), the unit in the header, numbers (not text) in Excel.
4

Тренажёр: какое правило нарушено?Drill: which rule is broken?

Восемь коротких историй. Выберите, какое правило нарушили.

Eight short stories. Choose which rule was broken.

5

Готовый блок правил для CLAUDE.mdA ready block of rules for CLAUDE.md

Скопируйте и вставьте в CLAUDE.md своей рабочей папки (урок 15-26). Поправьте единицу и эталон под свою задачу.

Copy and paste it into the CLAUDE.md of your work folder (lesson 15-26). Adjust the unit and the reference to your task.

Блок для CLAUDE.mdBlock for CLAUDE.md
## Правила работы
1. Исходные файлы компании только читать. Результат — новым файлом рядом, с датой в имени.
2. Сначала понять источник: открыть файл, показать листы, колонки, единицы, период. Структуру не додумывать.
3. До отчёта сверить итог с эталоном: [итог в учётной системе / утверждённый отчёт]. Расхождение — показать и остановиться.
4. После любой правки скрипта — пересобрать отчёт целиком и проверить цифру в самом отчёте.
5. Не скачивать заново то, что уже скачано: закрытые месяцы — из кэша, обновлять только текущий месяц.
6. Только относительные пути от папки скрипта. Никаких C:\Users\... и имён ноутбуков.
7. В .bat — только латиница, переход в папку файла и pause в конце. Русский текст — в .py.
8. Каждый выходной файл записывать отдельно. Если файл открыт в Excel — сообщить «закройте файл X» и доделать остальные.
9. После изменений обновить README, CHANGELOG и DECISIONS: они описывают текущее состояние.
10. Если что-то непонятно — спросить меня. По одному вопросу, с вариантами и рекомендацией.
11. Одна единица на весь отчёт: [тысячи литров]. Единица — в заголовке. В Excel — числа, не текст.
## Working rules
1. Company source files are read-only. Save the result as a new file next to them, with the date in the name.
2. Understand the source first: open the file, show sheets, columns, units, period. Don't guess the structure.
3. Before the report, reconcile the total with the reference: [system total / approved report]. If it differs, show it and stop.
4. After any script fix, rebuild the whole report and check the number in the report itself.
5. Don't download what is already downloaded: closed months from the cache, update only the current month.
6. Relative paths from the script folder only. No C:\Users\... and no laptop names.
7. In a .bat — Latin letters only, change to the file's folder and pause at the end. Russian text goes in the .py.
8. Write each output file separately. If a file is open in Excel, say "close file X" and finish the rest.
9. After changes, update README, CHANGELOG and DECISIONS: they describe the current state.
10. If anything is unclear, ask me. One question at a time, with options and a recommendation.
11. One unit for the whole report: [thousand litres]. Unit in the header. Numbers in Excel, not text.
Зачем в CLAUDE.mdWhy in CLAUDE.md Правило в CLAUDE.md Claude читает при каждом запуске в этой папке. Не нужно повторять его в каждом запросе — и нельзя забыть. Claude reads a rule in CLAUDE.md at every start in this folder. You don't need to repeat it in each request — and you can't forget it.
6

Практика: три заданияPractice: three tasks

Задание 1. Вставьте правила.Task 1. Paste the rules. Добавьте блок из раздела 5 в CLAUDE.md своей папки. Запустите Claude Code и спросите: «Перечисли правила, которые ты будешь соблюдать в этой папке». Все 11 на месте? Add the block from section 5 to your folder's CLAUDE.md. Start Claude Code and ask: "List the rules you will follow in this folder." Are all 11 there?
Задание 2. Проверьте свой отчёт.Task 2. Check your report. Возьмите любой свой отчёт со скриптом и попросите: «Проверь этот скрипт по правилам из CLAUDE.md. Какие правила нарушены? Покажи строки, ничего не меняй». Take any report of yours that has a script and ask: "Check this script against the rules in CLAUDE.md. Which rules are broken? Show the lines, change nothing."
Задание 3. Запуск у коллеги.Task 3. A run on a colleague's laptop. Скопируйте папку отчёта коллеге и попросите запустить .bat. Получилось без вашей помощи? Если нет — запишите, что сломалось, и добавьте в README. Copy the report folder to a colleague and ask them to run the .bat. Did it work without your help? If not, note what broke and add it to the README.
7

Частые ошибкиCommon mistakes

ОшибкаMistakeКак правильноDo this instead
Правила держат в голове, а не в CLAUDE.mdKeeping the rules in your head, not in CLAUDE.mdЗаписать один раз — Claude читает при каждом запускеWrite them once — Claude reads them at every start
Сверяют «на глаз»: «вроде похоже»Reconciling "by eye": "looks about right"Две цифры рядом: итог отчёта и эталон, разница в %Two numbers side by side: report total and reference, difference in %
Проверили промежуточный файл и успокоилисьChecked the intermediate file and relaxedПроверять итоговый отчёт, который получит адресатCheck the final report the recipient will get
Разрешили Claude «навести порядок» в общей папкеLet Claude "tidy up" the shared folderРаботать на копии; в общей папке — только чтениеWork on a copy; the shared folder is read-only
8

Чек-лист: перед отправкой результатаChecklist: before sending the result

Пройдите по пунктам каждый раз, когда отчёт уходит дальше. Галочки сохраняются в браузере.

Go through the list every time a report goes out. The ticks are saved in your browser.

9

Что запомнить: отметьте галочкойWhat to remember: tick it off

10

Проверьте себяCheck yourself

11

ШпаргалкаCheat sheet

Три главныхThe big threeоригинал не трогаем · итог сверяем · отчёт пересобираемdon't touch the original · reconcile the total · rebuild the report
Первый шагFirst step«покажи листы, колонки, единицы, период; не додумывай»"show sheets, columns, units, period; don't guess"
ПереносимостьPortabilityотносительные пути · .bat латиницей · README актуаленrelative paths · Latin-only .bat · README up to date
СкоростьSpeedзакрытые месяцы из кэша, обновляем только текущийclosed months from the cache, update only the current one
ВидLookодна единица на отчёт, подпись в заголовке, в Excel числаone unit per report, labelled in the header, numbers in Excel
Итог урокаLesson summary Все одиннадцать правил сводятся к трём: исходники не трогаем, итог сверяем с эталоном до отчёта, после правки пересобираем и проверяем сам отчёт. Остальное делает отчёт переносимым: относительные пути, .bat латиницей, актуальный README. Запишите правила в CLAUDE.md один раз — и Claude будет соблюдать их при каждом запуске. All eleven rules come down to three: don't touch sources, reconcile the total with the reference before the report, and after a fix rebuild and check the report itself. The rest makes the report portable: relative paths, Latin-only .bat, an up-to-date README. Write the rules into CLAUDE.md once, and Claude will follow them at every start.
Made on
Tilda