my_architect — это визуальный инструмент архитектуры: WBS, User Story Mapping, C4 и UML живут на одном холсте React Flow, а рядом работает собственный MCP-сервер, через который агент читает и меняет иерархию проекта, требования и документы. Раздел «Инженерные заметки» — это место, где мы разбираем, как устроен инструмент изнутри и какие инженерные решения за ним стоят. Не пресс-релизы и не обзоры фич, а честные разборы конкретных задач: что было больно, какую гипотезу проверяли, что в итоге сработало, а что оказалось популизмом.
Главная особенность проекта в том, что он ведёт сам себя. Каждая фича my_architect сначала заводится как узел в его же иерархии, обрастает требованиями и документом-источником-правды, а потом реализуется — тем же агентом, через тот же MCP. Это dog-fooding в чистом виде: инструмент проходит через собственный пайплайн раньше, чем его увидит пользователь. Поэтому наши заметки — не абстрактные рассуждения об «AI-агентах вообще», а телеметрия реальных прогонов, номера релизов, пойманные до продакшена баги и цифры, которые мы измеряли на собственном репозитории, а не переписывали из чужого маркетинга.
Читателю, который в целом понимает проблемы LLM-агентов, но не сидел внутри наших задач, здесь стоит ждать историй с началом и концом. Мы стараемся явно отделять измеренные факты от оценок и ничего не додумывать — если чего-то не проверяли, так и пишем. Это заметки практиков для практиков, а не витрина.
Как в my_architect устроен рабочий контур агента: get_next_task, start_task, complete_task, статусный каскад по иерархии, гейт блокеров и доки как живой источник правды.
Как мы дали агенту my_architect персистентную память о репозитории через локальный код-граф — и заложили дисциплину, запрещающую верить устаревшему индексу.