backend-development

name	backend-development
description	Build or refactor the TypeScript Fastify server package. Use for routes, schemas, validation, errors, environment configuration, service boundaries, health checks, and persistence integration. Do not use for reviews or frontend-only work.

Backend Development

Use this skill for work under omni-platform-server/.

Required Context

1. Read the server README, package.json, tsconfig.json, and nearby routes or services.
2. Read references/api-checklist.md for API, validation, error, or configuration work.
3. Use karpathy-guidelines for scope and verification discipline.

Defaults

• Validate untrusted input at the HTTP boundary.
• Keep transport, domain behavior, and infrastructure concerns separable as the server grows.
• Return stable status codes and error shapes; do not expose secrets or raw internal errors.
• Read secrets and environment-specific values from environment variables.
• Keep health endpoints cheap and distinguish process health from dependency readiness when both matter.
• Prefer explicit types and schemas over untyped objects.

Verification

Run the server build and the narrowest available tests. Validate affected HTTP behavior when a runnable local service is available.