Как проектировать

Сложные системы не прощают мутных историй Пятнадцать лет я формулирую рабочие истории — сначала нащупывая метод сам, потом обучая ему коллег и специалистов из разных компаний. Категории рабочей истории — Носитель, Ситуация, Действие, Объекты, Цель, Форма реализации, Интерфейсная структура — появились не сразу: это результат многолетнего разбора того, что идёт не так, когда команда работает с требованиями. Готовые категории в шаблоне — уже большая часть работы: с ними уже не перепутать цель с деталью реализации. Но даже с шаблоном в руках хорошую историю по нему пишут единицы. Разница между теми, кто просто заполняет поля, и теми, кто пишет сильные истории, — в умении увидеть, где цель действия ещё не отделилась от красиво сформулированной детали реализации, и понимании когда именно допустимо остановиться, если ситуация описана уже достаточно точно.

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

Ремесло сплетения историй заметно в любой роли, где вообще имеют дело с инженерией требований. ⚫️ В продукте — историю закрывают, когда пройден технический критерий приёмки, а проверка, что при этом достигнута цель действия, часто вообще не происходит. ⚫️ В дизайне интерфейса — макет не выдерживает первый же нетиповой сценарий, потому что нарисован раньше, чем стало понятно, с чем в действительности работает использующий его человек. ⚫️ В сборе требований — хотелка заказчика превращается в задачу для разработки без ответов на вопросы «зачем делать вообще» и «зачем именно так». ⚫️ В командной работе — аналитик, дизайнер и разработчик обсуждают «одну» историю на разных диалектах, и смысл теряется на стыке. ⚫️ В цифровых сервисах для госсектора и НКО — услугу чаще проектируют от формы и регламента, а вопрос, зачем человек вообще сюда пришёл, звучит в последнюю очередь, если звучит вообще; тогда и вскрывается, что часть процедуры не нужна вовсе, и она мешает потребителю. ⚫️ При планировании релизов — истории группируют в этапы по техническому удобству, что легче задеплоить вместе, и потому случаются релизы, где вся функциональность вроде бы готова, но без соседнего куска бесполезна потребителю. Когда рабочая история наконец сплетена и чиста от форм реализации, решения по ней находятся в разы быстрее, получаются разнообразнее и интереснее. Их легко варьировать, потому что ничего в формулировке уже не тянет мысль в сторону одного конкретного варианта: инструмента, экрана, кнопки. Вместо слепого перебора вариантов в проектировании появляется управляемость: понятно, в какую сторону двигаться и почему. На курсе по Карте реализации историй я учу этому ремеслу — технике сплетения истории, шаг за шагом, поверх шаблона из семи категорий. 17 августа стартует новый поток. Присоединяйтесь, чтобы освоить действенную технику проектирования от инженеров, работающих со сложными системами Программа и запись

Ну, и лучшим средством структурирования беседы о требованиях и проектировании остаётся КРИ. Про это я написал отдельную книгу и её всё ещё можно приобрести в отличии от книги про КПО. https://ashapiro.ru/sim-book

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

Карта реализации историй на примере за 12 минут Разбирались вместе с Галой Янке. Это первая часть встречи, где я коротко ввожу КРИ и показываю её не только в шаблоне, но и на примере пары рабочих историй. КРИ здесь строится для инструмента поиска связи между стратегией и операционной деятельностью. Это когда высшее руководство хочет проверить а тем ли вообще занимаются сотрудники компании

А вот и запись вебинара по Карте Реализации Историй (КРИ) с Андреем Шапиро (автором подхода). Дополнительная информация по Карте Реализации Историй Инструмент, в котором мы рисовали карту А вот ссылки на видео: RUTube VKVideo

Запись вчерашнего эфира о Карте реализации историй

Новый отзыв о книге «Рабочие истории» Никита Максимов, QA-инженер:

