metodologia-api-architecture

Define API architecture strategy and governance for REST, GraphQL, gRPC, and AsyncAPI portfolios.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/JaviMontano/metodologia-propuesta-agent-public --skill metodologia-api-architecture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: metodologia-api-architecture
Source: https://github.com/JaviMontano/metodologia-propuesta-agent-public/tree/main/.claude/skills/architecture/api-architecture
Command: npx skills add https://github.com/JaviMontano/metodologia-propuesta-agent-public --skill metodologia-api-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps organizations design and govern API architectures across multiple surfaces (REST, GraphQL, gRPC, AsyncAPI) while enabling a solid Developer Experience and a measurable governance lifecycle.

Core Features & Use Cases

  • Contract-first governance and standardized API contracts across teams.
  • Lifecycle management including versioning, deprecation, and sunset policies.
  • Developer Experience enhancements: docs, SDKs, sandboxes, changelogs, and catalogs.
  • API portfolio governance: design reviews, linting, health scoring, and cataloging.

Quick Start

Provide the system name to tailor an API architecture plan and generate a governance outline.

Frequently Asked Questions about metodologia-api-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I implement contract-first API governance across multiple teams?

API governance establishes contract-first workflows using OpenAPI and AsyncAPI specifications, enforcing design reviews and linting across REST, GraphQL, gRPC, and AsyncAPI surfaces. It standardizes versioning, deprecation policies, and security patterns while generating measurable health scores through an automated dashboard.

What is contract-first API design and when should my organization adopt it?

Contract-first API design defines your API specification in OpenAPI or AsyncAPI before writing code, ensuring teams build against a shared agreement. Adopt it when managing REST, GraphQL, gRPC, or AsyncAPI surfaces to enforce consistent security patterns like OAuth2 and mTLS across public, partner, and internal APIs.

How do I manage API versioning and deprecation policies for a large portfolio?

API versioning and deprecation policies manage portfolio lifecycle changes by defining sunset schedules and backward-compatible versioning strategies across REST, GraphQL, and gRPC surfaces. You enforce these standardized workflows through governance scoring and an automated health dashboard to maintain stability.

Does this API architecture approach work for both REST and AsyncAPI surfaces?

Yes, this API architecture approach supports REST, GraphQL, gRPC, and AsyncAPI surfaces across public, partner, and internal APIs. It applies unified governance, security patterns including OAuth2 and mTLS, and developer experience features like sandboxes, SDKs, and catalogs to all protocol surfaces.

What's the best way to improve developer experience for API consumers?

Improving API developer experience involves providing comprehensive documentation, auto-generated SDKs, interactive sandboxes, changelogs, and a centralized API catalog. These features let consumers discover, test, and integrate APIs efficiently while governance scoring ensures the catalog maintains high quality and usability standards.

Can I apply OAuth2 and mTLS security patterns across internal and partner APIs?

Yes, you can apply OAuth2 and mTLS security patterns across public, partner, and internal APIs. The architecture strategy standardizes these security patterns within the governance framework, ensuring consistent authentication and authorization enforcement across all REST, GraphQL, gRPC, and AsyncAPI surfaces.