Orqestria Download
← Back to the catalog

Skill · Version 1.0.0

API compatibility review

Reviews changed interfaces for effects on existing clients, queued work and the error behavior integrations already depend on.

api-compatibility-review

See how it helps

When is it useful?

Use when an endpoint or shared interface changes and older clients must keep working.

What does it help you do?

  • Finds internal callers, older browser sessions and queued messages affected by changed fields.
  • Checks required inputs, response types, defaults and pagination for breaking changes.
  • Reviews structured errors, retry protection and stale-update handling together.

Try asking this

Review removing the order status field: identify affected consumers and propose a compatible transition. Replay an old client request and a queued event against the proposed contract. Show which consumer breaks and how the transition keeps it working.

Detailed documentation

Read the skill’s original instructions, examples and checks in their authored language.

Details…Show less

API & Compatibility Review

Use this skill when reviewing changes that touch HTTP/REST/GraphQL/RPC endpoints, webhook/event payloads, CLI flags, configuration keys, or exported module signatures.

Workflow

  1. Inventory all consumers of the modified interface:
    • Search the entire monorepo or project (grep / symbol references) for every internal caller, UI client, SDK wrapper, background worker, and test fixture that consumes the changed interface.
    • Consider external or persisted consumers: saved webhooks, queued job payloads already in flight, browser tabs running slightly older frontend bundles, and external API clients.
  2. Check for breaking contract changes:
    • Request / Input contract:
      • Making an optional field required without a default value.
      • Narrowing accepted enum values, types, or validation bounds without migrating existing callers.
      • Renaming or removing query parameters, headers, or body properties.
    • Response / Output contract:
      • Removing, renaming, or changing the type/nullability of returned fields.
      • Changing pagination structure, sorting defaults, or error status codes/codes that clients branch on.
    • Configuration & environment defaults:
      • Changing a default config value in a way that alters production behavior when the env var is unset.
  3. Verify error contracts and idempotency:
    • Confirm that validation failures, missing resources, permission denials, and version conflicts return the project's standard structured error codes and HTTP statuses.
    • Verify that mutating endpoints preserve idempotency and concurrency guards (expectedVersion, Idempotency-Key).

Included files 1

  • SKILL.md

About this skill package

api-compatibility-review

api-compatibility-review: Review specifications and code against acceptance criteria, business invariants and security boundaries before delivery.

Details…Show less

api-compatibility-review

api-compatibility-review: Review specifications and code against acceptance criteria, business invariants and security boundaries before delivery.

Includes the complete skill and its supporting files (1 files). The exact authored scope is preserved below.

Original skill description (source language)

Use when auditing changes to HTTP/RPC endpoints, events, schemas, and shared TypeScript/module interfaces for backward compatibility, caller impact, and contract fidelity.

Install the skill, review its source and trust settings, then enable it for the relevant project or agent.

Requirements

  • Orqestria installed on your computer.