Правила работы со структурой проекта

project/
├── PROJECT.md     ← описание + структура (для человека)
├── CLAUDE.md      ← контекст для AI
└── index.yaml     ← конфигурация структуры (для Claude)

project/
└── INDEX.md       ← если проект большой, нужна навигация

1. Прочитать PROJECT.md (секция "Структура")
2. Прочитать index.yaml (structure)
3. Проверить нет ли уже такого файла
4. Если файл в structure.required → создать
5. Если файл в structure.optional → проверить create_when
6. Если условие не выполнено → НЕ создавать

1. Проверить index.yaml → structure.directories
2. Найти папку в конфигурации
3. Проверить create_when условие
4. Если условие выполнено:
   - Создать папку
   - Создать required_files внутри
   - Создать structure (подпапки) если указано
5. Если условие НЕ выполнено → НЕ создавать

data/
├── sources/       ← входящие от клиента (мастер-файл, прайсы, ТЗ)
├── processed/     ← обработанные данные
└── exports/       ← экспорты для внешних систем

archive/
├── drafts/              ← черновики, рабочие файлы
│   ├── BUSINESS.draft.md
│   └── analysis.md
│
└── YYYY-MM-DD_topic/    ← старые версии проекта
    └── old_structure/   ← при реформации

biz/
├── CLAUDE.md      ← обязательно!
├── sales/         ← продажи, CRM
├── ops/           ← операции, процессы
└── warehouse/     ← склад

fin/
├── CLAUDE.md      ← обязательно!
├── accounting/    ← бухгалтерия, 1С
├── tax/           ← налоги
└── reporting/     ← отчётность

it/
├── CLAUDE.md      ← обязательно!
├── CACHE.yaml     ← обязательно!
├── data/          ← источники данных IT
├── plan/          ← планирование IT задач
├── web/           ← веб-сайты (DIRECTION)
├── mob/           ← мобильные (DIRECTION)
└── api/           ← API (DIRECTION)

# Создать минимум (3 файла)
mkdir project-name
cd project-name

# Скопировать шаблоны
cp ../architect/templates/PROJECT_WITH_STRUCTURE.md PROJECT.md
cp ../architect/templates/project.index.yaml index.yaml
cp ../architect/templates/CLAUDE_TEMPLATE.md CLAUDE.md

# Заполнить шаблоны (заменить {placeholders})
vim PROJECT.md   # заменить {название}, {описание}
vim index.yaml   # заменить {project-name}
vim CLAUDE.md    # добавить контекст

# Готово! Папки создадим когда появится необходимость

# Появились файлы от клиента
mkdir -p data/sources
cp мастерфайл.md data/sources/

# Обновить index.yaml (отметить что data/ создана)

# Начали работу
mkdir -p archive/drafts

# Claude создаёт черновики
echo "..." > archive/drafts/BUSINESS.draft.md

# Утвердили → копируем в корень
cp archive/drafts/BUSINESS.draft.md BUSINESS.md

# Очистка (опционально)
rm -rf archive/drafts/

# Появилось IT-направление
mkdir -p it
cp ../architect/templates/CLAUDE_TEMPLATE.md it/CLAUDE.md
echo "type: TYPE\nname: it" > it/CACHE.yaml

# Обновить index.yaml

lideravto/
├── PROJECT.md     ← описание + структура
├── CLAUDE.md      ← контекст
└── index.yaml     ← конфигурация

lideravto/
├── PROJECT.md
├── CLAUDE.md
├── index.yaml
└── data/          ← добавилось
    └── sources/
        └── мастерфайл.md

lideravto/
├── PROJECT.md
├── CLAUDE.md
├── index.yaml
├── data/
└── it/            ← добавилось
    ├── CLAUDE.md
    ├── CACHE.yaml
    └── web/
        └── cscart/

lideravto/
├── PROJECT.md
├── CLAUDE.md
├── index.yaml
├── BUSINESS.md    ← для ORG
├── data/
├── archive/
│   └── drafts/
├── biz/
│   └── CLAUDE.md
├── fin/
│   └── CLAUDE.md
└── it/
    ├── CLAUDE.md
    ├── CACHE.yaml
    └── web/

# Проверить нет ли пустых папок
find . -type d -empty

# Проверить структуру
cat index.yaml | grep create_when

# Проверить обязательные файлы
test -f PROJECT.md && test -f CLAUDE.md && test -f index.yaml