SKELETON.md

Версия: 1.1.0
Дата: 2025-11-25
Статус: Фундамент

НАЗНАЧЕНИЕ

Скелет — это 8 вопросов для описания конкретного проекта.

┌─────────────────────────────────────────────────────────────────────────┐
│                                                                         │
│   SKELETON.md (этот документ)         TAXONOMY.md                      │
│   ───────────────────────────         ───────────                       │
│                                                                         │
│   8 вопросов                          8 срезов                          │
│   для ОПИСАНИЯ                        для КЛАССИФИКАЦИИ                 │
│   конкретного проекта                 типов проектов                   │
│                                                                         │
│   "Расскажи про ЭТОТ проект"          "Какие БЫВАЮТ проекты?"          │
│                                                                         │
│   → project.yaml                      → Каталог типов                  │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘

СКЕЛЕТ = Структура вопросов (не меняется)
МЯСО   = Ответы (разные для каждого проекта)

8 ВОПРОСОВ

┌─────────────────────────────────────────────────────────────────────────┐
│                                                                         │
│   № │ ВОПРОС    │ ЧТО ОПРЕДЕЛЯЕТ           │ СЛОТ СТАНДАРТА            │
│   ──┼───────────┼──────────────────────────┼───────────────────────────│
│   0 │ ЗАЧЕМ?    │ Цель, мотивация          │ OKR / BSC / свой          │
│   1 │ ЧТО?      │ Границы, требования      │ BABOK / User Stories      │
│   2 │ КАК?      │ Метод, процесс           │ Agile / PRINCE2 / Kanban  │
│   3 │ КТО?      │ Роли, команда            │ RACI / ICB / свой         │
│   4 │ ЧЕМ?      │ Технологии, инструменты  │ TOGAF / C4 / свой         │
│   5 │ ГДЕ?      │ Среда, инфраструктура    │ ITIL / DevOps / свой      │
│   6 │ КОГДА?    │ Время, фазы              │ CPM / Milestones / свой   │
│   7 │ СКОЛЬКО?  │ Метрики, KPI             │ ISO 9001 / DORA / свой    │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘

ДЕТАЛЬНОЕ ОПИСАНИЕ

0. ЗАЧЕМ? (Motivation)

motivation:
  goal: "Что хотим достичь"
  value: "Какую ценность создаём"
  driver: "Что заставляет действовать"
  success: "Как поймём что достигли"

Стандарты:
- OKR (Objectives and Key Results)
- Balanced Scorecard
- Impact Mapping

1. ЧТО? (Scope)

Отвечает на: Что входит? Что не входит? Какие требования?

scope:
  in:
    - "Функция A"
    - "Функция B"
  out:
    - "Не делаем C"
  requirements:
    functional:
      - "Система должна..."
    non_functional:
      - "Время ответа < 2с"

Стандарты:
- BABOK (Business Analysis Body of Knowledge)
- IEEE 830 (Requirements Specification)
- User Stories

2. КАК? (Method)

Отвечает на: Каким методом работаем? Какой процесс?

method:
  approach: "agile"           # agile / waterfall / hybrid
  framework: "kanban"         # scrum / kanban / xp
  ai_level: "ai_first"        # manual / ai_assisted / ai_first / ai_only
  practices:
    - "CI/CD"
    - "Code Review"

Стандарты:
- Scrum Guide
- Kanban Method
- PRINCE2
- XP (Extreme Programming)

3. КТО? (Resources)

Отвечает на: Кто участвует? Какие роли? Кто за что отвечает?

resources:
  team_size: "solo"           # solo / small / medium / large
  roles:
    owner:
      name: "Оператор"
      responsibility: "Решения, приёмка"
    executor:
      name: "Claude"
      responsibility: "Разработка, документация"
  external:
    - "API провайдеры"

Стандарты:
- RACI Matrix
- ICB (IPMA Competence Baseline)
- Team Topologies

4. ЧЕМ? (Technology)

Отвечает на: Какой стек? Какая архитектура?

technology:
  stack:
    language: "Python"
    framework: "Streamlit"
    database: "SQLite"
  architecture:
    pattern: "MVC"
    style: "Monolith"
  integrations:
    - "Ozon API"
    - "Почта России API"

Стандарты:
- TOGAF (The Open Group Architecture Framework)
- C4 Model
- ArchiMate

5. ГДЕ? (Infrastructure)

infrastructure:
  environments:
    dev: "localhost"
    prod: "dev-prod-rf"
  hosting:
    type: "VPS"
    provider: "custom"
  deploy:
    method: "systemd"
    automation: "manual"

Стандарты:
- ITIL
- DevOps practices
- SRE (Site Reliability Engineering)

6. КОГДА? (Timeline)

timeline:
  start: "2024-01"
  phases:
    - name: "MVP"
      status: "done"
      date: "2024-06"
    - name: "v1.0"
      status: "in_progress"
      target: "2025-01"
  milestones:
    - "Первый заказ"
    - "100 заказов/день"

7. СКОЛЬКО? (Metrics)

metrics:
  business:
    - name: "Заказов в день"
      target: 100
      current: 50
  technical:
    - name: "Uptime"
      target: "99%"
    - name: "Response time"
      target: "<2s"
  quality:
    - name: "Bug rate"
      target: "<5%"

Стандарты:
- ISO 9001
- SLA (Service Level Agreement)
- DORA metrics

ПРАВИЛА ИСПОЛЬЗОВАНИЯ

1. Все вопросы обязательны

Нельзя пропустить вопрос.
Можно ответить "не определено" или "не применимо".

2. Порядок имеет значение

0 → 1 → 2 → 3 → 4 → 5 → 6 → 7

Сначала ЗАЧЕМ, потом ЧТО, потом КАК...
Нельзя определить КАК, не зная ЗАЧЕМ.

3. Детализация по необходимости

MVP:     Краткие ответы
Проект:  Средняя детализация
Система: Полная детализация

4. Версионирование ответов

Ответы меняются → версия увеличивается.
История изменений сохраняется.

ФОРМАТ ФАЙЛА

# project.yaml

skeleton: "1.0"

0_motivation:
  goal: "..."

1_scope:
  in: [...]
  out: [...]

2_method:
  approach: "..."

3_resources:
  roles: {...}

4_technology:
  stack: {...}

5_infrastructure:
  environments: {...}

6_timeline:
  phases: [...]

7_metrics:
  kpi: [...]

ИСТОРИЯ

Версия	Дата	Изменения
1.0.0	2025-11-25	Первая версия

Статус: Фундамент — структура вопросов не меняется

СКЕЛЕТ: 8 вопросов для описания проекта