architect/_archive/2025-11-26-cleanup/cifra/domains/06_workspace/docs/guide.md

WORKSPACE MODE — Режим обзора workspace

Версия: 1.0
Дата создания: 2025-11-10


ЧТО ЭТО?

Режим для работы со ВСЕЙ структурой workspace: управление проектами, шаблонами, платформой.

Когда использовать:
- Обзор всех проектов
- Создание новых проектов
- Работа с шаблонами
- Управление платформой
- Реорганизация структуры


ПРАВИЛА РЕЖИМА

✅ ВСЕГДА АКТИВНО:

Каскадная система:
- L1: Platform правила (85%)
- L2: External libraries (98%)
- L3: Templates (99.5%)
- L4: Components (99.8%)
- L5: Projects code (99.95%)
- L6: Archive (100%)
- L7: Generate (если не нашли)

Автопоиск:
- registry/INDEX.yaml
- registry/index/by-function.yaml
- templates/catalog.yaml

Журналирование:
- platform/.claude/system-journal.md (глобальные события)
- platform/.claude/last-session.md (восстановление)

📂 ДОСТУПНЫЕ ОБЛАСТИ:

/opt/claude-workspace/
├── platform/       Полный доступ
├── templates/      Полный доступ
├── projects/       Только обзор (не вход в проект)
├── registry/       Чтение и обновление
└── archive/        Чтение

ВОЗМОЖНОСТИ

1. Обзор проектов

Команда:

Покажи все проекты

