Files
brokeless/CLAUDE.md
T

25 lines
1.6 KiB
Markdown

# broke
Personal finance app. Next.js 15 (app router), Supabase (sign-in, Postgres, row-level security), Plaid and other bank feeds.
## Rules for any change
- **Bank data stays private.** Every AI path goes through `src/lib/llm/gate.ts`. A cloud model gets the summary only: rounded amounts, names replaced by tokens. Full detail goes only to a local model. Never add another path.
- **No AI API keys.** AI runs on the person's own signed-in app (Claude Code, Codex, Gemini CLI, opencode), a local model, or their OpenRouter sign-in.
- **Tools stay off for prompts from a website.** The helper (`public/broke-connect.cjs`) only runs AI apps with no tools at all. Don't add one that can read files.
- **Every table has row-level security.** Secrets like `plaid_items.access_token` have no policies, so only the server's secret key reads them.
- **Advice depends on country.** Use `countryOf` and the tax modules in `src/lib/countries.ts`. Never assume the US.
- **Never show test data to someone on real banks.**
- **Tests use throwaway `@broke.test` users**, created and deleted with the admin client. Never read a real person's rows to test.
## Writing
Sentence case. Plain short sentences. No em dashes.
## Working here
- `npm run dev`: reloads on every edit. Keys go in on http://localhost:3000/setup.
- Database changes: add the next numbered file in `supabase/migrations/`. It applies on start, or with `npm run migrate`.
- Checks: `npm run lint`, `npx tsc --noEmit`, and pure libraries with `node src/lib/<name>.test.ts`.
- `scripts/e2e-sandbox.mjs` runs a throwaway user through every page.