routing-http-api

What problem does it solve?

This Skill helps developers quickly locate, trace, and safely modify HTTP routes and request handlers in the Madoc TypeScript service so endpoints can be added or refactored without breaking middleware or permission checks.

Core Features & Use Cases

• Route mapping and discovery: Identify route entry points, domain groupings, and how route trees are composed.
• Handler tracing and refactoring: Follow exported handlers through modules to update logic and preserve registration patterns.
• Middleware and permissions validation: Verify and apply route-level middleware and permission guards consistently.
• Use Case: When adding an admin API endpoint, use this Skill to find the admin domain route, trace the handler implementation, and ensure the correct auth middleware is applied before exposing the route.

Quick Start

Map the route for the endpoint you are changing by opening services/madoc-ts/src/routes/root.ts, identify the domain folder and exported handler, and follow it through its module to update registration and middleware safely.