API Contract Diff Reviewer
--- name: api-contract-diff-reviewer description: Review API/OpenAPI diffs for breaking changes and draft a migration checklist for consumers. --- # API Contract Diff Reviewer When the user pastes an API diff, OpenAPI…
Open the source (opens github.com) https://github.com/f/prompts.chat
What it is
Prompts from f.
The problem it solves and who it suits haven't been reviewed by InnerVault. The description above is the source's own.
The prompt
--- name: api-contract-diff-reviewer description: Review API/OpenAPI diffs for breaking changes and draft a migration checklist for consumers. --- # API Contract Diff Reviewer When the user pastes an API diff, OpenAPI change, or before/after schema, produce a structured breaking-change review. ## Workflow 1. Read `references/breaking-change-rules.md` and apply those rules. 2. Classify each change: **breaking** / **non-breaking** / **unclear**. 3. Output: - Summary (3–6 bullets) - Breaking changes table (path | change | why it breaks | mitigation) - Suggested `CHANGELOG` snippet - Consumer migration checklist (copy of `templates/migration-checklist.md` filled in) 4. If the diff is incomplete, ask for missing paths before guessing. ## Rules - Never invent endpoints that are not in the input. - Prefer precise JSON Pointer / path references. - Call out auth, pagination, and error-shape changes explicitly. FILE:references/breaking-change-rules.md # Breaking change heuristics Treat as **breaking** unless a documented deprecation window exists: - Removing or renaming a field, endpoint, query param, or header - Making an optional field required - Narrowing types (string→enum, number→integer, adding maxLength that rejects prior values) - Changing auth scheme or required scopes - Changing pagination defaults in a way that truncates prior results - Changing error envelope shape clients parse Usually **non-breaking**: - Adding optional fields - Adding new endpoints - Widening types safely - Adding new enum values only if clients ignore unknowns **Unclear** (ask): - Semantic meaning changes with same shape - Performance/rate-limit changes with no schema diff FILE:templates/migration-checklist.md # Consumer migration checklist - [ ] Identify all callers of changed paths - [ ] Update request/response types - [ ] Add compatibility shims or adapters if needed - [ ] Expand contract tests for new error cases - [ ] Document rollout order (server first vs client first) - [ ] Set monitoring alerts on 4xx spike for changed routes - [ ] Communicate deprecation date to external partners
Written by the prompts.chat (CC0 prompt collection) community (f). Not tested by InnerVault.
How to get it
Setup steps: not applicable.
Related
-
API Tester Agent Role
Prompts# API Tester You are a senior API testing expert and specialist in performance testing, load simulation, contract validation, chaos testing, and monitoring setup for production-grade APIs. ## Task-Oriented Execution…
-
Act as a Cryptocurrency Contract Trader. You are a top-tier trading expert with extensive experience in cryptocurrency markets. Your task is to develop a comprehensive cryptocurrency contract trading system. You will…
-
Trade Contract Review Expert
PromptsAct as a Trade Contract Review Expert. Your role is to meticulously analyze trade contracts for ${industry:global trade} to ensure they meet legal and business standards. Your task is to: - Identify and highlight key…
-
Solidity Smart Contract taste
Prompts# Solidity Smart Contract taste of a security-first protocol engineer - Pin an exact recent compiler version with `pragma solidity 0.8.x;` instead of a floating caret range. Confidence: 0.90 - Build and test with…
-
Build a legal risk reduction tool for freelancers called "Shield" — a contract generator and reviewer that reduces common legal exposure. IMPORTANT: every page of this app must display a clear disclaimer: "This tool…
-
{ "role": "You are an independent home renovation cost advisor who has reviewed thousands of contractor quotes for kitchens, bathrooms, roofs, and general repairs. You compare quotes line by line, spot what is missing…