Версия: 1.0.0
Дата: 2025-12-22
Уровень: L2 (Стандарт)
Полный справочник всех возможных сущностей в платформе:
- 5 уровней иерархии
- 6 типов систем
- Все возможные комбинации
- Полный состав каждой сущности
| Уровень ↓ / Тип → | Целевая (9) | Обеспечивающая (7) | Информационная (5) | Процесс (8) | Структура (4) | Агент (6) |
|---|---|---|---|---|---|---|
| L0: WORKSPACE | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ |
| L1: БИЗНЕС | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ |
| L2: НАПРАВЛЕНИЕ | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ |
| L3: МОДУЛЬ | ✅ | ✅ | ✅ | ❌ | ❌ | ✅ |
| L4: ЗАДАЧА | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ |
Характеристика: Описывает устройство без поведения
Состав:
$WORKSPACE/
├── architect/ ← Методология (Информационная)
├── system/ ← Платформа (Обеспечивающая)
├── infra/ ← Инфраструктура (Обеспечивающая)
└── projects/ ← Бизнес-проекты (Целевые)
Свойства:
- Владелец (owner)
- Путь ($WORKSPACE)
- Hub путь (S3/NAS)
Метаданные: Нет стандартных файлов
Характеристика: Решает проблему клиента, создаёт ценность
Примеры:
- Торговля (pirotehnika, lideravto)
- SaaS продукт (content-factory)
- Услуги (seller1)
Состав:
{business}/
├── [ОБЯЗАТЕЛЬНЫЕ]
│ ├── CLAUDE.md
│ ├── index.yaml
│ └── PROJECT.md ← 9 вопросов
│
├── [ПРОЕКТИРОВАНИЕ]
│ └── design/
│ ├── STRATEGY.md ← Бизнес-стратегия
│ ├── BUSINESS_MODEL.md ← Бизнес-модель
│ ├── MARKET.md ← Анализ рынка
│ ├── COMPETITORS.md ← Конкуренты
│ └── SWOT.md ← SWOT-анализ
│
├── [УПРАВЛЕНИЕ]
│ └── management/
│ ├── STATUS.md ← Текущий статус
│ ├── ROADMAP.md ← Дорожная карта
│ ├── METRICS.md ← KPI
│ ├── BUDGET.md ← Бюджет
│ ├── TODO.md ← Задачи
│ └── RISKS.md ← Риски
│
├── [ДАННЫЕ]
│ └── _shared/
│ ├── data/ ← Каталоги, справочники
│ ├── docs/ ← Документы
│ ├── assets/ ← Медиа
│ └── work/ ← Рабочие файлы
│
├── [НАПРАВЛЕНИЯ]
│ ├── {direction-1}/ ← Целевые
│ ├── {direction-2}/
│ └── {direction-N}/
│
└── [СЕРВИСЫ]
└── services/
├── @{service-1}/ ← Обеспечивающие
└── @{service-2}/
Свойства index.yaml:
name: "Название бизнеса"
type: business
status: active
owner: "Владелец"
# 9 вопросов (в PROJECT.md)
problem: "..." # ПОЧЕМУ
goal: "..." # ЗАЧЕМ
result: "..." # ЧТО
stakeholders: [...] # КТО
method: "..." # КАК
resources: [...] # ЧЕМ
context: "..." # ГДЕ
timeline: "..." # КОГДА
metrics: {...} # СКОЛЬКО
# Структура
directions:
main: "retail"
list: [...]
services: [...]
# Связи
depends_on: [...]
hub: "projects/{name}/"
Вопросы (9):
1. ПОЧЕМУ? — Какую проблему решаем
2. ЗАЧЕМ? — Цель, миссия
3. ЧТО? — Продукт, результат
4. КТО? — Клиенты, команда, партнёры
5. КАК? — Бизнес-модель, процессы
6. ЧЕМ? — Ресурсы, технологии
7. ГДЕ? — Рынок, регион, контекст
8. КОГДА? — Сроки, этапы, roadmap
9. СКОЛЬКО? — Метрики, KPI, финансы
Характеристика: Поддерживает работу других бизнесов/систем
Примеры:
- Инфраструктура (infra)
- Платформа (system)
- Хостинг-бизнес
Состав:
{business}/
├── [ОБЯЗАТЕЛЬНЫЕ]
│ ├── CLAUDE.md
│ ├── index.yaml
│ └── PROJECT.md ← 7 вопросов
│
├── [ПРОЕКТИРОВАНИЕ]
│ └── design/
│ ├── PRINCIPLES.md ← Принципы (вместо ПОЧЕМУ)
│ ├── MISSION.md ← Миссия (вместо ЗАЧЕМ)
│ ├── ARCHITECTURE.md ← Архитектура
│ ├── SERVICES.md ← Сервисы
│ └── SLA.md ← Service Level Agreement
│
├── [УПРАВЛЕНИЕ]
│ └── management/
│ ├── STATUS.md
│ ├── CAPACITY.md ← Мощности
│ ├── INCIDENTS.md ← Инциденты
│ └── METRICS.md ← Метрики (uptime, latency)
│
├── [ДАННЫЕ]
│ └── _shared/
│ ├── configs/ ← Конфигурации
│ ├── inventory/ ← Инвентарь ресурсов
│ └── logs/ ← Логи
│
└── [МОДУЛИ]
├── @{server-1}/
├── @{server-2}/
└── @{service-N}/
Свойства index.yaml:
name: "Инфраструктура"
type: infrastructure # или platform
status: active
# 7 вопросов (в PROJECT.md)
principles: "..." # Принципы (не проблема)
mission: "..." # Миссия (не цель)
services: [...] # ЧТО предоставляет
users: [...] # КТО использует
how: "..." # КАК работает
resources: [...] # ЧЕМ обеспечено
where: "..." # ГДЕ размещено
# НЕТ: КОГДА (работает 24/7)
metrics:
uptime: 0.99
capacity: "..."
# Клиенты (кого обслуживает)
serves:
- "pirotehnika"
- "lideravto"
Вопросы (7):
1. ПРИНЦИПЫ — Основополагающие идеи (вместо ПОЧЕМУ)
2. МИССИЯ — Предназначение (вместо ЗАЧЕМ)
3. ЧТО? — Какие сервисы предоставляет
4. КТО? — Кто использует
5. КАК? — Как работает
6. ЧЕМ? — Ресурсы, технологии
7. ГДЕ? — Размещение, топология
НЕТ: КОГДА (работает постоянно), СКОЛЬКО (метрики технические, не бизнес)
Характеристика: Хранит и передаёт знания
Примеры:
- Методология (architect)
- База знаний
- Документация проекта
Состав:
{knowledge-base}/
├── [ОБЯЗАТЕЛЬНЫЕ]
│ ├── CLAUDE.md
│ ├── index.yaml
│ └── INDEX.md ← Навигация (вместо PROJECT.md)
│
├── [СОДЕРЖАНИЕ]
│ ├── theory/ ← Теория
│ ├── concept/ ← Концепции
│ ├── standards/ ← Стандарты
│ ├── patterns/ ← Паттерны
│ └── templates/ ← Шаблоны
│
├── [УПРАВЛЕНИЕ]
│ └── management/
│ ├── STATUS.md ← Статус наполнения
│ ├── TODO.md ← План развития
│ └── CHANGELOG.md ← История изменений
│
└── [МЕТАДАННЫЕ]
└── operations/
├── DIAGNOSTICS.md ← Диагностика
└── COMMANDS.md ← Команды
Свойства index.yaml:
name: "Architect"
type: knowledge # или documentation
status: active
# 5 вопросов
content: "..." # ЧТО содержит
format: "Markdown" # ЧЕМ (формат)
structure: "..." # КАК структурировано
location: "..." # ГДЕ хранится
volume: "100+ документов" # СКОЛЬКО
# Опционально (контекст)
purpose: "..." # ЗАЧЕМ (опционально)
audience: [...] # КТО использует (опционально)
updated: "2025-12-22" # КОГДА обновлено (опционально)
Вопросы (5):
1. ЧТО? — Какая информация
2. ЧЕМ? — Формат (Markdown, JSON, PDF)
3. КАК? — Структура, организация
4. ГДЕ? — Где хранится
5. СКОЛЬКО? — Объём, количество
Опционально: ЗАЧЕМ, КТО, КОГДА (контекст использования)
Характеристика: Продаёт клиентам, генерирует выручку
Примеры:
- Розница (retail)
- Маркетплейс (ozon)
- Оптовые продажи (wholesale)
Роли:
- main — главное направление
- satellite — дополняет main
- experiment — тестируем гипотезу
Состав:
{direction}/
├── [ОБЯЗАТЕЛЬНЫЕ]
│ ├── CLAUDE.md
│ └── index.yaml
│
├── [ПРОЕКТИРОВАНИЕ]
│ └── design/
│ ├── GOALS.md ← Цели направления
│ ├── PLAN.md ← План развития
│ ├── TARGET.md ← Целевая аудитория
│ └── POSITIONING.md ← Позиционирование
│
├── [УПРАВЛЕНИЕ]
│ └── management/
│ ├── STATUS.md
│ ├── TODO.md
│ ├── METRICS.md ← KPI направления
│ └── ANALYTICS.md ← Аналитика
│
├── [МОДУЛИ]
│ ├── @{site}/ ← Сайт
│ ├── @{app}/ ← Приложение
│ └── @{admin}/ ← Админка
│
└── [ДАННЫЕ]
└── _data/
├── orders/ ← Заказы
├── customers/ ← Клиенты
├── analytics/ ← Аналитика
└── reports/ ← Отчёты
Свойства index.yaml:
name: "Retail"
type: direction
role: main # main | satellite | experiment
status: active
# 9 вопросов (упрощённо)
problem: "..." # ПОЧЕМУ
goal: "..." # ЗАЧЕМ
result: "..." # ЧТО продаём
customers: [...] # КТО покупает
sales_model: "..." # КАК продаём
resources: [...] # ЧЕМ торгуем
market: "..." # ГДЕ продаём
timeline: "..." # КОГДА запустили
metrics:
revenue_monthly: 500000 # СКОЛЬКО
orders_monthly: 150
margin: 0.35
# Связи
parent: null # для satellite
depends_on: []
provides_to: ["ozon"]
modules: ["@site"]
Метрики (специфичные для типа):
Розница (retail):
metrics:
revenue_monthly: 500000
orders_monthly: 150
avg_check: 3333
conversion: 0.025
customers_active: 1200
returns_rate: 0.05
Маркетплейс (marketplace):
metrics:
revenue_monthly: 300000
orders_monthly: 200
commission: 0.15
rating: 4.8
returns_rate: 0.08
Опт (wholesale):
metrics:
revenue_monthly: 1000000
clients_active: 25
avg_order: 40000
payment_delay_days: 14
Характеристика: Обслуживает другие направления
Примеры:
- Общие сервисы (services)
- Данные (data)
- Логистика (logistics)
Роль:
- service — обслуживающее направление
Состав:
services/
├── [ОБЯЗАТЕЛЬНЫЕ]
│ ├── CLAUDE.md
│ └── index.yaml
│
├── [ПРОЕКТИРОВАНИЕ]
│ └── design/
│ ├── SERVICES.md ← Какие сервисы
│ ├── API.md ← API документация
│ └── ARCHITECTURE.md ← Архитектура
│
├── [УПРАВЛЕНИЕ]
│ └── management/
│ ├── STATUS.md
│ ├── SLA.md ← Service Level Agreement
│ └── METRICS.md ← Технические метрики
│
└── [МОДУЛИ]
├── @pim.service/
├── @market.app/
└── @backup.cli/
Свойства index.yaml:
name: "Services"
type: direction
role: service
status: active
# 7 вопросов
services: [...] # ЧТО предоставляет
users: ["retail", "ozon"] # КТО использует
how: "REST API" # КАК работает
resources: [...] # ЧЕМ обеспечено
location: "@dev-pro.server" # ГДЕ размещено
metrics:
uptime: 0.99
requests_daily: 10000
latency_ms: 150
# Клиенты
serves: ["retail", "ozon", "wholesale"]
modules: ["@pim.service", "@market.app"]
Характеристика: Хранит данные для бизнеса
Примеры:
- Данные (data)
- Каталог товаров
- База знаний продукта
Роль:
- service (часто)
Состав:
data/
├── [ОБЯЗАТЕЛЬНЫЕ]
│ ├── CLAUDE.md
│ └── index.yaml
│
├── [ДОКУМЕНТАЦИЯ]
│ ├── PIM_STRUCTURE.md
│ ├── PIM_CLASSIFICATION.md
│ └── DATA_SOURCES.md
│
├── [СКРИПТЫ]
│ ├── scripts/
│ │ ├── import/
│ │ ├── export/
│ │ └── transform/
│ └── nocodb/
│ └── scripts/
│
└── [ДАННЫЕ] (в Hub)
└── _shared/
├── products/ ← Каталог
├── prices/ ← Цены
└── images/ ← Изображения
Свойства index.yaml:
name: "Data"
type: direction
role: service
system_type: informational # Тип системы
# 5 вопросов
content: "Каталог товаров" # ЧТО
format: "NocoDB + JSON" # ЧЕМ (формат)
structure: "PIM модель" # КАК
location: "NocoDB + S3" # ГДЕ
volume: "5623 товаров" # СКОЛЬКО
# База данных
database:
type: "NocoDB"
schema: "pt7k98pv0fwi1el"
tables: ["pim_products", "pim_pirotehnika"]
Характеристика: Преобразует вход в выход
Примеры:
- Производство (production)
- Логистика (logistics)
- Обработка заказов (fulfillment)
Роль:
- service (обычно)
Состав:
{process}/
├── [ОБЯЗАТЕЛЬНЫЕ]
│ ├── CLAUDE.md
│ └── index.yaml
│
├── [ПРОЕКТИРОВАНИЕ]
│ └── design/
│ ├── WORKFLOW.md ← Схема процесса
│ ├── SOP.md ← Standard Operating Procedures
│ └── ROLES.md ← Роли участников
│
├── [УПРАВЛЕНИЕ]
│ └── management/
│ ├── STATUS.md
│ ├── METRICS.md ← Метрики процесса
│ └── INCIDENTS.md ← Инциденты
│
└── [АВТОМАТИЗАЦИЯ]
├── @automation/
└── scripts/
Свойства index.yaml:
name: "Logistics"
type: direction
role: service
system_type: process
# 8 вопросов
reason: "..." # ПОЧЕМУ нужен
goal: "..." # ЗАЧЕМ
input: "Заказы" # ЧТО на входе
output: "Доставленные товары" # ЧТО на выходе
actors: [...] # КТО участвует
steps: [...] # КАК работает
resources: [...] # ЧЕМ обеспечен
location: "..." # ГДЕ происходит
# НЕТ: СКОЛЬКО (метрики ниже)
metrics:
cycle_time_hours: 24
success_rate: 0.95
throughput_daily: 50
Вопросы (8):
1. ПОЧЕМУ? — Зачем нужен процесс
2. ЗАЧЕМ? — Цель процесса
3. ВХОД — Что на входе
4. ВЫХОД — Что на выходе
5. КТО? — Участники (роли)
6. КАК? — Последовательность шагов
7. ЧЕМ? — Ресурсы, инструменты
8. ГДЕ? — Где происходит
НЕТ: СКОЛЬКО (метрики отдельно)
Характеристика: Интерфейс для клиента
Типы модулей:
- site — веб-сайт для клиентов
- app — мобильное/десктоп приложение
Состав:
@{site}/
├── [ОБЯЗАТЕЛЬНЫЕ]
│ ├── CLAUDE.md
│ └── index.yaml
│
├── [ПРОЕКТИРОВАНИЕ]
│ └── design/
│ ├── ARCHITECTURE.md ← Архитектура
│ ├── UI_UX.md ← Дизайн
│ ├── FEATURES.md ← Функциональность
│ └── DATABASE.md ← Схема БД
│
├── [РЕАЛИЗАЦИЯ]
│ └── solution/
│ ├── src/ ← Исходный код
│ ├── config/ ← Конфигурация
│ ├── tests/ ← Тесты
│ ├── docs/ ← Техдокументация
│ └── README.md
│
├── [УПРАВЛЕНИЕ]
│ └── management/
│ ├── STATUS.md
│ ├── TODO.md
│ ├── CHANGELOG.md
│ └── DEPLOYMENT.md ← Инструкции по деплою
│
└── [ОТЧЁТЫ]
└── reports/
Свойства index.yaml:
name: "@pirotehnika.spb.ru"
type: module
module_type: site
status: production
# Технологии
stack:
platform: "OpenCart"
language: "PHP"
version: "3.0"
database: "MySQL"
frontend: "JavaScript"
# Развёртывание
deployment:
url: "https://pirotehnika.spb.ru"
server: "@beget-kondurov.server"
path: "/home/k/kondurov/pirotehnika.spb.ru/public_html"
repository: "git@github.com:user/repo.git"
# Зависимости
depends_on:
- "@pim.service"
- "infra/@dev-pro.server"
# Метрики
metrics:
uptime: 0.99
response_time_ms: 200
visitors_daily: 1000
conversion: 0.025
Характеристика: Сервис для других модулей
Типы модулей:
- service — микросервис
- api — API/интеграция
- cli — CLI-утилита
- worker — фоновый процесс
Пример: @pim.service
Состав:
@pim.service/
├── [ОБЯЗАТЕЛЬНЫЕ]
│ ├── CLAUDE.md
│ └── index.yaml
│
├── [ПРОЕКТИРОВАНИЕ]
│ └── design/
│ ├── ARCHITECTURE.md
│ ├── API.md ← API спецификация
│ ├── DATABASE.md
│ └── INTEGRATION.md ← Интеграции
│
├── [РЕАЛИЗАЦИЯ]
│ └── solution/
│ ├── app/ ← FastAPI app
│ ├── scripts/ ← Скрипты
│ ├── config/
│ ├── tests/
│ └── requirements.txt
│
└── [УПРАВЛЕНИЕ]
└── management/
├── STATUS.md
├── TODO.md
├── API_CHANGELOG.md
└── SLA.md
Свойства index.yaml:
name: "@pim.service"
type: module
module_type: service
status: production
# Технологии
stack:
platform: "FastAPI"
language: "Python"
version: "3.10"
database: "PostgreSQL (NocoDB)"
# API
api:
url: "https://api.example.com/pim"
version: "v1"
docs: "https://api.example.com/pim/docs"
# Клиенты (кого обслуживает)
serves:
- "@pirotehnika.spb.ru"
- "@ozon.api"
- "@admin.app"
# Метрики
metrics:
uptime: 0.99
requests_daily: 10000
latency_p95_ms: 150
errors_rate: 0.001
Характеристика: Документация, база знаний
Примеры:
- Документация модуля (docs/)
- Схемы (schemas/)
Обычно не выделяется в отдельный модуль, а живёт как папка:
@module/
└── solution/
└── docs/ ← Информационная система
├── README.md
├── ARCHITECTURE.md
├── API.md
└── DEPLOYMENT.md
Характеристика: Действует автономно
Типы модулей:
- bot — чат-бот
- worker — фоновый процесс
- cli — CLI с автономной логикой
Пример: @telegram.bot
Состав:
@telegram.bot/
├── [ОБЯЗАТЕЛЬНЫЕ]
│ ├── CLAUDE.md
│ └── index.yaml
│
├── [ПРОЕКТИРОВАНИЕ]
│ └── design/
│ ├── SCENARIOS.md ← Сценарии диалогов
│ ├── COMMANDS.md ← Команды
│ └── LOGIC.md ← Логика работы
│
├── [РЕАЛИЗАЦИЯ]
│ └── solution/
│ ├── bot.py
│ ├── handlers/
│ ├── utils/
│ └── config/
│
└── [УПРАВЛЕНИЕ]
└── management/
├── STATUS.md
└── METRICS.md
Свойства index.yaml:
name: "@telegram.bot"
type: module
module_type: bot
status: production
# Технологии
stack:
platform: "aiogram"
language: "Python"
version: "3.10"
# Конфигурация
config:
token: "env:TELEGRAM_TOKEN"
webhook: "https://bot.example.com/webhook"
# Метрики
metrics:
users_active: 500
messages_daily: 2000
response_time_ms: 300
Вопросы (6):
1. ЗАЧЕМ? — Назначение агента
2. ЧТО? — Что делает
3. КТО? — С кем взаимодействует
4. КАК? — Как работает (алгоритм)
5. ЧЕМ? — Технологии, ресурсы
6. ГДЕ? — Где работает
НЕТ: ПОЧЕМУ (не решает проблему), КОГДА (работает по событиям), СКОЛЬКО (метрики отдельно)
Характеристика: Атомарное действие
Типы задач:
- feature (новая функция)
- bugfix (исправление)
- refactor (улучшение)
- docs (документация)
- test (тестирование)
- deploy (развёртывание)
Формат в TODO.md:
## [P0] Добавить фильтр по цене
**Тип:** feature
**Статус:** in_progress
**Ответственный:** owner
**Срок:** 2025-12-25
### Описание
Добавить возможность фильтрации товаров по диапазону цен на странице каталога.
### Критерии завершения
- [ ] Добавлен слайдер выбора диапазона
- [ ] Фильтр работает с AJAX
- [ ] Сохраняется в URL
- [ ] Написаны тесты
### Связи
- Зависит от: #123 (Рефакторинг каталога)
- Блокирует: #125 (Интеграция с поиском)
### Технические детали
- Файлы: `catalog.php`, `filter.js`
- Библиотека: noUiSlider
Свойства:
title: "Добавить фильтр по цене"
type: feature
priority: P0
status: in_progress
assignee: "owner"
deadline: "2025-12-25"
module: "@pirotehnika.spb.ru"
# Связи
depends_on: ["#123"]
blocks: ["#125"]
# Оценка
estimate_hours: 4
actual_hours: null
| Тип системы | Вид бизнеса | Примеры | Вопросов |
|---|---|---|---|
| Целевая | Торговля | pirotehnika, lideravto | 9 |
| Целевая | SaaS | content-factory | 9 |
| Целевая | Услуги | seller1 | 9 |
| Обеспечивающая | Инфраструктура | infra | 7 |
| Обеспечивающая | Платформа | system | 7 |
| Информационная | Методология | architect | 5 |
| Информационная | Документация | docs | 5 |
| Тип системы | Вид направления | Роль | Примеры | Вопросов |
|---|---|---|---|---|
| Целевая | Розница | main | retail | 9 |
| Целевая | Маркетплейс | satellite | ozon | 9 |
| Целевая | Опт | satellite | wholesale | 9 |
| Целевая | B2B | experiment | b2b | 9 |
| Обеспечивающая | Сервисы | service | services | 7 |
| Информационная | Данные | service | data | 5 |
| Процесс | Логистика | service | logistics | 8 |
| Процесс | Производство | service | production | 8 |
| Тип системы | module_type | Примеры | Вопросов |
|---|---|---|---|
| Целевая | site | @pirotehnika.spb.ru | 9 |
| Целевая | app | @market.app | 9 |
| Обеспечивающая | service | @pim.service | 7 |
| Обеспечивающая | api | @ozon.api | 7 |
| Обеспечивающая | cli | @backup.cli | 7 |
| Информационная | docs | solution/docs/ | 5 |
| Агент | bot | @telegram.bot | 6 |
| Агент | worker | @queue.worker | 6 |
{business}/
│
├── [БАЗОВЫЕ ФАЙЛЫ]
│ ├── CLAUDE.md ← Контекст для AI
│ ├── index.yaml ← Метаданные
│ ├── PROJECT.md ← 9 вопросов
│ └── README.md ← Краткое описание (опционально)
│
├── [ПРОЕКТИРОВАНИЕ]
│ └── design/
│ ├── STRATEGY.md ← Бизнес-стратегия
│ ├── BUSINESS_MODEL.md ← Бизнес-модель (Canvas)
│ ├── MARKET.md ← Анализ рынка
│ ├── COMPETITORS.md ← Конкурентный анализ
│ ├── SWOT.md ← SWOT-анализ
│ ├── GOALS.md ← Цели и OKR
│ ├── POSITIONING.md ← Позиционирование
│ └── ARCHITECTURE.md ← Техническая архитектура
│
├── [УПРАВЛЕНИЕ]
│ └── management/
│ ├── STATUS.md ← Текущий статус
│ ├── ROADMAP.md ← Дорожная карта
│ ├── METRICS.md ← KPI
│ ├── BUDGET.md ← Бюджет
│ ├── TODO.md ← Задачи (опционально)
│ ├── RISKS.md ← Риски
│ └── TEAM.md ← Команда
│
├── [МОТИВАЦИЯ]
│ └── motivation/ (опционально)
│ ├── WHY.md ← Почему занимаемся
│ ├── VISION.md ← Видение
│ └── goals/ ← Цели по периодам
│
├── [ДАННЫЕ]
│ └── _shared/ ← Общие данные (в workspace)
│ ├── data/ ← Каталоги, справочники
│ ├── docs/ ← Документы
│ ├── assets/ ← Медиа, ресурсы
│ ├── config/ ← Конфигурации
│ └── work/ ← Рабочие файлы
│
├── [НАПРАВЛЕНИЯ]
│ ├── {direction-1}/ ← MAIN направление
│ ├── {direction-2}/ ← SATELLITE
│ ├── {direction-3}/ ← EXPERIMENT
│ └── {direction-N}/
│
├── [СЕРВИСЫ]
│ └── services/ ← Общие сервисы
│ ├── @{service-1}/
│ ├── @{service-2}/
│ └── @{service-N}/
│
└── [ИНФРАСТРУКТУРА]
└── infra/ (опционально, может быть отдельным бизнесом)
└── {описание инфраструктуры}
{direction}/
│
├── [БАЗОВЫЕ ФАЙЛЫ]
│ ├── CLAUDE.md
│ ├── index.yaml
│ └── README.md (опционально)
│
├── [ПРОЕКТИРОВАНИЕ]
│ └── design/
│ ├── GOALS.md ← Цели направления
│ ├── PLAN.md ← План развития
│ ├── TARGET.md ← Целевая аудитория
│ ├── POSITIONING.md ← Позиционирование
│ ├── ARCHITECTURE.md ← Архитектура (если сложная)
│ └── FEATURES.md ← Основные функции
│
├── [УПРАВЛЕНИЕ]
│ └── management/
│ ├── STATUS.md ← Статус направления
│ ├── TODO.md ← Задачи
│ ├── METRICS.md ← KPI
│ ├── ANALYTICS.md ← Аналитика
│ └── REPORTS.md ← Отчёты
│
├── [МОДУЛИ]
│ ├── @{module-1}/ ← Сайт
│ ├── @{module-2}/ ← Приложение
│ ├── @{module-3}/ ← Админка
│ └── @{module-N}/
│
└── [ДАННЫЕ]
└── _data/ ← Локальные данные направления
├── orders/ ← Заказы
├── customers/ ← Клиенты
├── analytics/ ← Аналитика
├── reports/ ← Отчёты
└── exports/ ← Выгрузки
@{module}/
│
├── [БАЗОВЫЕ ФАЙЛЫ]
│ ├── CLAUDE.md
│ ├── index.yaml
│ └── README.md
│
├── [ПРОЕКТИРОВАНИЕ]
│ └── design/
│ ├── ARCHITECTURE.md ← Архитектура модуля
│ ├── UI_UX.md ← Дизайн интерфейса
│ ├── FEATURES.md ← Функциональность
│ ├── DATABASE.md ← Схема БД
│ ├── API.md ← API (если есть)
│ └── INTEGRATIONS.md ← Интеграции
│
├── [РЕАЛИЗАЦИЯ]
│ └── solution/ ← КОД
│ ├── src/ ← Исходный код
│ │ ├── components/
│ │ ├── pages/
│ │ ├── services/
│ │ └── utils/
│ ├── config/ ← Конфигурация
│ │ ├── .env.example
│ │ └── settings.php
│ ├── tests/ ← Тесты
│ │ ├── unit/
│ │ ├── integration/
│ │ └── e2e/
│ ├── scripts/ ← Скрипты
│ │ ├── deploy.sh
│ │ └── backup.sh
│ ├── docs/ ← Техническая документация
│ │ ├── SETUP.md
│ │ └── DEPLOYMENT.md
│ ├── package.json ← Зависимости (JS)
│ ├── composer.json ← Зависимости (PHP)
│ ├── requirements.txt ← Зависимости (Python)
│ └── README.md
│
├── [УПРАВЛЕНИЕ]
│ └── management/
│ ├── STATUS.md ← Статус модуля
│ ├── TODO.md ← Задачи
│ ├── CHANGELOG.md ← История изменений
│ ├── DEPLOYMENT.md ← Инструкции по деплою
│ └── MONITORING.md ← Мониторинг
│
└── [ОТЧЁТЫ]
└── reports/ ← Технические отчёты
├── 2025-12-01-performance.md
└── 2025-12-15-security-audit.md
| Связь | Обозначение | Направление | Пример |
|---|---|---|---|
| contains | ⊃ |
Вниз (L→L+1) | Бизнес ⊃ Направления |
| belongs_to | ⊂ |
Вверх (L+1→L) | Направление ⊂ Бизнес |
| depends_on | → |
Горизонталь | retail → services |
| provides_to | ⇒ |
Горизонталь | services ⇒ retail |
| uses | ↔ |
Двунаправленная | retail ↔ _shared |
┌─────────────────────┐
│ L0: WORKSPACE │
└──────────┬──────────┘
│ contains (⊃)
┌──────────────────┼──────────────────┐
│ │ │
▼ ▼ ▼
┌───────────────┐ ┌───────────────┐ ┌───────────────┐
│ L1: architect │ │ L1: infra │ │ L1: piroteh.. │
│ (Информац.) │ │ (Обеспеч.) │ │ (Целевая) │
└───────────────┘ └───────┬───────┘ └───────┬───────┘
│ │ contains
│ │
┌──────┴──────┐ ┌──────┴──────────────┬────────────┐
▼ ▼ ▼ ▼ ▼
┌─────────┐ ┌─────────┐ ┌──────────┐ ┌──────────┐ ┌─────────┐
│@server-1│ │@server-2│ │L2: retail│ │ L2: ozon │ │L2: data │
│(Модуль) │ │(Модуль) │ │ (Целевая)│ │(Целевая) │ │(Информ.)│
└─────────┘ └─────────┘ └────┬─────┘ └────┬─────┘ └────┬────┘
│ │ │
provides_to (⇒) │depends_on(→)│ │
┌─────────────────────┤ │ │
│ ▼ ▼ ▼
│ ┌──────────┐ ┌──────────┐ ┌──────────┐
└─────────────→│ L3: │ │ L3: │ │ L3: │
│ @site │ │ @api │ │ @pim │
│(Целевая) │ │(Обеспеч.)│ │(Обеспеч.)│
└────┬─────┘ └──────────┘ └──────────┘
│ contains
▼
┌──────────────┐
│ L4: ЗАДАЧИ │
│ (Процессы) │
└──────────────┘
| Уровень | Формат | Регистр | Пробелы | Спецсимволы | Пример |
|---|---|---|---|---|---|
| L0 | workspace |
любой | нет | нет | claude-workspace |
| L1 | {name} |
lowercase | нет | - |
pirotehnika |
| L2 | {name} |
lowercase | нет | - |
retail, b2b |
| L3 | @{name}.{type} |
lowercase | нет | @ . - |
@pim.service |
| L3 | @{domain} |
lowercase | да (в домене) | @ . |
@pirotehnika.spb.ru |
| L4 | {любой текст} |
любой | да | любые | "Добавить фильтр" |
| Префикс | Назначение | Уровень | Пример |
|---|---|---|---|
_ |
Вспомогательные данные | L1, L2 | _shared, _data, _inbox |
@ |
Технический модуль (код) | L3 | @site, @api, @bot |
| Суффикс | Тип | Пример |
|---|---|---|
| (нет) | site (домен) | @pirotehnika.spb.ru |
.api |
API | @ozon.api |
.service |
Микросервис | @pim.service |
.app |
Приложение | @market.app |
.bot |
Бот | @telegram.bot |
.cli |
CLI-утилита | @backup.cli |
.worker |
Фоновый процесс | @queue.worker |
idea → planning → development → active → scaling → mature → exit
| Статус | Описание | Метрики |
|---|---|---|
| idea | Идея, нет действий | - |
| planning | Бизнес-план | - |
| development | Строим инфраструктуру | Затраты |
| active | Работает, приносит деньги | Выручка, прибыль |
| scaling | Активный рост | Growth rate |
| mature | Стабильная работа | ROI |
| exit | Продажа/закрытие | Final reports |
draft → development → testing → production → maintenance
| Статус | Описание | Метрики |
|---|---|---|
| draft | Проектирование | - |
| development | Строим | - |
| testing | Тестируем | Тесты |
| production | В проде | Uptime, SLA |
| maintenance | Поддержка | Incidents |
idea → validation → launch → growth → optimize → plateau → sunset
draft → development → active → maintenance
draft → development → testing → production → maintenance → deprecated
todo → in_progress → review → done / cancelled
L1: Бизнес
metrics:
revenue_monthly: 1000000 # Выручка
profit_monthly: 350000 # Прибыль
margin: 0.35 # Маржинальность
customers_total: 5000 # Клиентов всего
customers_active: 1500 # Активных клиентов
employees: 10 # Сотрудников
runway_months: 12 # Взлётная полоса
L2: Направление (Розница)
metrics:
revenue_monthly: 500000
orders_monthly: 150
avg_check: 3333
conversion: 0.025
customers_active: 1200
returns_rate: 0.05
ltv: 10000 # Lifetime Value
L2: Направление (Маркетплейс)
metrics:
revenue_monthly: 300000
orders_monthly: 200
commission: 0.15
rating: 4.8
returns_rate: 0.08
L3: Модуль (Site)
metrics:
visitors_daily: 1000
conversion: 0.025
avg_session_duration: 180 # секунд
bounce_rate: 0.45
pages_per_session: 3.2
L1: Бизнес (Инфраструктура)
metrics:
uptime: 0.999
clients: 5 # Количество обслуживаемых бизнесов
capacity_used: 0.60 # Использование мощности
incidents_monthly: 2
L2: Направление (Services)
metrics:
uptime: 0.99
requests_daily: 10000
latency_p95_ms: 150
errors_rate: 0.001
L3: Модуль (Service)
metrics:
uptime: 0.99
requests_daily: 10000
latency_p50_ms: 100
latency_p95_ms: 150
latency_p99_ms: 300
errors_rate: 0.001
cache_hit_rate: 0.85
L1: Бизнес (База знаний)
metrics:
documents_total: 150
pages_total: 5000
size_mb: 50
contributors: 3
updates_monthly: 20
L2: Направление (Логистика)
metrics:
cycle_time_hours: 24 # Время цикла
throughput_daily: 50 # Пропускная способность
success_rate: 0.95 # Успешность
cost_per_order: 250 # Стоимость обработки
L3: Модуль (Bot)
metrics:
users_active: 500
messages_daily: 2000
response_time_ms: 300
success_rate: 0.92
Версия: 1.0.0
Создано: 2025-12-22
Автор: Claude Sonnet 4.5