СТАНДАРТ: Структура проекта

data/
├── sources/           ← внешние источники
│   ├── api/           ← API интеграции
│   ├── files/         ← файлы (CSV, XML, JSON)
│   └── services/      ← внешние сервисы
│
├── storage/           ← хранилища
│   ├── db/            ← базы данных (схемы, миграции)
│   ├── cache/         ← кеш (Redis, Memcached)
│   ├── s3/            ← объектное хранилище
│   └── files/         ← файловое хранилище
│
└── infra/             ← инфраструктура данных
    ├── credentials.md ← доступы (НЕ в git!)
    └── config.yaml    ← конфигурация хранилищ

plan/
├── strategy/          ← стратегия
│   ├── vision.md      ← видение проекта
│   ├── roadmap.md     ← дорожная карта
│   └── okr.md         ← цели и ключевые результаты
│
├── requirements/      ← требования
│   ├── business.md    ← бизнес-требования
│   ├── functional.md  ← функциональные (FR-1, FR-2...)
│   └── technical.md   ← технические (NFR)
│
├── architecture/      ← архитектура
│   ├── system.md      ← системная архитектура
│   ├── data.md        ← архитектура данных
│   └── decisions/     ← архитектурные решения (ADR)
│
├── project/           ← управление проектом
│   ├── team.md        ← команда и роли
│   ├── timeline.md    ← временная шкала
│   ├── budget.md      ← бюджет
│   └── risks.md       ← риски
│
└── backlog/           ← очередь задач
    ├── features.md    ← фичи
    ├── bugs.md        ← баги
    └── tech-debt.md   ← технический долг

build/
├── setup/             ← подготовка окружения
│   ├── env/           ← настройка окружения (dev/staging/prod)
│   ├── tools/         ← инструменты разработки
│   └── dependencies/  ← зависимости
│
├── dev/               ← разработка (ФРАКТАЛЬНЫЕ БЛОКИ)
│   ├── feature-1/     ← блок 1 (микро-проект)
│   │   ├── CLAUDE.md
│   │   ├── planning/
│   │   ├── dev/
│   │   ├── testing/
│   │   └── deploy/
│   ├── feature-2/     ← блок 2
│   └── feature-n/     ← блок N
│
├── testing/           ← тестирование
│   ├── unit/          ← модульные тесты
│   ├── integration/   ← интеграционные тесты
│   ├── e2e/           ← end-to-end тесты
│   └── performance/   ← нагрузочные тесты
│
├── ci-cd/             ← непрерывная интеграция
│   ├── pipeline.yaml  ← конвейер сборки
│   ├── scripts/       ← скрипты автоматизации
│   └── hooks/         ← git hooks
│
└── docs/              ← документация разработки
    ├── api/           ← API документация
    ├── guides/        ← руководства
    └── changelog.md   ← история изменений

ops/
├── deploy/            ← развёртывание
│   ├── staging/       ← тестовая среда
│   ├── production/    ← продакшн
│   └── scripts/       ← скрипты деплоя
│
├── monitor/           ← мониторинг
│   ├── metrics/       ← метрики (Prometheus, Grafana)
│   ├── logs/          ← логирование (ELK, Loki)
│   ├── alerts/        ← алерты
│   └── dashboards/    ← дашборды
│
├── backup/            ← резервное копирование
│   ├── db/            ← бэкапы БД
│   ├── files/         ← бэкапы файлов
│   ├── config/        ← бэкапы конфигов
│   └── scripts/       ← скрипты бэкапа
│
├── security/          ← безопасность
│   ├── ssl/           ← сертификаты
│   ├── firewall/      ← правила firewall
│   └── audit/         ← аудит безопасности
│
└── maint/             ← обслуживание
    ├── cleanup/       ← очистка (логи, кеш, tmp)
    ├── optimization/  ← оптимизация (индексы, кеш)
    └── updates/       ← обновления

project/
├── CLAUDE.md              ← точка входа (контекст проекта)
├── PROJECT.md             ← описание проекта
├── README.md              ← быстрый старт
│
├── data/                  ← 1. ИСТОЧНИКИ ДАННЫХ
│   ├── sources/
│   ├── storage/
│   └── infra/
│
├── plan/                  ← 2. ПРОЕКТИРОВАНИЕ
│   ├── strategy/
│   ├── requirements/
│   ├── architecture/
│   ├── project/
│   └── backlog/
│
├── build/                 ← 3. ПРОИЗВОДСТВО
│   ├── setup/
│   ├── dev/               ← фрактальные блоки
│   ├── testing/
│   ├── ci-cd/
│   └── docs/
│
├── ops/                   ← 4. ЭКСПЛУАТАЦИЯ
│   ├── deploy/
│   ├── monitor/
│   ├── backup/
│   ├── security/
│   └── maint/
│
└── archive/               ← архив (старые версии)

