workflow

Author: charleslien

backend-function-refactoring-plan.md

@@ -0,0 +1,33 @@
+# Backend Function Refactoring Plan
+
+## Objective
+
+Refactor all backend functions to use single object parameter pattern.
+
+## Workflow (Repeat until complete)
+
+1. **Discover** - Run code searches to find functions:
+
+   ```
+   code_search: ^(export )?(async )?function \w+\(
+   code_search: ^export const \w+ = (async )?\(
+   ```
+
+2. **Pick** - Select next unmigrated function (skip external callbacks like `.map()`, `.then()`, middleware)
+
+3. **Migrate** - Convert function signature and all call sites to use object parameter
+
+4. **Typecheck** - Run `bun run typecheck`
+
+   - If errors: fix and repeat step 4
+   - If success: proceed
+
+5. **Commit** - `git commit -m "refactor: convert [functionName] to use object parameter"`
+
+6. **Repeat** - Go back to step 1
+
+## Rules
+
+- Skip external library callbacks (array methods, promise chains, middleware, event handlers)
+- Use `params` or descriptive names (`options`, `config`)
+- Define interfaces when functions are called from multiple places