Понять систему

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

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

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

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

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

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

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

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

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

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

Где хрупко

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

Как это идёт

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

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

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

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

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

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

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

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

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

  • Большую часть написали агенты и никто не прочитал это целиком
  • С момента старта люди успели прийти и уйти
  • Вы собираетесь принять решение, которое зависит от устройства системы
  • Систему надо объяснить инвестору, покупателю или новому разработчику

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

  • Продукту две недели и всё в нём сделали вы в этом месяце
  • У вас уже есть актуальное описание архитектуры, которому вы верите
  • Нужно починить ровно одну конкретную ошибку

TechnicalAngel

Какую платформу вы хотите запустить?

Опишите идею, текущую стадию и то, что мешает двигаться. Я оценю задачу и предложу подходящий формат участия.

Обсудить проект