Cline rules

1# Development Workflow
2 
3## Brief overview
4 
5Standard development commands and workflow for the proxy-llms project.
6 
7## Local commands
8 
9- Install dependencies: `pnpm install`
10- Run locally: `pnpm run dev`
11- Typecheck: `pnpm run typecheck`
12- Run tests: `pnpm run test`
13- Run tests in watch mode: `pnpm run test:watch`
14- Run tests with coverage: `pnpm run test:coverage`
15- Deploy: `pnpm run deploy`
16 
17## Validation script
18 
19The `validate` script runs all checks in sequence:
201. `lockfile-lint`
212. `oxlint`
223. `tsc --noEmit`
234. `vitest run`
24 
25```bash
26pnpm run validate
27```
28 
29## Development workflow
30 
311. **Review the request, think about it, and brainstorm**
322. **Ask clarifying questions** (when needed)
333. **Think hard and make a plan**
344. **Only when we agree on a plan, create a detailed to-do list** using the `task_progress` parameter
355. **If writing code, add these review tasks at the end of the to-do list:**
36   - A. Run `pnpm run typecheck`
37   - B. Run `pnpm run test`
38   - C. Review against routing pattern: `./src/routes/index.ts` must be declarative
396. **Once we agree on the to-do list, start implementation**
407. **During implementation:**
41   - Keep things simple and stick to the requested scope
42   - Do NOT over-complicate things
43   - Do NOT add unnecessary complexity
448. **At the end, verify:**
45   - All tests pass (`pnpm run test`)
46   - TypeScript compiles cleanly (`pnpm run typecheck`)
47   - Routing pattern is respected (declarative `./src/routes/index.ts`)
48 
49## Testing
50 
51- Tests live in `./src/__tests__/*.test.ts` and run with Vitest
52- The setup file `./src/__tests__/setup.ts` mocks `globalThis.crypto.randomUUID` for Node.js compatibility
53- Always run `pnpm run test` after modifying `./src/server.ts`, `./src/config/providers.ts`, or any test file
54