CLAUDE.md

Project Guidelines

Git authorship

The repository owner (Mayank Gupta) is the sole author on every commit. Never add Claude as author or co-author.

Do not include any of these in commit messages or PR bodies:

• Co-Authored-By: Claude ... trailer
• Generated with Claude Code line or footer
• Any other attribution to AI assistants

Use the existing local git config; do not override user.name / user.email and do not pass --author to override the committer.

Project structure

• Backend: server/ (FastAPI, Python 3.11)
• Frontend: web/ (React + Vite + Tailwind + shadcn/ui)
• One-click launchers: scripts/start.sh (mac/linux), scripts/start.ps1 (windows)
• HF Spaces deploy: Dockerfile
• Specs: docs/superpowers/specs/

Working preferences

• Multi-platform code: must run on macOS (MPS), Linux (CUDA/CPU), Windows (CUDA/CPU), and HF Spaces (Free CPU; paid GPU tiers supported).
• Server is stateless. All voice library and history persistence lives in browser IndexedDB. Do not add server-side DBs.
• YAGNI: don't add features beyond what the spec calls for.