coding-standards

Apply the conventions in this Skill during code reviews and refactoring: descriptive naming, immutability via spread operators, typed function signatures, and comprehensive error handling. Pair with linting and type-checking tools for automated enforcement.

Define a typed props interface, use destructured parameters with defaults, and keep components small. Use custom hooks for reusable logic, functional state updates, memoization with useMemo and useCallback, and lazy loading for heavy components.

Use Zod schemas to define expected shapes, then parse incoming JSON in the route handler. On ZodError, return a 400 response with a consistent error structure including validation details.

Direct mutation breaks React change detection and causes stale-state bugs. Use the spread operator to create updated copies, such as {...user, name: 'New Name'} or [...items, newItem], keeping updates predictable and traceable.

Avoid comments that restate what the code obviously does, like 'increment counter'. Reserve comments for explaining why a decision was made, such as performance trade-offs or non-obvious workarounds, and use JSDoc for public APIs.