api-contract-review

Review API contracts for breaking changes, versioning, and governance gaps.

3|Updated Mar 24, 2026

Search Tags:#versioning #api #compatibility #governance #software-engineering #contract-review

Ready to run

npx skills add https://github.com/ldilov/harness-forge --skill api-contract-review-ldilov

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: api-contract-review
Source: https://github.com/ldilov/harness-forge/tree/main/.agents/skills/api-contract-review
Command: npx skills add https://github.com/ldilov/harness-forge --skill api-contract-review-ldilov

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a discoverable wrapper to enable standardized reviews of API contracts, ensuring consistency in governance and safety checks when contracts change.

Core Features & Use Cases

Discoverable surface for project-owned API contract review logic and references.
Central activation and routing for contract-change events to enforce governance and compatibility checks.
Clear surfaces and documentation references to support auditability and reproducibility of contract reviews.

Quick Start

Trigger on API contract changes to invoke the canonical contract-review surface and surface governance notes for downstream validation.

Frequently Asked Questions about api-contract-review

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

FAQPage Schema

How do I review API contracts for breaking changes and governance gaps?▼

API contract review detects breaking changes, misalignments, and governance gaps across HTTP, event, schema, protobuf, or generated client contracts. It ensures consumer safety and standards compliance when contracts change.

What types of API contracts can I check for versioning and compatibility issues?▼

You can review HTTP, event, schema, protobuf, and generated client contracts. The process detects breaking changes and misalignments across these code surfaces to validate versioning and compatibility.

When do I need to perform an API contract review?▼

You need an API contract review when contracts change. Triggering on contract-change events surfaces governance notes and enforces compatibility and consumer safety validation.

Does this API contract review approach work with protobuf and event schemas?▼

Yes, the review applies to protobuf and event schemas, plus HTTP and generated client contracts. It detects breaking changes and misalignments across these surfaces to enforce standards-compliant governance.

How do I ensure API governance and auditability during contract changes?▼

Trigger standardized contract reviews on change events to route compatibility checks and surface governance notes. Documentation references support auditability and reproducibility of the reviews.

What are the limitations of basic API contract review for compatibility checks?▼

The basic implementation provides a discoverable wrapper and routing logic for contract changes rather than deep automated analysis. It surfaces governance notes and references validation documentation for downstream checks.