Структура платформы

WORKSPACE=/opt/claude-workspace
DATASPACE=/mnt/beget-s3
BACKUPSPACE=$DATASPACE/backup
DATABASE=postgresql://...

КОД:          .py .js .ts .tsx .jsx .php .go .sh
ДОКУМЕНТЫ:    .md .txt .rst
КОНФИГУРАЦИЯ: .yaml .yml .json .toml .ini .conf .env.example
WEB:          .html .css .scss
ШАБЛОНЫ:      .twig .j2
SQL:          .sql (схемы и миграции)
СПЕЦИАЛЬНЫЕ:  .gitignore Dockerfile Makefile LICENSE

РАСТРОВАЯ ГРАФИКА: .jpg .jpeg .png (>50KB) .gif .webp
МЕДИА:     .mp4 .mp3
ДОКУМЕНТЫ: .pdf .docx .xlsx
ДАННЫЕ:    .csv (> 100 KB)
СЕКРЕТЫ:   .env .key .pem
ВРЕМЕННЫЕ: .pyc .log .tmp venv/ node_modules/ __pycache__/

$WORKSPACE/
│
├── architect/     ЧТО МЫ ЗНАЕМ? (мышление и стандарты)
├── projector/     КАК МЫ УПРАВЛЯЕМ? (проекты и исполнение)
├── library/       ЧТО МЫ ИСПОЛЬЗУЕМ? (пассивные знания)
├── system/        ЧЕМ ЖИВЁТ ПЛАТФОРМА? (платформенные агенты и сервисы)
├── projects/      ЧТО МЫ ДЕЛАЕМ? (данные проектов)
├── infra/         ГДЕ ЭТО РАБОТАЕТ? (физический уровень)
└── services/      ЧТО ЗАПУЩЕНО? (production docker-сервисы проектов)

$WORKSPACE/
│
├── architect/
│   ├── theory/              У0: фундаментальные модели (LOCKED)
│   ├── concept/             У0: концепция, видение, метамодель, роли
│   ├── rules/               У1: правила платформы
│   ├── decisions/           ADR: архитектурные решения
│   └── research/            внешний опыт, исследования
│
├── projector/
│   ├── templates/           универсальные шаблоны (для любого типа проекта)
│   │   ├── project-brief.md
│   │   ├── task-card.md
│   │   ├── decision.md
│   │   └── status-report.md
│   ├── lifecycle/           фазы, ворота, статусы проекта
│   ├── workflows/           процессы управления (new-project, change-request)
│   ├── types/               типы проектов — знания + шаблоны по типу
│   │   ├── it/
│   │   │   ├── stacks/      drupal/ fastapi/ react/ scrapy/ python/
│   │   │   ├── templates/   шаблон IT-проекта
│   │   │   └── guides/      деплой, code-review, git-flow
│   │   ├── trade/           каталог, прайс, заказы, CRM
│   │   ├── production/      номенклатура, склад, процессы
│   │   ├── data/            BI, импорт/экспорт, отчёты
│   │   └── marketing/       SEO, контент, реклама
│   └── modules/             исполнители проектной работы
│       ├── @manager.module/ + AI.md
│       ├── @coder.module/   + AI.md
│       ├── @tester.module/  + AI.md
│       ├── @reviewer.module/ + AI.md
│       ├── @estimator.module/ + AI.md
│       └── @deployer.module/ + AI.md
│
├── library/                 пассивное — берёшь и используешь
│   ├── standards/           стандарты платформы (продукт Архитектора)
│   ├── templates/           шаблоны документов: brief, adr, report
│   ├── procedures/          пошаговые инструкции
│   ├── connectors/          шаблоны подключений без токенов
│   │   ├── ozon/
│   │   ├── telegram/
│   │   ├── postgres/
│   │   └── s3/
│   └── functions/           переиспользуемый код
│       ├── formatters/
│       ├── parsers/
│       └── validators/
│
├── system/                  активное — работает само
│   ├── agents/              платформенные AI-агенты
│   │   ├── @arh-creator.agent/
│   │   ├── @arh-dispatcher.agent/
│   │   ├── @pro-owner.agent/
│   │   └── @pro-manager.agent/
│   ├── @generator.service/  стандарт → документы/шаблоны
│   ├── @scheduler.service/  cron-задачи платформы
│   ├── @monitor.service/    мониторинг серверов и сервисов
│   ├── @notifier.service/   уведомления telegram/email
│   ├── @rag.service/        поиск по library/
│   ├── @vault.service/      управление секретами
│   ├── @sync.service/       синхронизация серверов
│   └── config/              реальные конфиги + secrets/ (.gitignored)
│
├── projects/
│   ├── sys/                 системные — развитие платформы
│   │   └── platform-vN/build/  дистрибутив при релизе
│   └── org/                 клиентские проекты
│       └── @biz-{имя}/
│
├── infra/
│   ├── @executor.module/
│   ├── @support.module/
│   ├── @{имя}.server/
│   └── scripts/
│       ├── backup.sh
│       ├── deploy.sh
│       └── check_resources.sh
│
└── services/                production docker-сервисы проектов
    └── @{имя}.service/
        ├── docker-compose.yml
        ├── .env.example
        └── config/

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

