Рабочий процесс на лёгких форматах

Перевести документы один раз - полдела. Чтобы через месяц папка снова не заросла docx, нужны три вещи: понятная структура, правило для агента и способ отдавать клиенту Word, не ломая процесс. Разберём все три.

Структура папки

Принцип: то, что пришло снаружи, лежит нетронутым в _source/. Рабочие копии в лёгких форматах - рядом, в корне проекта или по смысловым папкам. Агент работает только с рабочими копиями.

project/
  AGENTS.md              # правила для агента (в Claude Code - CLAUDE.md)
  README.md              # что за проект, где что лежит
  _source/               # как пришло: docx, xlsx, pdf - не редактировать
    brief-from-client.docx
    prices-2026.xlsx
    contract-scan.pdf
  brief.md               # рабочая копия брифа
  prices.csv             # рабочая копия прайса
  contract.md            # распознанный и размеченный договор
  images/                # картинки, вынесенные из документов
  notes/                 # протоколы встреч, заметки - сразу в md
    2026-09-12-kickoff.md
  out/                   # то, что уходит клиенту: собирается из md
    proposal.docx

Подчёркивание в _source/ не случайно: папка поднимается в начало списка и сразу видно, что это особая зона. Туда кладут, оттуда не правят.

Папка out/ - для выдачи. Её содержимое всегда можно пересобрать из md, поэтому её не жалко удалить и не страшно перезаписать.

Правило для агента

Без правила агент, увидев docx в _source/, полезет его читать - со всеми издержками из главы 02. Одного блока в AGENTS.md / CLAUDE.md (в Claude Code тот же файл называется CLAUDE.md) хватает, чтобы этого не происходило:

## Форматы документов

Работай с .md и .csv. Файлы .docx, .xlsx и .pdf не открывай без
прямой просьбы: если нужен документ, которого нет в лёгком формате,
сначала переведи его в .md или .csv в ту же папку, где лежит рабочая
копия, и дальше работай с ней.

Папка _source/ - исходники как пришли. Не редактируй их и не
переименовывай. Рабочие копии лежат в корне проекта и в notes/.

Когда нужен документ для клиента (docx, xlsx, pdf) - собери его из
md или csv в папку out/. Источник правды остаётся в лёгком формате.

Правило короткое, но оно закрывает все три сценария: чтение, конвертацию и выдачу. Подробнее про сам файл правил - в курсе AGENTS.md / CLAUDE.md.

Источник правды - всегда лёгкий файл. Word и Excel - это снимок с него, который можно пересобрать в любой момент.

Когда всё-таки нужен Word или Excel

Три честных случая:

• Выдача клиенту. Ему привычнее docx, а КП на фирменном бланке в md не отправишь.
• Юридические документы. Договор подписывают в том виде, в каком он согласован, и это обычно docx или pdf.
• Требования заказчика. «Отчёт присылать в xlsx по нашему шаблону» - спорить бессмысленно.

Во всех трёх случаях тяжёлый файл появляется в конце, как результат сборки. Редактируете md - пересобираете docx. Правки в docx руками не делаете: иначе через неделю никто не вспомнит, какая версия настоящая.

Сборка через pandoc

# md в docx
pandoc proposal.md -o out/proposal.docx

# с шаблоном оформления: стили, шрифты, колонтитулы берутся из reference.docx
pandoc proposal.md --reference-doc=templates/reference.docx -o out/proposal.docx

# md в pdf (нужен установленный LaTeX или wkhtmltopdf)
pandoc proposal.md -o out/proposal.pdf

Шаблон reference.docx делается один раз: берёте свой фирменный документ, чистите содержимое, оставляете стили. Дальше все docx из md выходят в фирменном оформлении.

Сборка скриптом

Когда возможностей pandoc не хватает (сложные таблицы в xlsx, подпись в документе, несколько документов из одного набора данных), агент напишет скрипт на Python с python-docx или openpyxl. Просите его сразу положить скрипт в проект, чтобы сборка повторялась одной командой:

Напиши скрипт build.py, который собирает out/report.xlsx из prices.csv
и sales.csv: первый лист - прайс как есть, второй - продажи с итогом
по месяцам. Заголовки жирным, числа с разделителем тысяч. Запуск
одной командой без аргументов. Проверь, что файл открывается.

Как встроить в повседневную работу

Готовые промпты

Разбор входящей папки:

В _source/ лежат 14 файлов разных форматов. Для каждого определи тип
(docx, xlsx, pdf с текстом, скан) и переведи в лёгкий формат в корень
проекта: документы в md, таблицы в csv (лист - файл), сканы через OCR
в md. Составь в README.md таблицу: исходник - рабочая копия - что
проверить руками. Ничего не пересказывай, только переносить как есть.

Сводка по документам:

Прочитай все md в notes/ за сентябрь и составь summary-2026-09.md:
какие решения приняты, кто за что отвечает, открытые вопросы. Для
каждого пункта - ссылка на файл и цитата из него. Не додумывай.

Проверка на противоречия:

Сравни proposal.md с regulations.md: найди все места, где КП
противоречит регламенту (сроки, суммы, формулировки). Выведи
таблицей: пункт КП - пункт регламента - в чём расхождение.

Пересборка выдачи:

Я поправил proposal.md. Пересобери out/proposal.docx через pandoc
с шаблоном templates/reference.docx и проверь, что все три таблицы
на месте и нумерация разделов не сбилась. Открывать Word не нужно,
проверь через pandoc в обратную сторону.

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

• Править docx в out/ руками «чуть-чуть». Через неделю md и docx расходятся, и непонятно, где правда.
• Складывать новые документы не в _source/, а куда попало. Через месяц агент находит три версии брифа и не знает, какая актуальная.
• Не писать правило в AGENTS.md / CLAUDE.md и напоминать агенту каждый раз. Он забудет, вы забудете, файл откроется.
• Хранить рабочие копии внутри _source/. Граница между «пришло» и «работаем» стирается.
• Собирать выдачу без шаблона и потом руками красить в Word. Шаблон делается раз, экономит каждый раз.

Дальше - шпаргалка: всё главное из курса на одной странице.