---
title: "ADSM: каталоги верхнего уровня"
description: "Мой персональный подход к базовой организации файловой структуры проектов в соответствии с методологией ADSM."
date: 2025-11-22
display_date: "22 ноября 2025"
image: "/img/blog/2025/20251122-01-adsm-top-level-directories.png"
image_alt: "ADSM: каталоги верхнего уровня"
---

# ADSM: каталоги верхнего уровня

<zoom-img src="/img/blog/2025/20251122-01-adsm-top-level-directories.png" alt="ADSM: каталоги верхнего уровня"
        width="100px"></zoom-img>

*Мотивация к появлению подхода AFKP изложена в статье "[Когда знаний в избытке](https://habr.com/ru/articles/963910/)". Этот фрагмент соответствует стадии 2 AFKP (резонанс). На Хабре опубликован [другой вариант](https://habr.com/ru/articles/967452/) первых двух стадий AFKP - зацепления и резонанса. Это более компактная версия текста для стадии резонанса.*

В ADSM я разделяю проект на две большие области: код и документацию. Код зависит от выбранного ЯП, а
        документацию я далее делю на три зоны:

- **agent** - зона для общения с агентами, где фиксируются отчёты и шаблоны промптов;

- **product** - бизнес-описание продукта, задающее скелет будущего приложения и формирующее поле
            действий агента;

- **rules** - набор регламентов, описывающих, как именно должен создаваться программный продукт
            на выбранном языке.

Эта структура каталогов отражает мой опыт работы с LLM-агентами и построена так, чтобы документация и код
        существовали как единое пространство, учитывающее языковую природу моделей и их статистические ограничения. Она
        помогает удерживать фокус агента и направлять его работу в нужные рамки.

[Читать полный текст (3-я стадия по AFKP - погружение) .](/ru/library/adsm/20251122-01-adsm-top-level-dirs.html)