CLAUDE.md — правила проекта cyb

Архитектура

Bevy — корневой runtime. Один бинарник для всех платформ.

/                    Rust workspace (Cargo.toml, Makefile)
├── shell/           Bevy desktop runtime — package/bin `cyb`, all worlds
├── apps/            Leptos WASM web apps — loaded via WebView in Portal world
├── reference/       Спецификация, roadmap
├── graph/           Knowledge graph pages
├── docs/            Документация

Внешние зависимости:

• ~/cyber/nu/ — форк nushell (nu-protocol, nu-engine, sugarloaf и др.)
• ~/cyber/evy/forks/naga/ — форк naga (shader compiler)

One Binary Rule

WebView is only for web content (Portal world). All other rendering — terminal, graph, 3D, UI — is pure Rust via Bevy + wgpu. No JS bundles, no external runtimes embedded in the binary.

Android = desktop. The Android build is the same app, same Bevy, same worlds, same terminal, same nushell. The only Android-specific addition is nu_plugin_android which exposes hardware APIs (GPS, camera, sensors, etc.) that desktop doesn't have. There is no separate Android UI or Android terminal — it's one codebase.

Worlds

Сборка

# Bevy shell (desktop):
make build                         # debug build
make run                           # release run
make dmg                           # macOS release + DMG

# Leptos apps:
make apps                          # trunk build --release

# Android:
make android                       # full: rust + assets + apk

# Dev:
make dev                           # cargo run -p cyb

Проверка после изменений

• Shell: cargo check -p cyb
• Apps: cd apps && trunk build --release
• Release: make dmg
• Android: make android

Git

• Push только по запросу
• Атомарные коммиты

Планы и решения

.claude/plans/ — утверждённые планы. reference/roadmap.md — общий roadmap.