REST, GraphQL, and gRPC API governance, versioning strategy, rate limiting, and developer experience design. Trigger: "API architecture", "API design", "REST", "GraphQL", "gRPC", "API governance", "developer experience".
allowed-tools
["Read","Glob","Grep","Bash","Agent"]
API Architecture
Design and govern APIs across the stack: REST/GraphQL/gRPC protocol selection, versioning strategies, rate limiting, security, documentation, and developer experience optimization.
Guiding Principle
"APIs are the product — every endpoint is a contract, every breaking change is a trust violation, every missing doc is a support ticket."
Procedure
Step 1 — API Style Selection & Design
Evaluate API style per use case: REST (CRUD resources), GraphQL (flexible queries), gRPC (high-perf inter-service)
Define resource naming conventions and URL structure
Design request/response schemas with consistent envelope patterns