library/connectors/telegram/connector.py   ← шаблон, token: "{{TOKEN}}"
system/config/telegram.yaml                ← реальный токен, реальный chat_id

## ТРОЙКА
AI.md — для агентов (можно не читать)
CLAUDE.md — для Claude Code (вы здесь / можно не читать)
README.md — для людей (вы здесь / можно не читать)
INDEX.md — все файлы компонента с описаниями. При изменении структуры → обновить INDEX.md.

# INDEX — projector/

| Папка | Статус | Описание |
|-------|--------|---------|
| `templates/` | ✅ | универсальные шаблоны проектов |
| `lifecycle/` | ✅ | фазы, ворота, статусы |
| `workflows/` | 🔲 | процессы управления (запланировано) |
| `types/` | ✅ | типы проектов: знания + шаблоны |
| `types/it/` | ✅ | IT-проекты: стеки, гайды |
| `types/trade/` | 🔲 | торговые проекты |
| `modules/` | 🔲 | исполнители проектной работы |
| `modules/@coder.module/` | 🔲 | написание кода |

1. Создать папку компонента (если не существует)
2. Создать AI.md     — контекст для любого AI
3. Создать CLAUDE.md — AI.md + Claude Code навигация
4. Создать README.md — AI.md + объяснения для людей
5. Создать INDEX.md  — каталог подпапок с описаниями и статусами

---
type: context
object: {имя компонента}
---

# {Имя} — {роль одной строкой}

## ЧТО ЗДЕСЬ
{1-2 предложения: что это, зачем}

## СТРУКТУРА
{дерево подпапок с однострочными описаниями}

## ПРАВИЛА
{только специфичные ограничения этого узла}

# INDEX — {путь}/

| Папка | Статус | Описание |
|-------|--------|---------|
| name/ | ✅     | что здесь |
| name/ | 🔲     | запланировано |

ПРОЕКТ = ЦЕЛЬ + РЕЗУЛЬТАТ + РЕСУРСЫ + ВРЕМЯ

Модуль = контейнер (пассивный, хранит)
Агент  = исполнитель (активный, Claude Code читает {name}.ai.md и берёт роль)

Ты пишешь сам     → РОЛЬ   (режим диалога, поведение в сессии)
Работает без тебя → АГЕНТ  (автономный процесс, PID, лог-файл)

# Агент — можно ставить в cron:
schedule:
  - cron: "0 3 * * *"
    agent: infra-agent      # правильно

# Роль — нельзя ставить в cron (нет человека):
schedule:
  - agent: Архитектор       # НЕПРАВИЛЬНО, роль не процесс

L6  projects/pirotehnika/app/pim/
     ↓ использует
L4  library/connectors/api/ozon/
     ↓ использует
L3  system/core/executor/
     ↓ использует
L2  architect/standards/
     ↓ основаны на
L1  architect/concept/
     ↓ основаны на
L0  architect/theory/

# L6 → L4 — ПРАВИЛЬНО
from library.connectors.api.ozon import OzonConnector

# L4 → L6 — НЕПРАВИЛЬНО (обратная зависимость!)
from projects.pirotehnika.app.pim import ProductService

L2: PRIMITIVES (атомы данных)
    Type / Enum / Constant / Exception
    → Размещение: library/ или projects/

L3: FUNCTIONS (атомы логики)
    Validator / Formatter / Normalizer / Calculator / Generator / Transformer
    → Размещение: library/ (универсальные) или projects/ (специфичные)

L4: COMPONENTS (молекулы)
    Connector / Parser / Adapter / Mapper / Repository / Cache / Queue / Factory
    → Размещение: library/ (универсальные), projects/ (специфичные)

L5: SERVICES (оркестрация)
    Service / SyncService / Worker / Handler / UseCase
    → Размещение: projects/ (всегда специфичны)

L6: INTEGRATIONS (экосистемы)
    Integration / Pipeline / Workflow
    → Размещение: projects/ (конкретная бизнес-логика)

0.RESEARCH → 1.IDEATION → 2.DESIGN → 3.BUILD → 4.DEPLOY → 5.LAUNCH
                                                                ↓
                         10.RETIRE ← 9.EVOLVE ← 6.OPERATE + 7.MARKETING + 8.ANALYTICS

@projector → @manager → @it.domain → @tester → @executor → @support
                              ↑____________|
                              (фикс багов)