❞ Классная книга про КРИ и в целом про проектирование. Нашёл для себя много полезного с первых глав. С JTBD,  User Story и Acceptance Criteria сталкивался, но постоянно было ощущение неопределённости, так как не был понятен ответ на вопрос «чтобы что?». Было не понятно, зачем упаковывать требования в пользовательскую историю, если этот артефакт формируется абы как, даже при соблюдении шаблона. Не было понимания кто и как им будет пользоваться дальше. По сути, я видел, что совершался некий ритуал, появлялся артефакт ритуала, которым дальше никто не пользовался. Есть в сфере QA, такое поверие, что если наладить практику «Три амиго», то получится собрать все N контекстов, оформить их в самые современные формы записи, договориться о критериях приёмки и тогда качество услуги продукта получится таким высоким, что конкуренты будут завидовать. Как одно с другим связано мне было совершенно не понятно. А вчера, после прочтения первых глав, всё стало на свои места) отдельное спасибо за закладку-ляссе ❝

Мини-курс по Карте реализации историй Сколько раз вы видели, как команда усердно работает над фичей, но потом выясняется: в ней нет ничего важного для потребителя? В бэклоге всё аккуратно, в макете всё красиво, разработка идёт — и всё же приходится выкидывать или переделывать, потому что смысл задачи потерялся где-то между первым разговором и итоговым интерфейсом. Если вы аналитик, продакт, дизайнер или разработчик и вам приходится объяснять, зачем вообще нужна функция, а не только что в ней должно быть, этот разрыв вам знаком. Карта реализации историй даёт недостающий мост. Она удерживает в одном ёмком описании действия его носителя, ситуацию, способ работы, объекты оперирования и цель. Поэтому требования можно провести от шага в процессе до структуры интерфейса и показать, откуда взялся каждый блок, вместо того чтобы прикрываться догадками и домыслами. Я собрал мини-курс, чтобы этот подход, отточенный до уровня технологии, вы освоили на своей ситуации и принесли в команду. Восемь занятий через день, онлайн; останутся видео, шаблон, практические задания и разборы. Старт ближайшего потока: 17 августа —— Мини-курс по Карте реализации историй

Поговорили с Сергеем Мартюшевым о ИИ и его влиянии на наши роли. 📱 интервью Мои цитаты, отобранные Сергеем: О своем опыте и текущем проекте > «Где-то с апреля, наверное, этого года я глубоко в код агентской разработке. […] когда я увидел, что такое современные агенты, я просто несколько месяцев я просто как ошалелый делал какие-то свои старые идеи». > «Я написал такую метасистему, которая сама выращивает софт». О роли человека (управление ИИ) > "Я, наверное, выделил бы роли, что в целом, наверное, моя главная роль была — погонщик ИИ". О проблеме скрытых решений ИИ > "Самое плохое — это когда те решения, которые он принимает, он тебе их не озвучивает. То, на чём основывался, не сделал частью ни репозитория, ни твоей памяти, ни своей памяти. Это значит, что в следующие сессии какие-то, а они точно будут, если у тебя система, знаешь, там живёт долго. Никто не узнает, почему было принято какое-то решение. Это фейл, просто тотальный!" О разнице скоростей восприятия и контроле > "Они настолько быстро генерят и настолько же быстро изучают новые репозитории которые быстрее человека. Поэтому мы вообще на абсолютно разных масштабах скорости восприятия работаем". > "Я считаю, что нужно контролировать в тех точках, в которых наше восприятие ещё будет поспевать. То есть вычитывать всё там, его нагенерированные штуки нереально. Поэтому где то нужно отпускать контроль". О социальных ролях и принятии ИИ в компаниях > "Абсолютно всегда и сейчас то же самое, есть люди, которые, ну я поп- я просто по-старому буду продолжать. Под ударом идентичность очень сильная". О будущем навыков человека > "Я стараюсь оставлять области, в которых я точно что-то буду думать, делать сам, потому что нужна тренировка, потому что будет утерян навык, если не делать". > "Одна из главных проблем, которая с этим связана - где будет граница, где ты ему отдаёшь творчество? Я это называю это проблема зазора творчества".

Потихоньку в знак благодарности отправляю книгу «Рабочие истории» тем, кто сделал для неё многое. Кто-то читал и делился мыслями о методе или доступности донесения мысли, кто-то написал рецензию, кто-то был всё время со мной в диалоге о её содержании. Большое вам спасибо! Без вас книга и технология вышли бы намного беднее. Если ваша фамилия есть во вступительной части, то книга придёт к вам вскоре.

