BA / SA Materials

Мы перешли на API-first, и это не помогло

Автор: Никита Миронов
Главная мысль: границы контрактов нужно явно фиксировать в самих контрактах.

О чём:
- В контракте указали integer, но не определили минимальное и максимальное значения.
- По спецификации сгенерировали код: в Go получилось int64, в iOS — int64, в Android — int32.
- Позже понадобилось добавить к значению префикс. В Android новое значение уже перестало помещаться в выбранный тип.
- Ещё была часть про форматно-логический контроль.
- Было много мемов. Мемы понравились.
- Нашел его сайт: https://analystexe.ru/

155 0 2 1

BA / SA Materials

14 Aug, 01:28

Архитектурные решения и компромиссы — почему мы всё время делаем систему хуже

Автор: Андрей Бураков
Главная мысль: придумайте несколько вариантов решения, сравните их плюсы и минусы и отдельно подумайте не только о том, что каждый вариант улучшает, но и о том, что он ухудшает.

О чём:
- У каждого решения есть плюсы и минусы. Поэтому практически любое изменение в чём-то делает систему лучше, а в чём-то хуже.
- Идеальное, но несуществующее решение - система, которой вообще нет, но которая при этом выполняет бизнес-задачу.
- Предлагаемый подход: определяем важные характеристики первого пришедшего в голову решения → приоритизируем их → добавляем вариант «оставить как есть» → генерируем альтернативы → сравниваем варианты → выбираем наиболее подходящий → документируем принятое решение.
- Если решение ничего не ухудшает, скорее всего, вы ещё не нашли его минусы. Если вариант решения только один, стоит придумать ещё.
- По возможности характеристики решений стоит выражать количественно.
- Доклад очень понравился, хот

116 0 1 1

BA / SA Materials

14 Aug, 01:27

Spec Driven Development для системного аналитика: как превратить неполные вводные в проверяемую API-спецификацию

Автор: Виктория Золотарёва
Главная мысль: ИИ помог одновременно ускорить разработку требований и повысить их качество.

О чём:
- Рассказ о том, как в команде использовали ИИ для улучшения качества документации.
- Аналитик с помощью ИИ пишет спецификацию в GitLab. В качестве контекста ИИ получает стайл-гайды в .md-файлах и документацию проекта. Спецификация хранится в отдельной ветке.
- На основе спецификации генерируется документация в Confluence, а разработчик пишет код. Затем изменения аналитика и разработчика объединяются.
- Использовали Cursor, а не локальные модели. Применение сторонних моделей для проекта предварительно согласовали с ИБ.
- По словам автора, скорость работы выросла, команда результатом довольна. Интересно, что сама инициатива изначально пришла от бэкенд-разработчика.
- Подробнее: https://habr.com/ru/companies/alfa/articles/1059296/

87 0 3 2

BA / SA Materials

14 Aug, 01:24

Как системному аналитику не спроектировать утечку данных в API

Автор: Елизавета Акманова
Главная мысль: Продумывайте риски и не бойтесь отказываться от решений, которые могут породить много проблем в будущем.

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

85 0 1 2 1

BA / SA Materials

14 Aug, 01:23

Сегодня посетил митап Т1 x ГК «Юзтех»: «Системный анализ»
https://pro.t1.ru/event/JCPCjAwF?code=CFNUDP

Общие впечатления:
- Офлайн посещать подобные мероприятия куда интереснее, чем сидеть и слушать очередной онлайн-митап.
- Бесплатные еда и вода. Такое любим, такое уважаем. Ещё выдавали подарки за интересные вопросы.
- Узнал не так много нового, но сходить определённо стоило.
- Времени на общение было не очень много, но кое-что успели пообсуждать.
- Если приглашают на мероприятия по адресу Москва, м. Динамо, Ленинградский пр-т, 36, стр. 41 (БЦ «Арена», 23-й этаж), советую сходить. Лекционный зал там довольно красивый.

Выжимка из докладов:

97 0 3 2 3

BA / SA Materials

28 Jul, 12:37

Some showcases of how requirements look

143 0 4

BA / SA Materials

28 Jul, 12:33

You might ask: who cares? Where are the results of that system prompt usage? Here they are
https://github.com/arlagonix/todo-app-generated-requirements

Model used for generation: deepseek-v4-flash (it's free, the endpoint is https://opencode.ai/zen/v1)
Harness: Molten Forge

GitHub - arlagonix/todo-app-generated-requirements

Contribute to arlagonix/todo-app-generated-requirements development by creating an account on GitHub.

130 0 1 2

BA / SA Materials

28 Jul, 12:26

system_prompt.md

8.7Кб

121 0 3

BA / SA Materials

28 Jul, 12:26

Although that's only half of the story. That video inspired me to create with help of AI a system prompt for systems analysis that might help to write in this style. I like concise and easy to understand language in requirements

Here's the system prompt:

111 0 1

BA / SA Materials

28 Jul, 12:24

80 0 2

BA / SA Materials

28 Jul, 12:23

THE CURE FOR AI SLOP IS A 1986 AIRCRAFT MANUAL

Source: https://www.youtube.com/watch?v=uJblcC4lKY
Complexity: ★★☆

Table of contents:
├─ What AI slop is and why banned-word lists do not solve it
├─ How Simplified Technical English reduces ambiguity
├─ STE rules that improve AI-generated technical writing
├─ Experiment: banned words, Orwell’s rules, and STE
├─ Where STE works well and where it does not
├─ What viewers thought about the method and the video
└─ STE-inspired writing skill for technical documentation

My description:
├─ Some guy that got in my YouTube recommendations advised to use Simplified Technical English recommendations for writing technical documentation.
├─ So I thought: damn, that looks nice. Even downloaded the initial manual, but it's too large and too specific for aircraft domain.
└─ Nevertheless, there is some pretty nice advice that might be applicable to systems analysis

Auto description:
├─ The video explains how ASD-STE100 Simplified Technical English can reduce common forms of AI-generated “slop.”
└─ It compares this method with banned-word lists and Orwell’s writing rules, then shows where STE works well and where it cannot improve weak ideas or factual errors.

The cure for AI slop is a 1986 aircraft manual | BA/SA Materials

Source//www.youtube.com/watch?v=uJblcC4lKYw

94 0 2