Живая документация проекта через VS Code + Codex + Memory Bank

[rsashka]

Удачи вам в использовании подобного подхода (документация ради галочки). Потом напишите, сколько людей будут читать подобную документацию и как сильно она им была полезна.

[SithPasha]

Может агент и сможет это разгребать , но человек вряд ли
Человеку проще использовать свой агент и рыть им по документации по своим запросам соотнося документы и код , потому что если человек полез в документацию ... значит у него есть человеческий вопрос к тому , что может не может ... сделано не сделано в проекте
Как описывает функционал искусственная нейросеть и как нормальная белковая громадная разница
А читать мешанину текста с кучей галлюнов текста ...и анализировать своим надмозгом ... ну такое себе

[vitaliy-trenkenshu]

В статье не описаны минусы данного подхода и границы применения. А они есть. Контекст забивается кучей инструкций про документацию. На каждый запрос тратятся лишние токены.

При этом покументация лежит мёртвым грузом непонятно зачем. Для некоторых проектов это может быть и нужно, но подозреваю, что таких немного.

Для остальных код и сам является документацией. Если есть необходимость что-то узнать можно спросить агента и он посмотрит код и ответит. Тогда когда это нужно. Нет необходимости делать документацию заранее про запас. На все вопросы все равно там ответов не предусмотрите.

Агентам же документация не нужна, они все что нужно для задачи сами в коде найдут. Им нужны короткие правила. Именно короткие, как и для людей (длинные читать никто не будет все равно).

[bquadro]

Тут могу сказать, что при работе не с продуктом, а в web-студии, часто для выполнения задач на проект привлекаются разработчики малознакомые с проектом. Когда проект отягощен большим количеством недокументированного легаси, то подробная документация позволяет быстро провести онбординг на проект и подсказать разработчику, ПОЧЕМУ на этом проекте принято именно такое решение.

Ну а в целом, разработка движется к агентно-ориентированному подходу. И агентам, а не разработчикам, нужна подробная документация как раз для уменьшения контекста, чтобы на стадии постановки задачи ограничить контекст.

И я полностью с вами согласен, что для разработчика код является документацией, но только если этот код можно читать и легко в нем разбираться. Однако реальность нам говорит, что когда проект проходит за несколько лет через несколько команд, там ничего не остается от того замечательного SOLID GRASP KISS DRY и всех остальных аббревиатур которыми нас учат ГУРУ разработки

[vitaliy-trenkenshu]

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