From pdm-cross-team-coordination
Document a clear API contract between teams — setting expectations on endpoints, data formats, SLAs, and versioning before development begins.
How this skill is triggered — by the user, by Claude, or both
Slash command
/pdm-cross-team-coordination:api-contractThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Document a clear API contract between teams — setting expectations on endpoints, data formats, SLAs, and versioning before development begins.
Document a clear API contract between teams — setting expectations on endpoints, data formats, SLAs, and versioning before development begins.
Contract Name: [API Name] v[version] Provider Team: [Team] Consumer Teams: [Teams] Agreed Date: [Date] Review Date: [Date — e.g., before code freeze]
Base URL: https://api.example.com/v2/
Authentication: Bearer Token / API Key / OAuth2
Rate Limits: 1000 req/min per consumer
Endpoints
| Method | Endpoint | Description | Response | SLA |
|---|---|---|---|---|
| GET | /users/{id} | Fetch user by ID | User object | < 200ms p95 |
| POST | /orders | Create new order | Order ID | < 500ms p95 |
| DELETE | /orders/{id} | Cancel order | 204 No Content | < 200ms p95 |
Error Codes
| Code | Meaning | Consumer Action |
|---|---|---|
| 400 | Bad request | Fix request payload |
| 401 | Unauthorized | Refresh token |
| 404 | Not found | Handle gracefully |
| 429 | Rate limited | Retry with backoff |
| 500 | Server error | Alert and retry |
Versioning Policy
Sandbox / Mock
Mock server available at: https://mock-api.example.com/v2/
/integration-plan or /handoff-templateCreates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub devmuslim/pdm-skills --plugin pdm-cross-team-coordination