Заглянуть за кулисы проектирования КПО Сегодня показываю как проектирую инструмент КПО для среды Социотех. Показываю части макета в Фигма, его связь с рабочими историями в Карте реализации историй. Карта реализации историй как раз очень хорошо помогает снять механики работы с инструментом и удерживать их как для всей команды, так и для ИИ-агентов. Ну, и просто хвастаюсь тем, как прикольно получается КПО. Мне нравится. А вы что думаете? Хочется уже попробовать пользоваться таким?

В чате канала в обсуждении мысли не менее интересные, чем в статье. Приходите обсуждать тоже Блиц-нарезка

❦ стала доступна реализация множества идей собственными силами, но если у тебя их много, то это уже не избавление от гнёта нереализованного, а снежный ком из недоделанного

❦ У меня любимый вопрос для ИИ в конце сессии - "Что мы упускаем?"

❦ ... коллеги начали жаловаться и предъявлять мне, что я присылаю какое-то откровенное нейрохрючево ...

Деменция машин, компьют, корова и спецназ, которого нет — как ИИ нас снедает и что с этим делать Продолжаю делиться опытом и живыми переживаниями о проектировании и разработке с код-агентами. Заметка составлена по следам закрытой встречи внутри компании Бындюсофт. В отличие от звучащей из каждой телеграм-колонки песни с блестящими пони победившего повсеместно искусственного интеллекта в моей картине мира не всё так радужно. — Читать заметку

Вот, что про книгу «Рабочие истории» написала Ольга Павлова ещё на этапе чтения черновика. А после получения печатного экземпляра прибавила: «Прекрасное издание, с такой тщательностью сделано! Люблю хорошие вещи». О книге

КРИ уже в Социотех 🎉 Сегодня особенно важный для меня день. Мы выпустили первую версию Карты реализации историй в Социотех. И она уже невероятно крутая. Попробуйте сами https://sociotech.center/

Ментальная гигиена в эпоху ИИ Последние два месяца я не вылезаю из код-агентов. Пишу, проектирую, рисую с ними, смотрю за тем как они пишут код. Хочется поделиться опытом осмысления своего нового ритма жизни и последствий от него. Хочется поделиться тем, что засело и не даёт покоя. Это уже остывшая рефлексия, без охов и вздохов. Но это в конце, а до этого, конечно, было больно, неудобно и отвратительно неприятно. — Читать заметку

КРИ – это как напрямую обмениваться мыслями Бизнес ломается не из-за плохого командного духа или не достаточно амбициозного видения, а потому что каждый внутри компании живёт в своей истории.

Собственник понял одно. Топ-команда — другое. Юристы, логичсты и айтишники — третье. Клиенты вообще пришли со своим сериалом.

И все вроде «договорились». Как в отношениях: оба кивнули, а потом выяснилось, что один планировал свадьбу, а другой просто был вежливым. — А есть ли способ синкануться? У Андрея Шапиро, моего коллеги и единомышленника, вышла новая книга «Рабочие истории. Системное проектирование с Картой реализации историй». Я читал книгу еще на этапе черновика, давал обратную связь и написал рецензию, которую Андрей включил в книгу:

В книге собраны и систематизированы два десятка лет опыта Андрея, поданные в формате историй и схем. После прочтения – и даже во время! – можно переходить к практике записи историй для своего бизнеса, продукта или проекта. Карта реализации историй – следующий качественный шаг, сделанный Андреем в методах проектирования социотехнических систем. Карта появилась очень вовремя: как раз сейчас, в момент высокой неопределённости и глобальной конкуренции, всем нужно уметь проектировать сложные системы, в которые вовлечены люди и машины.

В нашей ИТ-компании через КРИ мы вместе с Андреем строим большие системы, так что для меня это повседневный инструмент. Кроме этого, КРИ я люблю, потому что после Карты гипотез абсолютно логично сделать КРИ, об этом я писал в своей книге. А Андрей в своей пишет, что до КРИ желательно нарисовать стратегию в Карте гипотез. Как вы уже догадались, оба инструмента будут связаны в ближайшее время в Социотехе. — Где почитать? Поздравляю Андрея с выходом книги. Он делает большое дело в сфере проектирования социотехнических систем. Узнать о том, что такое КРИ: https://ashapiro.ru/articles/sim Купить книгу в электронном виде: https://www.litres.ru/book/andrey-anatolevich-s/rabochie-istorii-sistemnoe-proektirovanie-s-kartoy-re-73318228/ В бумаге: https://www.ozon.ru/product/rabochie-istorii-sistemnoe-proektirovanie-s-kartoy-realizatsii-istoriy-andrey-anatolevich-shapiro-4534212227/

