Skip to content
TakoAPI
Back to skills

jarvis-api-contract-guard-01

by xammarie

Browser & Automation
387Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Design and verify API contracts for backward compatibility.

Description

What This Skill Does

A structured workflow for designing and verifying API contracts with a focus on backward compatibility. Takes code, docs, and constraints as inputs, runs through defined checkpoints with quality gates, and returns prioritized findings with a concrete action plan.

The checkpoint-and-quality-gate structure forces evidence-backed claims and explicit tradeoffs, reducing the chance that risky changes ship without a documented fallback.

When to Use It

  • Checking an API change for breaking changes before merging
  • Turning informal notes into a ranked action plan with acceptance criteria
  • Reviewing a public endpoint refactor with rollback options documented
  • Planning a deprecation timeline with owner and ETA per step
  • Auditing a third-party integration contract before a release

Example Workflow

INPUT

User asks: Here's my updated /payments endpoint diff. Check it for backward compatibility issues and give me an action plan.

AGENT
  1. 1

    Defines success criteria: no breaking changes to existing consumers

  2. 2

    Identifies the smallest-valid execution path by listing all changed request/response fields

  3. 3

    Executes checkpoints: compares old and new schemas, flags removed fields and changed types

  4. 4

    Applies quality gates: confirms findings are evidence-backed and assumptions are explicit

  5. 5

    Returns ranked findings, a today/this-week action plan, risks with mitigations, and a checklist of exact fixes

OUTPUT

A prioritized list of compatibility issues, each with impact rating, a concrete fix or migration step, and a fallback if the primary plan fails

Installation

clawhub install xammarie/jarvis-api-contract-guard-01

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links