PROJECT_QUICK_START.md

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

1. DATA — Источники данных

data/
├── sources/     ← API, CSV, внешние сервисы
├── storage/     ← БД, S3, кеш
└── infra/       ← доступы, конфигурация

Когда создавать:
- ✅ Сразу при старте проекта
- ✅ Определить все источники данных
- ✅ Настроить хранилища

2. PLAN — Проектирование

plan/
├── strategy/       ← видение, roadmap, OKR
├── requirements/   ← FR-1, FR-2, NFR
├── architecture/   ← система, данные, решения
├── project/        ← команда, timeline, бюджет
└── backlog/        ← фичи, баги, технический долг

Когда создавать:
- ✅ Перед началом разработки
- ✅ Минимум: roadmap + backlog
- ✅ Расширять по мере роста

3. BUILD — Производство

build/
├── setup/       ← окружение, инструменты
├── dev/         ← разработка (фрактальные блоки)
│   ├── block-1/
│   ├── block-2/
│   └── block-n/
├── testing/     ← unit, integration, e2e
├── ci-cd/       ← автоматизация сборки
└── docs/        ← API, guides, changelog

Когда создавать:
- ✅ dev/ — с первого блока
- ✅ testing/ — после первого MVP
- ✅ ci-cd/ — когда нужна автоматизация

4. OPS — Эксплуатация

ops/
├── deploy/      ← staging, production
├── monitor/     ← метрики, логи, алерты
├── backup/      ← БД, файлы, конфиги
├── security/    ← SSL, firewall, аудит
└── maint/       ← cleanup, optimization

Когда создавать:
- ✅ deploy/ — перед первым запуском
- ✅ backup/ — сразу после deploy
- ✅ monitor/ — после стабилизации
- ✅ security/ — для production

Фрактальный блок

build/dev/feature-name/
├── CLAUDE.md           ← описание
├── CACHE.yaml          ← зависимости
├── planning/           ← ЧТО делаем
│   ├── requirements.md
│   ├── blocks.md
│   └── criteria.md
├── dev/                ← КАК делаем
│   ├── INSTRUCTIONS.md
│   └── src/
├── testing/            ← тесты
└── deploy/             ← результат

Минимальный проект (MVP)

mkdir -p my-project/{data/sources,plan/backlog,build/dev,ops/{deploy,backup}}

cat > my-project/CLAUDE.md <<EOF
# ПРОЕКТ: My Project

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

Создание первого блока

cd my-project/build/dev/

mkdir -p feature-1/{planning,dev,testing,deploy}

cat > feature-1/CLAUDE.md <<EOF
# БЛОК: Feature 1

## Назначение
[Описание блока]

## Декомпозиция
- Подблок 1
- Подблок 2

## Критерии готовности
- [ ] Критерий 1
- [ ] Критерий 2
EOF

Типичные проекты

Web приложение

build/dev/
├── frontend/
├── backend/
├── api/
└── admin/

Ecommerce

build/dev/
├── catalog/
├── cart/
├── checkout/
└── payments/

Платформа

build/dev/
├── core/
├── modules/
└── connectors/

Чеклист нового проекта

Минимум (1 час):
- [ ] Создать структуру data/plan/build/ops
- [ ] Написать CLAUDE.md (описание проекта)
- [ ] Создать plan/roadmap.md
- [ ] Создать первый блок в build/dev/
- [ ] Настроить ops/deploy/

Полный (1 день):
- [ ] + Определить все источники данных (data/)
- [ ] + Написать требования (plan/requirements/)
- [ ] + Создать архитектуру (plan/architecture/)
- [ ] + Настроить CI/CD (build/ci-cd/)
- [ ] + Настроить мониторинг (ops/monitor/)
- [ ] + Настроить бэкапы (ops/backup/)

БЫСТРЫЙ СТАРТ: Структура проекта

Четыре раздела проекта