CLAUDE.md

Deployment

HF Spaces deployment is fully automated via .github/workflows/deploy-hf.yml. Pushing to origin/main triggers the workflow which runs ./deploy.sh --force and pushes to all three Spaces (Chatterbox, OmniVoice, Qwen3). Do not run ./deploy.sh locally after a push — it is redundant. To verify a deploy, use gh run list --workflow=deploy-hf.yml.

graphify

This project has a graphify knowledge graph at graphify-out/.

Rules:

• Before answering architecture or codebase questions, read graphify-out/GRAPH_REPORT.md for god nodes and community structure
• If graphify-out/wiki/index.md exists, navigate it instead of reading raw files
• For cross-module "how does X relate to Y" questions, prefer graphify query "<question>", graphify path "<A>" "<B>", or graphify explain "<concept>" over grep — these traverse the graph's EXTRACTED + INFERRED edges instead of scanning files
• After modifying code files in this session, run graphify update . to keep the graph current (AST-only, no API cost)