build/dev/feature-name/
├── CLAUDE.md              ← описание блока
├── CACHE.yaml             ← зависимости, входные данные
│
├── planning/              ← планирование блока
│   ├── requirements.md    ← FR-1, FR-2...
│   ├── blocks.md          ← декомпозиция (подблоки)
│   └── criteria.md        ← критерии готовности
│
├── dev/                   ← разработка
│   ├── INSTRUCTIONS.md    ← пошаговые инструкции
│   ├── src/               ← исходный код
│   └── config/            ← конфигурация
│
├── testing/               ← тесты блока
│   ├── unit/
│   └── integration/
│
└── deploy/                ← результаты
    ├── README.md          ← как использовать
    └── artifacts/         ← артефакты (билды)

project/
├── CLAUDE.md
├── data/sources/          ← откуда берём данные
├── plan/
│   ├── roadmap.md         ← что делаем
│   └── backlog/           ← очередь задач
├── build/dev/             ← разработка (1-3 блока)
└── ops/
    ├── deploy/            ← как деплоим
    └── backup/            ← бэкапы

project/
├── CLAUDE.md
├── data/
│   ├── sources/
│   └── storage/           ← добавили хранилища
├── plan/
│   ├── strategy/
│   ├── requirements/      ← добавили требования
│   └── backlog/
├── build/
│   ├── dev/               ← 5-10 блоков
│   ├── testing/           ← добавили тесты
│   └── ci-cd/             ← добавили автоматизацию
└── ops/
    ├── deploy/
    ├── monitor/           ← добавили мониторинг
    └── backup/

project/
├── CLAUDE.md
├── data/                  ← полная структура
├── plan/                  ← полная структура
├── build/                 ← полная структура
└── ops/                   ← полная структура

┌──────────────────────────────────────────────────────┐
│                                                      │
│  DATA → PLAN → BUILD → OPS                          │
│   ↑                            ↓                     │
│   └────────── feedback ────────┘                     │
│                                                      │
└──────────────────────────────────────────────────────┘

1. DATA    — собираем источники данных
2. PLAN    — проектируем что делать
3. BUILD   — создаём продукт
4. OPS     — эксплуатируем
5. Feedback — возвращаемся в PLAN (итерации)

build/dev/
├── frontend/              ← блок фронтенда
├── backend/               ← блок бэкенда
├── api/                   ← блок API
└── admin/                 ← блок админки

build/dev/
├── catalog/               ← каталог товаров
├── cart/                  ← корзина
├── checkout/              ← оформление заказа
├── payments/              ← платежи
└── shipping/              ← доставка

build/dev/
├── core/                  ← ядро платформы
├── modules/               ← модули
│   ├── module-1/
│   └── module-n/
└── connectors/            ← коннекторы
    ├── api-connector-1/
    └── api-connector-n/

plan/
├── strategy/              ← бизнес-стратегия
├── requirements/          ← требования к процессам
└── backlog/               ← задачи

build/dev/
├── process-1/             ← бизнес-процесс 1
└── process-2/             ← бизнес-процесс 2

ops/
├── execute/               ← выполнение процессов
└── monitor/               ← контроль выполнения

mkdir -p data/{sources,storage,infra}
mkdir -p plan/{strategy,requirements,architecture,project,backlog}
mkdir -p build/{setup,dev,testing,ci-cd,docs}
mkdir -p ops/{deploy,monitor,backup,security,maint}

planning/ → plan/strategy/
requirements/ → plan/requirements/
dev/ → build/dev/
deploy/ → ops/deploy/
backup/ → ops/backup/

# 1. Создать минимальную структуру
mkdir -p my-project/{data/sources,plan/backlog,build/dev,ops/{deploy,backup}}

# 2. Создать CLAUDE.md
cat > my-project/CLAUDE.md <<EOF
# ПРОЕКТ: My Project

## Структура

- data/ — источники данных
- plan/ — планирование
- build/ — производство
- ops/ — эксплуатация
EOF

# 3. Создать первый блок
mkdir -p my-project/build/dev/feature-1/{planning,dev,testing,deploy}

# В существующий проект
cd project/build/dev/
cp -r _template/ new-feature/
vim new-feature/CLAUDE.md