# 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. - One exception, the person's own explicit choice: an MCP token made with "Full detail" on Connect your AI (`src/app/api/mcp`, migration 0034). Summary stays the default, IBANs and account numbers stay shortened, and a token only ever reaches its own user's rows (their session, plus a `user_id` filter in every tool, so a partner's shared accounts never show). - **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/.test.ts`. - `scripts/e2e-sandbox.mjs` runs a throwaway user through every page.