Быстрый справочник

/opt/claude-workspace/
├── system/          # Системные компоненты
├── platform/        # Platform v1
├── platform-v2/     # Platform v2 (будущее)
├── projects/        # Проекты
├── infra/           # Инфраструктура
├── components/      # Компоненты
├── library/         # Библиотеки
├── templates/       # Шаблоны
└── scripts/         # Скрипты

CLAUDE.md        — Для AI агента
README.md        — Для людей
index.yaml       — Навигация
config.yaml      — Инфраструктура (только в infra/)
PROJECT.md       — Описание проекта

APPLICATION   — Приложение с кодом
PLATFORM      — Платформа/фреймворк
TEMPLATE      — Шаблон
UTILITY       — Утилита

ready    — Готовая (только config.yaml)
project  — Создаваемая (с CLAUDE.md и solution/)

Orchestrator    — Управление workspace
Project-agent   — Работа в проекте
Infra-agent     — Создание инфры
Claude Code     — Знание инструментов
Terminal        — Интерфейс
Integrator      — API и интеграции

Уровень 1 (80%):  CLAUDE.md + index.yaml         (~1-2K tokens)
Уровень 2 (15%):  + spec.md + procedures.md      (~5-10K tokens)
Уровень 3 (5%):   + весь код                     (~20-50K tokens)

planning → development → testing → staging → production → archived

Формат: MAJOR.MINOR.PATCH
Пример: 1.0.0 → 1.1.0 → 2.0.0

git status
git add .
git commit -m "feat: description"
git push origin main
git pull origin main

git branch feature/new-function
git checkout feature/new-function
git merge feature/new-function

git tag v1.0.0
git push --tags

cat /opt/claude-workspace/index.yaml
# Искать в projects:

cat /opt/claude-workspace/index.yaml
# Искать в infrastructure:

cat index.yaml
# Смотреть files:

mkdir -p projects/{name}/{design,management,solution/code}
touch projects/{name}/CLAUDE.md
touch projects/{name}/README.md
touch projects/{name}/index.yaml
touch projects/{name}/design/PROJECT.md

См. platform/procedures/ONBOARD_NEW_PROJECT.md

# Найти в config.yaml:
ssh user@host

git push origin main
# Webhook → Deploy script → Restart

curl -s -o /dev/null -w "%{http_code}" http://localhost:8503
# Ожидаем: 200

ps aux | grep streamlit

lsof -i :8503
# или
netstat -tulpn | grep 8503

pytest tests/
pytest --cov=modules/

streamlit run app.py

/opt/claude-workspace/system/docs/
├── CONCEPT.md
├── ARCHITECTURE.md
├── architecture/1-8.md
├── specifications/
└── reference/

/opt/claude-workspace/platform/procedures/
└── ONBOARD_NEW_PROJECT.md

/opt/claude-workspace/templates/
├── project/
├── component/
└── infra/

@infra-dev-pro:      91.218.142.168 (Hetzner EU)
@infra-dev-prod-rf:  [IP] (Hetzner RU)

@remote-beget-kondurov: kondurov.beget.tech

infra-yandex-disk:   Яндекс.Диск
s3-nomenclature:     S3 Beget

git push
git pull

scp file.txt user@server:/path/
rsync -avz local/ user@server:remote/

rclone sync local/ yandex:remote/

version: "1.0.0"
updated: "2025-11-19"
key: "value"

# Заголовок

Текст.

def function_name():
    pass

lowercase-with-dashes

UPPERCASE.md

snake_case.py

snake_case = value
CONSTANT_NAME = value

def function_name():
    pass

class ClassName:
    pass

feat:      Новая функция
fix:       Исправление бага
docs:      Документация
refactor:  Рефакторинг
test:      Тесты
chore:     Рутина

@latest  → последняя версия
@stable  → стабильная версия
@v1      → последняя в ветке v1

system/docs/CONCEPT.md

system/docs/ARCHITECTURE.md
system/docs/architecture/1-structural.md
system/docs/architecture/2-functional.md
...
system/docs/architecture/8-spatial.md

system/docs/specifications/file-formats.md
system/docs/specifications/naming-rules.md

system/docs/reference/glossary.md
system/docs/reference/quick-reference.md  ← Этот файл