Архив рубрики ‘документация’

Аналитик и ИИ: три инструмента, которые превращают хаос в требования

Мы работаем на крупном проекте, где присутствует десятки интеграций, сотни бизнес-сценариев, документация в Confluence, а теперь ещё и описания бизнес-сценариев с помощью ИИ прямо в репозиториях. Это здорово выручает для погружения в проект, но всё равно не покрывает всю картину при работе над конкретной доработкой. Поэтому в команде аналитиков мы начали заводить собственных ИИ-агентов: собираем […]

Фронтенд и бэкенд работают отдельно. Как я связал их задачи через OpenSpec

Организация AI-разработки, в которой каждый разработчик работает в своей зоне, а следующая задача может использовать решения, принятые на другой стороне. Бэкенд-разработчики закончили несколько задач и влили их в develop. Фронтендер берётся за связанную часть функциональности и открывает новую сессию агента. Знакомый запрос: «Для синхронизации посмотри вот эти коммиты, потом вот это дополнение и ещё этот […]

В вайбкодинге агент почти не читает документацию без ссылки: 57 файлов из 88 он не открыл ни разу

Граф кода как источник «говорящих» диаграмм и контекста

Документация. Само это слово стало синонимом нерешаемой проблемы. Цитата одного менеджера: “Разработчики держат знание на кончиках пальцев”. Цитата меня: “Одних нужно заставлять писать, других нужно заставлять читать, третьих нужно заставлять заставлять”. Итоговое соотношение цена/скорость/качество это то, о чём не принято говорить вслух. ИИ пока не спасает ситуацию. На больших кодовых базах он ожидаемо упускает контекст […]

Как мы показываем клиентам документацию по проекту из приватного репозитория, не пуская их в репозиторий

Сразу дисклеймер: это рассказ про инструмент, который мы написали для себя и используем каждый день. Ссылку дам в конце, продавать не буду — расскажу про проблему и как её решали, потому что упираемся в неё, возможно, не только мы.

Handoff-driven development

Улучшенный Spec-driven-dev. Это SDD + handoff’ы — передний край лучших мировых практик как для соло-разработки, так и для небольших команд. Это не история про рой агентов, которые в абстрактном цикле «план → код → ревью → тесты → деплой» самостоятельно везут продукт, синхронизируясь друг с другом через воркфлоу. У нас нет личного датацентра или полумиллиона […]

«Боргворглер: боргает ворглер», или как сделать действительно полезную документацию к проекту

Обсуждения неудачных примеров README-файлов и документации — одна из популярных тем на профильных площадках и форумах [вкупе с другими «вечнозелеными» спорами в ИТ]. Сегодня мы в Beeline Cloud решили посмотреть, что думают о проблеме плохой документации разработчики и ученые, может ли ИИ улучшить ситуацию, что такое «нейросетевой ридмитит» — и как можно «доработать напильником» сгенерированные […]

Когда онбординг длится 2 месяца: день 3 — проследить главный поток данных

Вступление Рано или поздно сложную систему приходится объяснять человеку со стороны: новому разработчику, техлиду, архитектору или ревьюеру. И тут часто начинается боль: репозитории уже показали, основные сущности вроде бы объяснили, но всё ещё непонятно, как данные проходят через систему. В этой части я покажу, как сделать первое погружение в код наменее болезненным: выбрать один главный […]

Без документации ИИ далеко не уедет: мои грабли на проекте

Это продолжение статьи «ИИ может писать код, но умеет ли он делать красиво? Мой опыт с виджетом и аватарами». На этой неделе я побывал в телеграм-клубе AI Practiq, где ребята собираются, обсуждают вайбкодинг, делятся опытом и практиками. Один из участников рассказывал о своём опыте и выделил четыре важных аспекта качественной разработки с ИИ. Один из них […]

Когда онбординг длится 2 месяца: день 2 — карта репозиториев

Итак, ваш первый день в офисе, вам дали доступы ко всем 15 репозиториям проекта, рассказали где что лежит, и теперь ждут от вас великих дел. Они и не подозревают, что вы уже забыли, какой карточкой открывается этаж и где стоит кофемашина. Добро пожаловать в 50% IT-компаний вторую статью цикла про онбординг в сложную систему! В […]

123.5