Claude Code Workspace — Platform Overview

НЕ генерировать код с нуля → Использовать готовые компоненты
Экономия: 5,000 tokens → 500 tokens = 90%

/opt/claude-workspace/
│
├── 📦 components/              # Переиспользуемые компоненты (FSD)
│   ├── shared/lib/             # formatters, validators
│   ├── entities/               # User, Order модели
│   ├── features/               # 25 компонентов (roadmap)
│   └── catalog.yaml            # Каталог компонентов
│
├── 🎨 templates/               # Готовые шаблоны
│   ├── by-feature/auth/        # streamlit-auth-v1 (85% экономия)
│   ├── by-task/crud/           # streamlit-crud-v1 (86% экономия)
│   ├── by-task/dashboard/      # table-filters-v1 (86% экономия)
│   ├── library/streamlit/      # Документация Streamlit
│   └── VERSIONS.yaml           # Версионирование
│
├── 🧪 tests/                   # Автотесты
│   ├── library/e2e/            # 5 E2E тестов (Playwright)
│   └── integration/            # 3 integration теста (pytest)
│
├── 📁 projects/                # Ваши проекты
│   └── marketplace/            # Пример проекта
│
├── 🗂️ archive/                 # Архив старых версий
│   └── INDEX.yaml              # Индекс для быстрого поиска
│
└── 📊 platform/                # Ядро системы
    ├── CLAUDE.md               # Главный документ
    ├── modes/                  # 7 режимов работы
    │   ├── workspace.md        # Управление проектами
    │   ├── code.md             # Разработка кода
    │   ├── design.md           # Проектирование
    │   ├── deploy.md           # Инфраструктура
    │   ├── test.md             # Тестирование
    │   ├── sync.md             # Синхронизация
    │   └── minimal.md          # Минимальный режим
    └── .claude/                # Журналы
        ├── system-journal.md   # Глобальные события
        └── last-session.md     # Последняя сессия

L1: Platform (85%)     → platform/CLAUDE.md
    ├─ Базовые правила работы
    └─ Принцип: "Искать перед генерацией"

L2: Registry (98%)     → registry/INDEX.yaml
    └─ Внешние библиотеки (pandas, streamlit, etc.)

L3: Templates (99.5%)  → templates/
    ├─ streamlit-auth-v1 (авторизация)
    ├─ streamlit-crud-v1 (CRUD страницы)
    └─ table-filters-v1 (таблицы с фильтрами)

L4: Components (99.8%) → components/
    ├─ formatters.py (7 функций)
    ├─ validators.py (7 функций)
    ├─ User model (SQLAlchemy)
    └─ Order model (SQLAlchemy)

L5: Projects (99.95%)  → projects/*/solution/
    └─ Код существующих проектов

L6: Archive (100%)     → archive/
    └─ Старые версии кода (через INDEX.yaml)

L7: Generate           → Генерация с нуля
    └─ ТОЛЬКО если ничего не нашли на L1-L6

User: Добавь форматирование цены в рублях

Claude (автоматически):
├─ L1: Читаю platform/CLAUDE.md → "искать перед генерацией"
├─ L4: Проверяю components/catalog.yaml → НАШЁЛ!
│      components/shared/lib/formatters.py:format_currency()
└─ Использую готовое

РЕЗУЛЬТАТ:
from components.shared.lib.formatters import format_currency
st.write(format_currency(1234.56))  # "1 234.56 ₽"

Экономия: 850 tokens (85%)

Покажи все проекты
Создать проект <name> используя шаблон <template>
Архивировать проект old-system

1. Декомпозировать задачу
2. Читать registry/INDEX.yaml
3. Искать в Cascade L1→L7
4. Использовать найденное
5. Генерировать ТОЛЬКО недостающее

Добавь функцию <name>
Исправь ошибку в <file>:<line>
Оптимизируй <function>

Начать с начала
Покажи состояние проекта
Обновить roadmap

Задеплой <project> на production
Настрой SSL для <domain>
Создай backup БД

❌ НЕ генерировать тест с нуля (2000 tokens)
✅ Использовать tests/library/ (300 tokens)
Экономия: 85%

Запусти все тесты
Создай E2E тест для <page>
Проверь coverage

Скопируй <component> из <project1> в <project2>
Синхронизируй formatters во все проекты

projects/{name}/
├── design/                  # 📋 ЧТО делаем
│   ├── PROJECT.md          # Описание, цели
│   ├── ROADMAP.md          # План версий
│   ├── ARCHITECTURE.md     # ADR (решения)
│   └── MODELS.md           # Модели данных
│
├── management/              # ⚙️ КАК организовано
│   ├── README.md           # Состояние проекта
│   └── CHANGELOG.md        # История изменений
│
├── solution/                # 💻 Реализации
│   ├── mvp/                # MVP (Streamlit)
│   ├── backend/            # Backend (FastAPI)
│   └── mobile/             # Mobile app
│
└── infrastructure/          # 🏗️ Серверы
    ├── ansible/
    ├── docker-compose.yml
    └── scripts/

1. WORKSPACE MODE
   User: Создать проект analytics используя streamlit-mvp-v1
   → Автоматически создаётся структура из шаблона

2. DESIGN MODE
   User: Начать с начала
   → Читается design/PROJECT.md, показывается контекст

3. CODE MODE
   User: Добавь форматирование данных
   → Cascade Search находит components/formatters.py
   → Экономия 85%

4. TEST MODE
   User: Создай E2E тест
   → Адаптация tests/library/e2e/streamlit_page_load.js
   → Экономия 84%

5. DEPLOY MODE
   User: Задеплой на production
   → Спрашивает подтверждение, создаёт backup, деплоит

User: Добавь форматирование цены

Claude (автоматически):
├─ Cascade L1: platform/CLAUDE.md → "искать перед генерацией"
├─ Cascade L4: components/ → НАШЁЛ formatters.py!
└─ Добавляю импорт:

from components.shared.lib.formatters import format_currency
st.write(format_currency(order.total))

Вместо 1,000 tokens → 150 tokens
Экономия: 85%

User: Создай CRUD страницу для товаров

Claude (автоматически):
├─ Cascade L3: templates/ → НАШЁЛ streamlit-crud-v1!
├─ Копирую crud_page.py в проект
├─ Меняю переменные:
│   ENTITY_NAME = "Product"
│   FIELDS = {
│       'name': 'text',
│       'price': 'number',
│       'category': 'select'
│   }
└─ Готово!

Вместо 5,000 tokens → 700 tokens
Экономия: 86%

Текущий workspace: /opt/claude-workspace
Режим: (автоопределяется или указывается)
Проект: (если внутри проекта)

→ WORKSPACE MODE

User: Начать работу с проектом marketplace
→ CODE/DESIGN MODE (в контексте проекта)

8053041 docs: обновлён library/README.md
004ae17 docs: полный пакет Streamlit документации
d489a69 docs: добавлена инструкция Streamlit
648cc78 docs: Token Economy + Session Summary
c7ff964 feat: versioning + integration tests
ff16344 feat: archive index
88858fc feat: CRUD template
5fb578c feat: auth template
dcfa107 feat: 4 компонента
9f97571 feat: components library FSD
98278e2 feat: table-filters template
cc951f6 feat: tests library

# Показать структуру
tree -L 2 /opt/claude-workspace/

# Найти все компоненты
ls -la components/

# Найти все шаблоны
ls -la templates/

# Посмотреть последние коммиты
git log --oneline -10

# Читать главный документ
cat platform/CLAUDE.md

# Читать режим работы
cat platform/modes/code.md