Перейти к содержанию
Понять систему

Чем вы вообще владеете?

Продукт, быстро собранный с помощью AI coding agents, почти никогда не описан и часто не понят целиком никем, включая того, кто его напромптил. С этого и начинаем.

Что сюда входит

Дойти до описания, которому можно верить

Опись того, что работает

Сервисы, фоновые задачи, расписания, внешние зависимости и то, что никто не помнит выкатывать.

Описание архитектуры

Как части связаны, где лежат данные, что с чем разговаривает и какие из этих связей несущие.

Как это выкатывается

Где работает, как изменение доезжает до production и что происходит сегодня, когда что-то ломается.

Где хрупко

Части, отказ которых обойдётся дороже всего, названные до отказа, а не после.

Как это идёт

От «я не уверен» до описания на бумаге

  1. Вы рассказываете, что у вас, по-вашему, есть

    Своими словами, включая то, в чём не уверены. Не быть уверенным это нормальная стартовая позиция.

  2. Систему читают, а не угадывают

    Либо я, либо AI-агент по prompt, написанному ровно под это, с требованиями к доказательствам, которые держат его честным.

  3. Вы получаете описание, которое можно кому-то отдать

    Достаточно короткое, чтобы его прочитали, достаточно конкретное, чтобы по нему действовать, и достаточно точное, чтобы с ним спорить.

Когда это стоит делать

Скорее всего, ещё рано, если

Продукту две недели и всё в нём сделали вы в этом месяце

У вас уже есть актуальное описание архитектуры, которому вы верите

Нужно починить ровно одну конкретную ошибку

Стоит делать, если

Большую часть написали агенты и никто не прочитал это целиком

С момента старта люди успели прийти и уйти

Вы собираетесь принять решение, которое зависит от устройства системы

Систему надо объяснить инвестору, покупателю или новому разработчику

Начните с той области, которая беспокоит больше всего

Выберите подходящий уровень участия, опишите продукт, и мы начнём оттуда.