Документация
Документ, который был правдой когда-то, а сейчас неверен, хуже отсутствия документа: по нему кто-нибудь поступит. Что пишется и кем, зависит от уровня.
Что сюда входит
Из чего состоит система и как связаны части, на уровне детальности, который переживёт ближайшие три месяца.
Где работает, как изменение доезжает до production и что делать, когда это ломается в два часа ночи.
Почему выбрано именно это. Та часть, которая всегда теряется и всегда нужна потом.
Что новому разработчику или новому агенту надо знать, прежде чем к чему-то прикасаться.
Кто это пишет
Я читаю документы и комментирую их, объясняю, что в них должно быть, и даю prompt или задание, чтобы их подготовили. Проектную документацию как результат работы я на этом уровне не пишу.
Я требую документацию от команды, ставлю на неё задачу и принимаю результат. Я не пишу её вместо них.
Документация входит в поставку. Код, инфраструктура и важные решения записываются по ходу работы.
Обещать документацию как результат на каждом уровне значило бы продавать то, чего в цене нет.
TechnicalAngel
Опишите идею, текущую стадию и то, что мешает двигаться. Я оценю задачу и предложу подходящий формат участия.
Обсудить проект