Виды артефактов

Видов немного. На практике хватает семи, и у каждого есть свой момент, когда его пора заводить. Шаблоны ниже короткие специально: артефакт должен читаться за минуту, иначе его перестанут читать.

Резюме встречи или звонка

Когда заводить: сразу после разговора с клиентом, коллегой, партнёром - пока помните, кто что сказал.

# Звонок с ООО «Ромашка», 2026-09-15

Участники: Иван (директор), Мария (HR), Павел.

## Что хотят
- Обучить 40 руководителей работе с агентами, 4 недели.
- Старт в октябре, формат онлайн.

## Договорились
- Мы присылаем КП до 2026-09-19.
- Мария присылает список участников.

## Открытые вопросы
- Бюджет не назвали. Спросить письмом.

План работ: PLAN.md

Когда заводить: перед началом любой задачи длиннее часа. Сначала план, потом работа. И удобно, когда агент пишет план, а вы правите до старта.

# План: лендинг для курса

Цель: страница с описанием и формой заявки, дедлайн 2026-09-20.

- [x] Собрать тексты из брифа
- [ ] Структура страницы (6 блоков)
- [ ] Вёрстка, адаптив под мобильный
- [ ] Форма заявки в Telegram
- [ ] Проверка в браузере, правки

Не делаем: оплату, личный кабинет.

Файл решения: decision

Когда заводить: в момент, когда выбрали один из нескольких вариантов и понимаете, что через месяц спросите себя «почему так». Хранит сам выбор и заодно отвергнутые варианты.

# Решение: формат обучения - онлайн, а не очно

Дата: 2026-09-15

## Что решили
Четыре онлайн-модуля по 2 часа, по вторникам.

## Почему
- Участники в трёх городах, очно не собрать.
- Записи нужны для тех, кто пропустит.

## Что отвергли
- Очный интенсив на 2 дня: дорого по логистике, треть не приедет.
- Гибрид: плохой опыт у клиента в прошлом году.

Журнал изменений: NOTES.md

Когда заводить: с первого значимого изменения в проекте. Один файл на проект, новые записи сверху, старые не редактируются.

# NOTES.md

## 2026-09-15
### Изменено
- Цена в КП снижена с 400 до 350 тыс.: клиент режет бюджет.
- Модуль про MCP убран, вместо него - практика с агентами.

## 2026-09-12
### Добавлено
- Первая версия КП, отправлена Марии.

Чек-лист проверки

Когда заводить: когда одну и ту же проверку делаете второй раз. Список пунктов, которые агент или вы проходите перед сдачей.

# Чек-лист: КП перед отправкой

- [ ] Название компании клиента написано правильно везде
- [ ] Цена совпадает с decisions.md
- [ ] Даты модулей не попадают на праздники
- [ ] Контакт для ответа указан
- [ ] PDF открывается, страницы не съехали

Реестр

Когда заводить: когда сущностей больше пяти и они нужны не один раз. Клиенты, ссылки, контакты, серверы, аккаунты. Таблица или список, одна строка на сущность.

# Реестр: контакты по проекту

| Кто | Роль | Контакт | Заметка |
|---|---|---|---|
| Иван Петров | директор | @ivan_p | решает по бюджету |
| Мария Сидорова | HR | maria@romashka.ru | присылает списки |
| Олег | IT | @oleg_it | доступы к порталу |

«Что дальше»: NEXT-SESSION.md

Когда заводить: перед закрытием чата, если работа не закончена. Это письмо себе завтрашнему или следующему агенту.

# NEXT-SESSION.md

Остановились: черновик КП написан, цена не согласована.

Следующий шаг:
1. Дождаться ответа Марии по бюджету.
2. Обновить цену в kp-draft.md и decisions.md.
3. Прогнать чек-лист, отправить.

Не трогать: структуру модулей, она согласована.

Семь видов, но заводить все сразу не нужно. Начните с двух: PLAN.md перед задачей и NEXT-SESSION.md перед закрытием чата. Остальные появятся, когда почувствуете нужду.

Как называть файлы

Имя говорит о содержании. research.md лучше, чем file1.md; decision-pricing.md лучше, чем decision.md, если решений в папке несколько.

Дата пишется внутри файла в формате YYYY-MM-DD, не в имени. brief.md с датой в первой строке живёт долго и обновляется; brief-2026-09-15.md через неделю превращается в один из пяти похожих файлов, и непонятно, какой актуальный.

Исключение - журналы и резюме встреч, где записей много и они не заменяют друг друга: там дата в заголовке записи (как в NOTES.md выше) или в имени файла, если каждая встреча - отдельный файл: 2026-09-15-call-romashka.md. Такие файлы сортируются по дате сами.

Служебные файлы, которые агент должен находить без подсказки, - капсом: PLAN.md, NOTES.md, NEXT-SESSION.md, SUMMARY.md. Рабочие артефакты по задаче - строчными: brief.md, research.md, kp-draft.md.