Comments 2
Прикольно. Я тоже пришёл к похожему подходу. При том что я не программист и работаю один.
Просто, меня бесило что в новых сессиях агент не знает что было в прошлых. Открытые знания и притяные решения просто оставались в прошлых сессиях. Обычной автоматической внутренней памяти агента мне не хватало. И не хватало общих правил, чтобы агент всегда придерживался правилных принципов. Начинал я с claude.md. Но если записывать всё в один claude.md, его раздувает. И это плохое место для знаний по проекту. Вот, вместе с клодом мы выработали папку ai_docs, с похожей структурой внутри. CLAUDE.md и AGENTS.md это чисто точки входа. Дальше агент идёт в START.md. А оттуда уже читает нужные ему файлы, в зависимости от контекста. Ещё сделали отдельную папку ai_docs_method, где подробно описана сама методология ведения ai-доков.
Про документацию. Правильный подход это SDD, например OpenSpec
Если ваши разработчики используют Claude Code, вы еще не автоматизировали разработку