av
e5dc0a1a39
Оба слова стояли в закрытом словаре правила 6 с оговоркой, и обе оговорки отвергали один русский вариант, а вывод из них делался про все. Отсюда общее требование к записи словаря: она обязана говорить, чем слово незаменимо, а не чем плох один из кандидатов. Латинизм, переживший проверку одним синонимом, — не имя вещи, а непроверенная привычка. Провенанс заменён двумя словами, потому что смысла было два, и это же его и держало: происхождение у числа (чем и при каких условиях получено) и откуда у вопроса и находки (кто нашёл, каким проходом, из какой записи журнала). Слово стояло и в скелете docs/review.md, уезжающем в репозитории проектов, поэтому раскладка повышена до версии 4 с записью журнала: правка формы вопроса и проход grep по docs/. Интейк заменён заведением с названным источником — «из диалога», «из ревью». Оговорка защищала слово от голого «заведения» и в этом была права, но в паре с источником двусмысленности нет, а скилл задач уже называет операцию так же. Раскладку это не двигает: слово жило только в прозе плагина. Образец стиля назван прямо и отдельным разделом: научно-популярная книга, не спецификация и не конспект для себя. Три умолчания — воды нет, сложных конструкций нет, англицизм исключение с причиной. Находок образец не порождает: он для того, кто пишет, а вычитка судит по правилам, иначе «звучит сложно» стало бы находкой и порог правки перестал бы работать. Журнал решений: темы 70 и 71, Р258–Р264 и С244–С249. Остальной словарь — триаж, дедуп, чек-лист, дифф, промпт, чекпоинт, синк — не пересматривался, и это сказано записью: пересмотр меняет язык всего корпуса и делается своей работой, а не попутно.
6.7 KiB
🔬 research — исход работы знание, а не изменение системы
Ответ на вопрос, замер, разведка, проработка сырой мысли. Приёмка — записанный ответ, а не изменённый код.
Общая форма записи (мета, слаг, строка индекса) — task-format.md. Здесь только то, что у этого типа своё.
Схема
| Заголовок отвечает на | о чём разведка (предмет, а не действие) |
| Обязательные разделы | Вопрос, Куда ляжет ответ |
| Допустимые сверх того | Рамки, Вопросы |
| Поле места | Категория — полка домена беклога |
| Индекс | BACKLOG.md |
| Берётся в работу | да — но только с заполненным «Вопросом» |
Критериев приёмки у research нет, и это не поблажка. Критерии в форме
«оракул: тест» разведке натянуты: проверять нечего, пока ответа нет. Её приёмка
описывается раздельно — вопрос, на который отвечаем, и место, куда ляжет ответ.
Заголовок формы действия не несёт намеренно. Что делать, ещё неизвестно, и заголовок-действие обещал бы решённость, которой нет. «Подсказка следующего хода», а не «Сделать подсказку следующего хода».
Этот тип вобрал прежний [idea]
Тип idea упразднён. Он значил не род работы, а состояние незаполненности —
«первый, второй или третий вопрос теста готовности не отвечается», — а состояние
типом быть не может: оно меняется по мере того, как запись дописывают, а тип
меняют командой.
Теперь это состояние называется честно: research без раздела «Вопрос» — это
сырьё.
| сырьё | разведка | |
|---|---|---|
Раздел Вопрос |
пуст или отсутствует | заполнен |
ready |
отказ | берёт |
| Место в секции беклога | конец, check --fix сносит туда сам |
среди прочих |
tasks.py list --raw |
показывает | нет |
Порядок строк в беклоге назначает человек, и стадия решает, что он значит: зависимость на стройке, важность на доработке (правило 4 скилла). Место сырья из него изъято: оно производно от типа и заполненности, а не от чьего-то решения, и потому его проверяет и чинит машина. Приоритетом оно не становится: сырьё не берут вовсе, и место в конце говорит именно это.
Сырьём заводится и сырая функция: «Подсказка следующего хода» — ещё не
feature, потому что неизвестно, что именно делать. Работа над ней — думание, и
её исход — либо задачи, либо отказ.
Алгоритм
- Записать вопрос одной фразой. Не тему, а вопрос: не «Разобраться с
выводом в терминалах», а «Какими символами рамки печатаются одинаково в
Терминале, iTerm и
tmux». Вопроса ещё нет — запись заводится сырьём и лежит в конце секции, пока вопрос не появится. - Назвать, куда ляжет ответ:
docs/research/<slug>.md, ADR, тело этой задачи. Место называется заранее, иначе ответ остаётся в переписке, а через квартал разведку заказывают заново. - Ограничить рамками, если разведка может утечь: сколько времени, какие источники, что заведомо вне.
- Провести разведку и записать ответ по названному адресу. Числа — с
происхождением: с командой или условиями, которыми получены. Число без источника
проход ревью обязан читать как условие, а не как замер. Проводит её конвейер
проекта — скилл
av-dev:code-resolve, сценарий разведки; этот скилл её только заводит и закрывает. - Разложить исход на задачи — если он их родил. Разведка кончается одним из трёх: заведены задачи, записано знание, отказ. Отказ — полноправный исход: «проверили, не проблема» экономит работу.
- Закрыть —
close <слаг> --implemented, когда ответ записан. Файл удаляется: запись ответа и есть след, второго не нужно. Ушла без ответа —close --reason, и строка уезжает вREJECTED.md.
Что видит машина, а что человек
ready смотрит на наличие непустых разделов Вопрос и
Куда ляжет ответ; check считает сырьё отдельной строкой здоровья и держит
его в конце секции. Годность вопроса — человеку: «вопрос это или тема» машина не различает,
и check о годности молчит намеренно.
Штурм сырья, дробление исхода на задачи и тест «части мерджатся порознь» — split.md.