Routing

Use this skill when API path design, handler registration, route composition, and parameter behavior are core to the task.

Execution Workflow

1. Define endpoint contracts with semantic handler decorators and strict type annotations.
2. Choose composition model:
3. Register simple handlers directly on app.
4. Use routers for path grouping and nested route trees.
5. Use controllers for OOP-style endpoint grouping under a shared controller path.
6. Choose parameter sources and constraints (path/query/header/cookie/layered parameters).
7. Apply route metadata and indexing (name, opt) for discoverability and policy hooks.
8. Validate reverse-routing, unique path+method combinations, and layered precedence behavior.

Implementation Rules

• Keep URL design stable, resource-oriented, and version-aware.
• Keep handlers thin; delegate business logic to services.