Действия:
1. Сканирование projects/*/
2. Чтение design/PROJECT.md каждого проекта
3. Проверка статуса (активен, архив, завершён)
4. Вывод сводной таблицы

Пример вывода:

📊 Проекты в workspace (3):

1. marketplace  ACTIVE
   Тип: ERP для маркетплейсов
   Решения: MVP (Streamlit)  | Backend (FastAPI) 📋
   Последнее изменение: 2025-11-09

2. @infra-dev-prod-rf 🏗️ INFRASTRUCTURE
   Тип: Production Docker платформа
   Статус: seller1.ru 🔴 PRODUCTION
   Последнее изменение: 2025-11-08

3. analytics 📋 PLANNED
   Тип: Аналитика продаж
   Статус: Только проектирование

2. Создание проектов

Команда:

Создать проект <NAME> используя шаблон <TEMPLATE>

Процедура:
1. Проверка существования проекта
2. Чтение templates/{category}/{template}/template.yaml
3. Запрос переменных (или использование defaults)
4. Создание структуры:
projects/{name}/ ├── design/ ├── management/ ├── solution/ └── infrastructure/ (опционально)
5. Копирование файлов из шаблона
6. Замена {{VARIABLES}}
7. Git commit
8. Обновление system-journal.md


3. Работа с шаблонами

Просмотр:

Какие шаблоны доступны

Создание нового шаблона:

Создать шаблон auth-system из проекта marketplace

Обновление шаблона:

Обновить шаблон streamlit-mvp-v1

4. Управление реестром

Добавление библиотеки:

Добавить библиотеку pandas в реестр

Поиск решения:

Найти решение для авторизации
 Автопоиск в registry/index/by-function.yaml

5. Архивирование

Команда:

Архивировать проект old-system

Действия:
1. mv projects/old-system archive/YYYY-MM-DD-old-system/
2. Обновление archive/INDEX.md
3. Git commit
4. Обновление system-journal.md


ПРОЦЕДУРЫ

ПРОЦЕДУРА: Создать проект из шаблона

Вход:
- project_name (обязательно)
- template_name (обязательно)
- variables (опционально)

Шаги:
1. Проверить существование projects/{project_name}/
- Если существует → ошибка или спросить о перезаписи
2. Прочитать templates/{category}/{template_name}/template.yaml
3. Запросить значения для {{VARIABLES}}
- Или использовать defaults из template.yaml
4. Создать структуру директорий:
bash mkdir -p projects/{project_name}/{design,management,solution,infrastructure}
5. Скопировать файлы из templates/{category}/{template_name}/structure/
6. Заменить все {{VARIABLE}} на реальные значения
7. Создать design/PROJECT.md с описанием
8. Git commit:
bash git add projects/{project_name}/ git commit -m "feat: создан проект {project_name} из шаблона {template_name}"
9. Обновить platform/.claude/system-journal.md:
```markdown
### 2025-11-10: Создан проект {project_name}

Действие: Создание нового проекта из шаблона
Шаблон: {template_name}
Изменения:
- Создана структура проекта
- Применены переменные

Статус: ✅ Успешно
```

Выход:
- Готовая структура проекта
- Quick Start инструкция


ПРОЦЕДУРА: Обзор всех проектов

Шаги:
1. Сканировать projects/*/
2. Для каждого проекта:
- Прочитать design/PROJECT.md (название, описание)
- Прочитать management/README.md (статус)
- Проверить наличие solution/* (активные решения)
- Проверить последний commit в git log -- projects/{name}/
3. Классифицировать:
- ✅ ACTIVE — активная разработка
- 🏗️ INFRASTRUCTURE — инфраструктурный проект
- 📋 PLANNED — только проектирование
- ⏸️ PAUSED — приостановлен
- ✔️ COMPLETED — завершён
4. Вывести таблицу с основными метриками
5. Показать статистику:
- Всего проектов
- По статусам
- По типам


ПРОЦЕДУРА: Извлечь шаблон из проекта

Вход:
- source_project
- source_path
- template_name
- template_category

Шаги:
1. Проверить существование source
2. Создать структуру:
templates/{category}/{template_name}/ ├── template.yaml ├── README.md └── structure/
3. Скопировать файлы из проекта
4. Определить {{VARIABLES}} для параметризации
5. Заменить конкретные значения на {{VARIABLES}}
6. Создать template.yaml с метаданными:
yaml name: {template_name} category: {category} version: 1.0 created: 2025-11-10 variables: PROJECT_NAME: default: "my-project" description: "Название проекта" DATABASE_TYPE: default: "sqlite" options: [sqlite, postgresql]
7. Создать README.md с инструкцией
8. Обновить templates/catalog.yaml
9. Git commit
10. Обновить system-journal.md


ОГРАНИЧЕНИЯ

❌ НЕ РАБОТАЕТ В WORKSPACE MODE:

Глубокая работа с проектами:
- Нельзя запускать код из проектов
- Нельзя редактировать файлы проектов (только создание)
- Нельзя деплоить

Для этого:

Переключиться в Project scope:
"Начать работу с проектом marketplace"

КОНФИГУРАЦИЯ

scope: workspace
mode: overview

loaded_files:
  - platform/CLAUDE.md
  - registry/INDEX.yaml
  - registry/SEARCH-CASCADE.yaml
  - templates/catalog.yaml

cascade_enabled: true
registry_enabled: true
templates_enabled: true

journaling:
  system: platform/.claude/system-journal.md
  session: platform/.claude/last-session.md

access_level:
  platform: full
  templates: full
  projects: read_only
  registry: read_write
  archive: read_only

РЕЖИМЫ ВНУТРИ WORKSPACE

Overview Mode (по умолчанию)

Design Mode

Code Mode (ограниченный)


ПЕРЕКЛЮЧЕНИЕ

В Project scope:

Начать работу с проектом <NAME>
→ Переключение в Project scope + загрузка контекста проекта

В Platform scope:

Открыть платформу
→ Переключение в Platform scope + загрузка всей платформы

В Minimal scope:

Переключить в минимальный режим
→ Сброс всех правил

ПРИМЕРЫ

Пример 1: Обзор workspace

User: Покажи состояние workspace

Claude (Workspace Mode):
📊 Состояние Claude Code Workspace

Проекты: 3 активных
├── marketplace  ACTIVE
├── @infra-dev-prod-rf 🏗️ INFRASTRUCTURE
└── analytics 📋 PLANNED

Шаблоны: 16 доступных
├── by-task: 10 шаблонов
├── by-framework: 3 шаблона
└── by-project-type: 3 полных проекта

Реестр:
├── External libraries: 13
├── Internal components: 0 (TODO)
└── Archive code: не проиндексирован

Последние изменения:
- 2025-11-10: Обновлён реестр (registry MVP)
- 2025-11-09: Создана платформа
- 2025-11-09: Миграция проектов

Статус:  Всё работает

Пример 2: Создание проекта

User: Создать проект crm используя шаблон streamlit-mvp-v1

Claude (Workspace Mode):
Создаю проект crm из шаблона streamlit-mvp-v1...

📋 Требуются переменные:

1. PROJECT_NAME: crm  (авто)
2. DATABASE_TYPE:
   - sqlite (по умолчанию)
   - postgresql

   Выбор: sqlite

3. AUTH_ENABLED (yes/no): yes

Создаю структуру...

 Проект создан:

projects/crm/
├── design/
   ├── PROJECT.md
   └── ROADMAP.md
├── management/
   ├── README.md
   └── CHANGELOG.md
└── solution/
    └── mvp/
        ├── app.py
        ├── requirements.txt
        └── ...

Quick Start:
```bash
cd /opt/claude-workspace/projects/crm/solution/mvp/
pip install -r requirements.txt
streamlit run app.py

Готово! Переключиться на проект? (да/нет)
```


Текущий режим: Workspace Mode
Cascade: Enabled
Registry: Enabled