Feature Development Workflow

Phase 1: Context & plan

• Start with the docs index (if present) and follow the current plan links.

• Identify scope, constraints, and success criteria.

• Draft a short plan before editing code.

Phase 2: Backend (if needed)

• Update schema docs/migrations as required.

• Ask before applying migrations to a real project.

• Keep writes server-side and admin-gated.

Phase 3: Frontend

• Create or update routes in src/routes.

• Wire loaders and server functions as needed.

• Build UI with shadcn/ui + Tailwind.

• Use Query for server state and Zod for validation.

Phase 4: Verification

• Run bun run build, bun run tsc (if available), bun run lint, bun run check.

• Self-review against AGENTS.md and repo instructions.

Tooling

• Use Serena for repo exploration/edits.

• Use TanStack MCP for TanStack APIs.

• Use shadcn MCP for UI components/patterns.

• Use Supabase MCP for DB/RLS.