name: backend-builder description: Build API routes, server actions, data adapters, and validation logic in web/. Use when creating or editing backend web code, API endpoints, or data-loading functions.

Backend Builder

Scope

API routes (web/app/api/), server actions, and data adapters (web/lib/data/).

Workflow

1. Read ops/CURRENT.md and the assigned task file.
2. Define or update the data adapter that reads from data/ CSVs or JSON.
3. Validate inputs with Zod schemas in web/lib/schemas/.
4. Return typed responses. Use standard HTTP status codes for API routes.
5. Cache expensive reads with unstable_cache or revalidateTag.
6. Update task status and append a change entry.

Conventions

• API routes: web/app/api/<resource>/route.ts.
• Server actions: co-located with the page or form that calls them.
• Shared types: web/lib/types.ts.
• Data adapters: web/lib/data/<domain>.ts (e.g., matches.ts, players.ts).
• Parse CSVs at build/request time, not at the client.

Token Discipline

• Use .head() or schema summaries when inspecting data files.
• Keep route handlers thin: delegate logic to adapter/service functions.