🌐 API Domain Ecosystem

Welcome to the api domain ecosystem. This directory contains specialized agentic skills for designing, scaling, securing, and evolving Application Programming Interfaces (REST, GraphQL, gRPC).

For Orchestrator Agents (task-decomposer, parallel-planner): When asked to plan an API-related task, you MUST consult the workflows below. Do not hallucinate steps; map your plan strictly to these available skills in the order defined.

🔄 Standard Workflows & Handoffs

1. OpenAPI-First Design Flow

When the user asks to "design a new API", "create endpoints", or "build an API from scratch", execute these skills sequentially:

1. @contract-first-designer -> Designs the OpenAPI/Swagger specification or GraphQL schema.
2. @api-mock-designer -> Generates mock servers and fake data responses based on the contract.
3. @sdk-scaffolder -> Generates client SDKs or typed interfaces (e.g., TypeScript interfaces) from the contract.