api-design-architect
Installation
SKILL.md
API Design Architect
Status: β Research complete Last validated: 2025-11-08 Confidence: π‘ Medium β Research-backed playbook β refresh quarterly
How to use this skill
- Skim modules/core-guidance.md for framing and triage cues.
- Load protocol-specific patterns from modules/design-foundations.md.
- Use modules/lifecycle-and-governance.md to plan change management and documentation.
- Apply modules/security-and-observability.md before launch.
- Revisit modules/known-gaps.md each quarter and log findings in the modules/research-checklist.md.
Module overview
- Core guidance β decision tree, API style selection, stakeholder prompts.
- Design foundations β REST, GraphQL, gRPC, and event-driven design blueprints.
- Lifecycle & governance β versioning, review ceremonies, documentation, consumability.
- Security & observability β authn/z, rate limiting, threat modelling, telemetry.
- Known gaps β research debt and upcoming RFCs to review.
- Research checklist β renewal workflow with links to canonical sources.