| # 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. | |