architect/_archive/2025-11-13-before-restructure/root-docs/README.md

🚀 Claude Code Workspace

Централизованный workspace для управления инфраструктурой и проектами с Claude Code.

Версия: 1.1.0
Последнее обновление: 2025-11-08


📂 СТРУКТУРА

/opt/claude-workspace/
├── README.md                    # Этот файл
├── PROJECT-STANDARDS.md         # 📋 Стандарты ведения проектов
├── QUICK-START.md               #  Быстрый старт нового проекта
├── CLAUDE.md                    # Инструкции для Claude Code

├── templates/                   # 📝 Шаблоны документов
   ├── README.template.md
   ├── PROJECT-MASTER.template.md
   ├── CHANGELOG.template.md
   ├── DOCUMENTATION.template.md
   ├── ROADMAP.template.md
   ├── ARCHITECTURE.template.md
   ├── DEPLOYMENT.template.md
   ├── SECURITY.template.md
   ├── .env.example.template
   └── .gitignore.template

├── scripts/                     # 📚 Библиотека скриптов
   ├── create-project.sh        # Скрипт создания проекта
   ├── python/                  # Python шаблоны
   └── bash/                    # Bash скрипты

└── projects/                    # 🗂️ Проекты
    ├── @infra-dev-pro/          # Infrastructure: Control Plane
    ├── @infra-dev-prod-rf/      # Infrastructure: Production Platform
    └── marketplace-mvp/         # Application: MP1

🎯 БЫСТРЫЙ СТАРТ

Создать новый проект

# Прочитать инструкцию
cat /opt/claude-workspace/QUICK-START.md

# Или использовать скрипт (автоматизация)
bash /opt/claude-workspace/scripts/create-project.sh

Работать с существующим проектом

# Запустить Claude Code
cd /opt/claude-workspace
claude

# Сказать Claude:
# "Я хочу работать с проектом marketplace-mvp"

📚 ДОКУМЕНТАЦИЯ

Для создания проектов

  1. QUICK-START.md - Быстрая инструкция (15-30 мин)
  2. PROJECT-STANDARDS.md - Детальные стандарты
  3. templates/ - Шаблоны документов

Для работы с workspace

  1. CLAUDE.md - Инструкции для Claude Code
  2. scripts/ - Переиспользуемые скрипты

🗂️ АКТИВНЫЕ ПРОЕКТЫ

Infrastructure

Applications


🛠️ SCRIPTS

create-project.sh

Автоматическое создание проекта:

bash /opt/claude-workspace/scripts/create-project.sh

# Интерактивно спросит:
# 1. Имя проекта
# 2. Тип проекта (infrastructure/application/library/data)
# 3. Какие документы создать
# 4. Автоматически скопирует шаблоны и заполнит плейсхолдеры

📖 ПРАВИЛА РАБОТЫ

1. Каждый проект = своя папка

/opt/claude-workspace/projects/project-name/

2. Минимальный набор документов

3. Обновление документации

После КАЖДОГО значительного изменения:
- Обновить дату в документе
- Добавить запись в CHANGELOG
- Закоммитить

4. Git workflow

# Стандартный workflow
git status
git add .
git commit -m "тип: описание"
git tag v1.0.0  # При релизе

🔗 ПОЛЕЗНЫЕ ССЫЛКИ


📝 CHANGELOG

[1.1.0] - 2025-11-08

Added:
- PROJECT-STANDARDS.md - стандарты ведения проектов
- QUICK-START.md - быстрая инструкция
- templates/ - папка с шаблонами (10 шаблонов)
- Обновлена структура документации для mp1

Changed:
- Обновлён README.md workspace
- Дополнен CLAUDE.md

[1.0.0] - 2025-10-26

Added:
- Инициализация workspace
- Базовая структура папок
- CLAUDE.md для Claude Code


Последнее обновление: 2025-11-08
Maintainer: Claude Code Workspace Team