İçeriğe geç
TakoAPI
Becerilere dön

jarvis-api-contract-guard-01

xammarie tarafından

Browser & Automation
387İndirme sayıları clawskills.sh tarafından bildirilir
0Görüntülenmeler
0 beğeniBu beceriyi beğenmek için giriş yapın
—Henüz değerlendirilmedi
Puanınız

Özet

Design and verify API contracts for backward compatibility.

Açıklama

Bu Beceri Ne Yapar

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.

Ne Zaman Kullanılır

  • 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

Örnek İş Akışı

GİRİŞ

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

AJAN
  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

ÇIKIŞ

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

Kurulum

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

CLI komutunu çalıştırın ya da istemi Claude Code, Cursor, Codex veya kullandığınız kodlama ajanına yapıştırın.

Bağlantılar