Как собрать семантику проекта для кодового агента и не открыть филиал Confluence

[swap2bin]

я недавно выпустил статью про свой опыт в вайбкодинге и я пришел к структуре типа OpenSpec для агента (до этого я не знал про сам OpenSpec) по сути четкая иерархия документации, которую можно описать логикой в самом AGENTS.md указав правила хранения и гаполенения, не мало важно там уделяется внимание "артефактам" по сути то что агент пишет для себя (например аудиты, todo листы, чеклисты безопасности) что имеет свой вес хранения, а также поверхностные доки и важная часть это также наполнение, например я отдельно заставлял его писать внизу дока раздел "верификация" и там отражать дату и последний коммит, что позволяло акутализировать доки.
также в agents.md я прописывал способы решения некоторых проблем как раз через анализ доков и это реально работало