Skip to content

CLAUDE.md

Latest commit

 

History

History
50 lines (36 loc) · 1.87 KB

CLAUDE.md

File metadata and controls

50 lines (36 loc) · 1.87 KB

CLAUDE.md

AI agent guidance for phoenixvc/deck.

Project

Deck — desktop ops tool for the phoenixvc ecosystem. Tauri 2.0 desktop app with a VSCode-style shell, service manager, infrastructure panel, and .NET sidecar.

Extracted from mystira-workspace/apps/devhub (March 2026). Not yet onboarded to retort.

Stack

  • Frontend: React 18 + TypeScript 5 + Vite 5 + Tailwind CSS (in app/)
  • Desktop: Tauri 2.0 + Rust (in app/src-tauri/)
  • CLI sidecar: .NET 9 — Deck.CLI/
  • Services: .NET 9 — Deck.Services/
  • Contracts: Rust crate — crates/deck-contracts/

Conventions

  • TypeScript: 2-space indent, double quotes, semicolons, Prettier
  • Rust: 4-space indent, 100 char width, edition 2021, stable toolchain
  • C#: 4-space indent, Allman braces, PascalCase, nullable enabled
  • Commits: conventional commits (feat/fix/docs/refactor/chore...)

Key commands

cd app && npm run dev           # Vite dev server
cd app && npm run tauri dev     # Full Tauri desktop
cd Deck.CLI && dotnet run       # .NET CLI sidecar
cargo build                     # Rust crates
cargo test                      # Rust tests

Architecture notes

  • The Tauri frontend (app/src/) uses a VSCode-style layout (VSCodeLayout component)
  • Navigation is via VIEWS constants in app/src/types/constants.ts
  • Adding a new panel: add a VIEWS entry, add an ACTIVITY_BAR_ITEMS entry in App.tsx, add a route in AppContent.tsx
  • The .NET CLI sidecar communicates via JSON stdin/stdout through Tauri's shell plugin
  • deck-contracts (Rust) defines shared types between the Tauri backend and .NET sidecar

Ecosystem peers

See README.md for the full ecosystem table. Key integrations:

  • retort: agent scaffolding (onboarding pending)
  • sluice: AI call routing
  • docket: cost tracking
  • phoenix-flow: PR automation triggers