Жизненный цикл проекта

ИНИЦИАЦИЯ → ИССЛЕДОВАНИЕ → ПРОЕКТИРОВАНИЕ → ИСПОЛНЕНИЕ → ЭКСПЛУАТАЦИЯ

Измерение 1: ТИП СИСТЕМЫ (что делает) — cms / api / bot / etl / dashboard
Измерение 2: СТЕК (на чём построено)  — drupal / fastapi / nextjs / python

arch-project-lifecycle.md          ← базовый ЖЦ (этот документ)
  → arch-project-it-structure.md   ← IT специфика
    → projector/templates/@it/stacks/{стек}/   ← шаблоны стека
    → coder/library/{стек}/                    ← код стека

Шаг 1: Определить тип и место (типология, родитель, имя @{тип}-{имя}/)
Шаг 2: Скопировать шаблон из projector/templates/@{тип}/
Шаг 3: Создать структуру (INDEX.md, AI.md, CLAUDE.md, STATUS.md, LOG.md)
Шаг 4: Заполнить frontmatter AI.md (type, name, description, status: IDEA)
Шаг 5: Глоссарий — изучить тему, предложить термины, если >3 → GLOSSARY.md
Шаг 6: Обновить родителя (INDEX.md родителя + запись в LOG.md)

Разведка (L0): читаем все .md, строим карту
  ↓
Карта документов → показываем оператору
  ↓
Утверждение списка ← ОПЕРАТОР
  ↓
По каждому документу:
  Читаем → предлагаем объединение → ОПЕРАТОР ✓ → записываем
  ↓
Всё остальное → arh/ ← ОПЕРАТОР ✓
  ↓
Битые ссылки → fix → git commit

ZERO         VANILLA           WORKING          PRODUCTION
─────────    ──────────────    ─────────────    ─────────────
Установлено  Голый дистрибутив Версии с кодом   Релиз в проде
НЕ работает  v0.0.0            v0.1.0+          v1.0.0+
БД нет       БД есть           Custom модули    Стабильно

НИЧЕГО → Zero → Vanilla (v0.0.0) → Working (v0.1.0+) → Production (v1.0.0+)

Получение → Анализ → Развёртывание → Онбординг (v1.0.0) → Working (v1.1.0+)

[YYYY-MM-DD HH:MM] ДЕЙСТВИЕ: описание
  Параметр: значение
  ✓ Результат
  → Статус

git commit -m "feat(scope): описание"
git tag v0.x.x   # после каждого значимого состояния

ПРОЕКТ = МОДУЛЬ = БЛОК = ПОКОЛЕНИЕ

Одна и та же структура на всех уровнях:
  CLAUDE.md + CACHE.yaml + planning/ + dev/ + testing/ + deploy/

ПРОЕКТ
  dev/
    МОДУЛЬ (микро-проект)
      dev/
        БЛОК (микро2-проект)
          dev/
            ПОКОЛЕНИЕ (микро3-проект)

микро-проект/
├── CLAUDE.md          -- описание, метаданные, интерфейс
├── CACHE.yaml         -- входные данные, зависимости
│
├── planning/          -- планирование
│   ├── requirements.md   -- требования
│   ├── blocks.md         -- декомпозиция на под-блоки
│   └── criteria.md       -- критерии готовности
│
├── dev/               -- разработка
│   ├── [под-блоки]       -- рекурсия (микро-проекты)
│   └── [код]             -- или финальный код (атом)
│
├── testing/           -- тесты
│   ├── unit/
│   ├── integration/
│   └── criteria.md       -- результаты тестов
│
└── deploy/            -- результат (финальная сборка)
    ├── dist/             -- собранный продукт
    └── README.md         -- как использовать

1. ПРОЕКТ → определить стадии, для dev/ — определить модули
2. МОДУЛЬ → CLAUDE.md, CACHE.yaml, planning/
3. БЛОК   → декомпозировать на ПОКОЛЕНИЯ
4. ПОКОЛЕНИЕ (АТОМ) → planning/ + dev/ (код, влезает в контекст)

# CLAUDE.md — интерфейс уровня
block:
  name: "..."
  type: CODE|DOCS|OPS
  inputs: [...]   # что требует
  outputs: [...]  # что производит

# CACHE.yaml — входные данные
dependencies: [...]
inputs: {...}
resolved: {...}

НАЧАТЬ С САМОГО ГЛУБОКОГО УРОВНЯ (атом):

Уровень N (атомарный):
  1. Загрузить контекст CLAUDE.md
  2. dev/ — реализовать код
  3. testing/ — написать и запустить тесты
  4. FAILED → вернуться к dev/
  5. PASSED → deploy/ собрать результат

Уровень N-1 (использует результаты N):
  1. CACHE.yaml → resolved += deploy/ уровня N
  2. dev/ — интегрировать под-блоки
  3. testing/ — тесты интеграции
  4. PASSED → deploy/ собрать результат

Продолжать до КОРНЯ (проект).

ДЛЯ КАЖДОГО УРОВНЯ (снизу вверх):
1. СБОРКА deploy/ — собрать результаты под-уровней
2. ТЕСТИРОВАНИЕ — unit/ + integration/ + criteria.md
3. ВАЛИДАЦИЯ — все тесты PASSED? критерии выполнены?
4. ФИКСАЦИЯ — обновить CLAUDE.md (status: completed)
5. ПОДЪЁМ НА УРОВЕНЬ ВЫШЕ

БИЗНЕС планирует ЧТО → IT реализует КАК

BIZ пишет REQUIREMENTS.md
    | ГРАНИЦА 1: BIZ → IT
IT получает требования → пишет DESIGN.md
    | ГРАНИЦА 2: IT → Кодер
Кодер получает DESIGN.md + GUIDE.md → пишет код

# REQUIREMENTS

## Функциональные
- [ ] Требование 1

## Контентные
- [ ] Тексты для категорий

## Технические ограничения
- Скорость < 2 сек
- Uptime > 99%

# DESIGN

## Входящие требования
[REQUIREMENTS.md](../@biz-.../REQUIREMENTS.md)

## Платформа
{платформа, версия}

## Модули
| Модуль | Назначение | Зависимости |
|--------|-----------|-------------|

# Модуль: {название}

## Контекст
[ссылки на REQUIREMENTS и DESIGN]

## Задача
{что создать}

## Требования
{детальный список с алгоритмами}

## Структура кода
{файлы и что в каждом}

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

1. ПЕРЕД изменением — backup (контрольная точка)
2. ДЕЛАТЬ изменение — одно за раз
3. ЕСЛИ сломалось — СТОП! Откат
4. НИКОГДА не менять ядро CMS

НЕПРАВИЛЬНО:
1. Установить 5 модулей → 2. Изменить конфиг → 3. Деплой → 4. Проверить всё

ПРАВИЛЬНО:
1. Установить модуль 1 → проверка → git commit
2. Установить модуль 2 → проверка → git commit
3. Изменить конфиг → проверка → git commit

1. READ:   cat конфиг > backup.conf
2. MODIFY: vim конфиг (локально)
3. TEST:   nginx -t (проверка синтаксиса)
4. WRITE:  загрузить на сервер
5. CHECK:  nginx -t && service nginx reload
6. VERIFY: curl http://site.ru

1. READ:   mysqldump db > backup.sql
2. MODIFY: создать миграцию
3. TEST:   проверить на локальной копии БД
4. WRITE:  применить миграцию на prod
5. CHECK:  проверить результат
6. VERIFY: проверить работу сайта