Игорь Штанг написал об особенностях макета новой печатной книги. Посмотрите, если вас интересует эстетика в типографике и вёрстке. Издание вышло особенно красивым, благодаря работе Игоря. Обзор книги Игорем — Живой журнал — Medium

Книга «Рабочие истории. Системное проектирование с Картой реализации историй» добралась до Челябинска и сегодня уже уехала на склады OZON. Первая партия появится в продаже через пару дней О книге

Рабство привычки сегодня стоит дорого Человек делает что-то каждый день. То, как он что-то делает, оставляет на нём неизгладимый след, вгрызается в него и закрепляется на нём. То, что философы называли modus operandi, или способ действия, буквально прописывается на человеке и становится его привычкой. Когда мы ходим одним и тем же маршрутом или завариваем любимый напиток одним-двумя излюбленными способами, всё это способы действия, которыми мы «пропитались». Человеку обычно очень трудно целенаправленно сменить привычный приём. Для этого нужно как будто проснуться и увидеть возможность такой смены. В практике жизни я вижу, что большинству начхать на это, им просто хочется продолжать жить как они жили, ничего не меняя. Близкие мне люди, когда я вижу, как они справляются с каким-то действием, и предлагаю альтернативу, почти всегда отказываются от непрошеных идей. С одной стороны, это очень понятно: нужно как-то потакать своему эго. Вот я и отправляюсь с «совет свой себе посоветуй». С другой стороны, я не понимаю, как можно отказываться от новых стратегий выживания. Чтобы проиллюстрировать, насколько глубоко в нас сидят автоматические процедуры, поделюсь самонаблюдением. На участке между домом и офисом есть магазин музыкальной техники. Время от времени я заказываю туда что-то и чаще всего забираю заказы на пути из офиса домой. Дорог туда и обратно множество, и когда я планировал забрать оттуда заказ, я мысленно представлял, как пойду после рабочего дня. Но это всегда было только на обратном пути. Одним утром я увидел в списке дел «зайти за заказом», решил по привычке, что сделаю это вечером на обратном пути, и двинулся в офис. Ураганный ветер сильно скорректировал мой обычный маршрут и я чуть сдвинулся. Каково же было моё удивление, когда я вдруг оказался рядом с тем магазином и сопоставил одно с другим: моё местонахождение и задачу в списке. Удивление моё было вызвано тем, насколько зашоренно я думал с утра. Почему я сразу не увидел альтернативной возможности и не рассмотрел её? А сколько ещё таких вариантов я упускаю? Почему я настолько ведом тем, что прописалось во мне, также как феромоновая дорожка действует на муравья? Не стоит и говорить о том, как глубоко прописалась в моих коллегах привычка «нанимать» привычные средства для решения задач в разработке. Недавно сидел вместе с коллегой, он технологический лидер в компании, очень способный малый. Мы вместе решали задачу новым способом. По окончанию он был ошеломлён разницей в трудозатратах. Новый способ решал задачу за час против двух дней старым способом. На следующий день я услышал на летучке, что он собирается вновь применить старый способ для другой задачи. Я удивился и подошёл к нему побеседовать. Чтобы не удлинять рассказ, скажу итог. Человеку нужно несколько раз самому убедиться в том, что новый способ лучше, а для этого нужно к нему несколько раз вернуться, чему мешает старая привычка. Здесь я передаю привет всем агентам изменений в ИИ-трансформации. ИИ-трансформация почти никогда не упирается только в качество новых инструментов. Она упирается в старые способы действия, которые прочно «гнездятся» на людях и командах. Можно один раз показать, что новый ход быстрее, дешевле и умнее, и всё равно на следующий день люди вернутся к старому.

Так что задача «внедрить ИИ» это только команда «фас». Настоящее дело будет за тем, как помочь команде несколько раз пройти новым путём, пока он не перестанет быть чужим.

Если вы видите, что команда уже попробовала новые ИИ-средства, но продолжает жить по-старому, значит проблема не в инструменте. Значит, нужно менять способ действия.