Made on
Tilda
Отчёт, который вы собрали с Claude, проживёт дольше одного разговора. Через месяц вы забудете, почему порог 10 %, а не 5 %. Через полгода его будет собирать коллега, пока вы в отпуске. Claude тоже ничего не помнит между сессиями. В уроке — как устроить папку проекта и шесть коротких документов, чтобы работу мог продолжить кто угодно: вы, коллега или новый разговор с Claude.
A report you built with Claude will outlive one conversation. In a month you'll forget why the threshold is 10% and not 5%. In six months a colleague will build it while you're on holiday. Claude doesn't remember anything between sessions either. This lesson shows how to set up a project folder and six short documents so anyone can carry on: you, a colleague or a new Claude conversation.
Все шесть — обычные текстовые файлы с расширением .md (Markdown: заголовки через #, пункты через дефис). Открываются Блокнотом, Claude читает и пишет их сам.
All six are plain text files with the .md extension (Markdown: headings with #, bullets with a dash). Notepad opens them, and Claude reads and writes them itself.
На линии розлива работают три смены. Уходя, мастер пишет в журнал: что сделали, что сломалось, почему остановили линию, что осталось сделать. Утренняя смена не звонит ночной — она читает журнал и продолжает. Если журнала нет, каждая смена начинает с вопроса «а что тут было?».
A bottling line runs three shifts. On leaving, the foreman writes in the log: what was done, what broke, why the line was stopped, what's left to do. The morning shift doesn't call the night shift — it reads the log and carries on. Without a log, every shift starts with "so what happened here?".
Пример — ежемесячный отчёт «план/факт по городам» в «Долине напитков». Так папка выглядит через полгода работы:
An example — the monthly "plan vs actual by city" report at Valley Beverages. This is how the folder looks after six months of work:
Отчёт_план_факт\
├── CLAUDE.md правила для Claude (урок 15-26)
├── README.md что это и как запустить
├── ARCHITECTURE.md вход → скрипты → выход
├── CHANGELOG.md что менялось
├── DECISIONS.md почему так решили
├── TODO.md что осталось
├── DATA_DICTIONARY.md что значат колонки
├── Собрать.bat кнопка (урок 15-27)
├── Данные\ выгрузки — только читать
├── Скрипты\ .py, которые написал Claude
├── Отчёты\ готовые файлы с датой в имени
└── _архив\ старые версии, ничего не удаляем PlanActual_Report\
├── CLAUDE.md rules for Claude (lesson 15-26)
├── README.md what it is and how to run it
├── ARCHITECTURE.md input → scripts → output
├── CHANGELOG.md what changed
├── DECISIONS.md why it was decided
├── TODO.md what's left
├── DATA_DICTIONARY.md what the columns mean
├── Build.bat the button (lesson 15-27)
├── Data\ exports — read-only
├── Scripts\ .py files Claude wrote
├── Reports\ finished files with the date in the name
└── _archive\ old versions, nothing gets deleted | ПравилоRule | ЗачемWhy |
|---|---|
| Одна регулярная задача — одна папкаOne recurring task — one folder | в общей папке «Работа» Claude путает файлы двух отчётовin a catch-all "Work" folder Claude mixes up the files of two reports |
| Папка в общем хранилище отдела (SharePoint, OneDrive), а не на рабочем столеThe folder lives in the team's shared storage (SharePoint, OneDrive), not on the desktop | коллега откроет её в отпуске автора; ноутбук может сломатьсяa colleague can open it while the author is away; a laptop can break |
| Документы проекта — в корне папкиProject documents sit in the folder's root | Claude и человек находят их сразу, без поискаClaude and people find them at once, without searching |
Старое — в _архив, а не в корзинуOld stuff goes to _archive, not the bin | через полгода спросят «а как считали в мае?»in six months someone will ask "how was May calculated?" |
Каждый документ отвечает на один вопрос. Если не знаете, куда записать, — спросите себя, на какой вопрос отвечает запись.
Each document answers one question. If you don't know where to write something, ask yourself which question the entry answers.
Что это и как запустить?
What is it and how do I run it?
Назначение в 2 строках, откуда брать данные, как запустить, где результат, кому писать.
Purpose in 2 lines, where to get the data, how to run it, where the result is, whom to contact.
Как это устроено внутри?
How does it work inside?
Какие файлы на входе, какой скрипт что делает, в каком порядке, что на выходе.
Which input files, what each script does, in what order, what the output is.
Что значит эта колонка?
What does this column mean?
Каждая колонка входа и выхода: смысл, единица, откуда, ловушки.
Every input and output column: meaning, unit, source, traps.
Что и когда поменялось?
What changed and when?
Дата и 1–3 строки о каждой правке. Новое — сверху.
The date and 1–3 lines per change. Newest on top.
Почему так, а не иначе?
Why this way and not another?
Решение, причина, кто решил, дата. Самый ценный документ через полгода.
The decision, the reason, who decided, the date. The most valuable document six months later.
Что осталось сделать?
What's left to do?
Открытые задачи, вопросы «ждём ответа от…», сделанное — с галочкой.
Open tasks, "waiting for an answer from…" questions, done items ticked.
Маленькому отчёту хватит трёх: README, CHANGELOG, DECISIONS. Остальные три заводите, когда в проекте больше одного скрипта или больше одного человека.
A small report can live with three: README, CHANGELOG, DECISIONS. Add the other three once the project has more than one script or more than one person.
Писать шесть файлов руками не нужно. Откройте Claude Code в папке проекта (урок 15-24) и отправьте запрос. Claude осмотрит папку и напишет черновики, а вы поправите то, что он не мог знать: причины решений и имена владельцев.
You don't need to write six files by hand. Open Claude Code in the project folder (lesson 15-24) and send the request. Claude looks around the folder and drafts them, and you fix what it couldn't know: the reasons behind decisions and the owners' names.
Осмотри эту папку: файлы, скрипты, CLAUDE.md. Заведи в корне документы проекта: README.md, ARCHITECTURE.md, DATA_DICTIONARY.md, CHANGELOG.md, DECISIONS.md, TODO.md.
- README: назначение в 2 строках, откуда данные, как запустить, где результат, к кому обращаться.
- ARCHITECTURE: вход → скрипты по порядку → выход.
- DATA_DICTIONARY: каждая колонка входа и выхода — смысл, единица, источник.
- CHANGELOG: первая запись с сегодняшней датой «документы заведены».
- DECISIONS: решения, которые видны в коде (пороги, единицы, исключения), с пометкой «причину уточнить».
- TODO: что ты заметил недоделанным или подозрительным.
Пиши коротко, по-русски, только то, что видно в файлах. Чего не знаешь — оставь [уточнить]. Исходные данные не трогай. Покажи список файлов и спроси меня, прежде чем сохранять. Look through this folder: files, scripts, CLAUDE.md. Create the project documents in the root: README.md, ARCHITECTURE.md, DATA_DICTIONARY.md, CHANGELOG.md, DECISIONS.md, TODO.md.
- README: purpose in 2 lines, where the data comes from, how to run it, where the result is, whom to contact.
- ARCHITECTURE: input → scripts in order → output.
- DATA_DICTIONARY: every input and output column — meaning, unit, source.
- CHANGELOG: a first entry with today's date, "documents created".
- DECISIONS: decisions visible in the code (thresholds, units, exclusions), marked "reason to be confirmed".
- TODO: anything you noticed that's unfinished or suspicious.
Write briefly, in English, only what's visible in the files. What you don't know, leave as [to confirm]. Don't touch the source data. Show me the list of files and ask me before saving. Потом добавьте в CLAUDE.md одну строку — и Claude будет обновлять документы сам:
Then add one line to CLAUDE.md — and Claude will keep the documents up to date itself:
## Документы проекта
- После каждой правки обнови README, ARCHITECTURE и DATA_DICTIONARY, если они устарели; допиши запись в CHANGELOG (дата, что изменилось, чем проверено) и в DECISIONS, если было решение. Отметь сделанное в TODO.
- README, ARCHITECTURE, DATA_DICTIONARY описывают текущее состояние. CHANGELOG и DECISIONS только дописываются. ## Project documents
- After every change, update README, ARCHITECTURE and DATA_DICTIONARY if they are out of date; add an entry to CHANGELOG (date, what changed, how it was checked) and to DECISIONS if a decision was made. Tick off done items in TODO.
- README, ARCHITECTURE, DATA_DICTIONARY describe the current state. CHANGELOG and DECISIONS are only appended to. Чтобы проект не разваливался, каждая сессия с Claude начинается и заканчивается одинаково. Это две минуты, которые экономят час на следующей неделе.
To keep a project from falling apart, every Claude session starts and ends the same way. Two minutes that save an hour next week.
/rename), важное сохранено в конспект (урок 15-40)./rename), the key points saved as notes (lesson 15-40).Прочитай TODO.md и три последние записи CHANGELOG.md. Коротко: на чём мы остановились, что открыто, есть ли вопросы, которые ждут ответа. Ничего не меняй. Read TODO.md and the last three CHANGELOG.md entries. Briefly: where we left off, what's open, and whether any questions are waiting for an answer. Don't change anything. Заканчиваем на сегодня. Обнови документы проекта: запись в CHANGELOG (что сделали, чем проверили, какая цифра сверки), решения — в DECISIONS с причиной, TODO — что осталось и кого ждём. Если README или DATA_DICTIONARY устарели — поправь. Покажи, что изменил. We're done for today. Update the project documents: a CHANGELOG entry (what we did, how we checked it, the reconciliation number), decisions into DECISIONS with the reason, TODO — what's left and whom we're waiting for. If README or DATA_DICTIONARY are out of date, fix them. Show me what you changed. В чате claude.ai то же самое делает проект (урок 15-17): документы кладутся в знания проекта, а «конец сессии» — это просьба «дай обновлённый CHANGELOG и DECISIONS», которые вы заменяете в знаниях.
In claude.ai chat a project does the same (lesson 15-17): the documents go into the project knowledge, and "end of session" is a request "give me the updated CHANGELOG and DECISIONS", which you replace in the knowledge.
Восемь записей из жизни отчёта «план/факт». Выберите, куда их положить.
Eight entries from the life of the plan/actual report. Choose where each one goes.
Проверка простая: коллега, который проект не видел, собирает отчёт по README, не задав вам ни одного вопроса. Если задал — ответ надо дописать в документы.
The test is simple: a colleague who has never seen the project builds the report from the README without asking you a single question. If they asked one, the answer belongs in the documents.
Чек-лист передачи. Галочки сохраняются в браузере.
Handover checklist. The ticks are saved in your browser.
| ОшибкаMistake | Как правильноDo this instead |
|---|---|
| Все отчёты в одной папке «Claude»All reports in one "Claude" folder | Одна задача — одна папка со своим CLAUDE.md и документамиOne task — one folder with its own CLAUDE.md and documents |
| README написан в первый день и больше не менялсяThe README was written on day one and never changed | Строка в CLAUDE.md «после правки обнови документы» + запрос «конец сессии»A line in CLAUDE.md "update the docs after a change" + the "end of session" request |
| В CHANGELOG «поправил скрипт»CHANGELOG says "fixed the script" | Что именно, зачем и какая цифра сверки после правкиWhat exactly, why, and the reconciliation number after the fix |
| Причины решений — только в головеThe reasons for decisions live only in your head | DECISIONS: решение, причина, кто, дата — одна строкаDECISIONS: decision, reason, who, date — one line |
| Документы на 20 страниц, их никто не читает20-page documents nobody reads | Коротко, пунктами; история — в CHANGELOG, а не в READMEShort, in bullets; history goes to CHANGELOG, not README |
| Проект на рабочем столе ноутбукаThe project sits on the laptop desktop | В общем хранилище отдела, пути относительные (урок 15-29)In the team's shared storage, relative paths (lesson 15-29) |