audit-contracts

Audit end-to-end interface contracts for semantic, structural, and compatibility failures.

10|5|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/JHostalek/dotclaude --skill audit-contracts-jhostalek
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audit-contracts
Source: https://github.com/JHostalek/dotclaude/tree/main/skills/audit-contracts
Command: npx skills add https://github.com/JHostalek/dotclaude --skill audit-contracts-jhostalek

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill detects semantic, structural, lifecycle, and rollout failures where producers, consumers, services, schemas, or integrations disagree about an interface contract.

Core Features & Use Cases

  • End-to-End Contract Auditing: Reconstruct producer-consumer relationships across APIs, events, databases, files, CLIs, libraries, configuration, and external integrations.
  • Compatibility and Lifecycle Analysis: Evaluate backward, forward, mixed-version, deployment, migration, replay, rollback, deprecation, and recovery scenarios.
  • Evidence-Based Findings: Distinguish confirmed defects from improvements, intentional compatibility choices, active migrations, external constraints, and unresolved questions, with verification plans for each retained finding.
  • Use Case: Before rolling out a schema or API change, use this Skill to trace every affected producer, intermediary, consumer, generated artifact, stored representation, and supported deployment order.

Quick Start

Use the audit-contracts skill to review the API, event, schema, and integration contracts under the specified path and report verified compatibility risks with evidence and safe remediation steps.

Frequently Asked Questions about audit-contracts

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

FAQPage Schema
How do I detect API compatibility breaks between producers and consumers before deployment?

Contract auditing works by mapping producer-consumer relationships across APIs, events, databases, files, CLIs, and configuration, then analyzing invariants to distinguish confirmed defects from intentional compatibility choices or active migrations. Each retained finding includes a verification plan for explicit approval gates.

How do I audit schema evolution for event-driven systems during version skew and rollback?

Auditing schema evolution for event-driven systems requires tracing lifecycle scenarios including version skew, migration, replay, rollback, and recovery. The audit evaluates semantic, structural, and compatibility failures between event producers and consumers to ensure deployment safety across all supported deployment orders.

What is the best way to verify backward and forward compatibility across RPC and HTTP API changes?

The best way to verify backward and forward compatibility is architecture-led producer-consumer mapping with invariant analysis and variant searches. This approach evaluates mixed-version deployment scenarios and generates evidence-based findings with safe remediation steps and explicit approval gates for behavior changes.

Does contract auditing work for database schemas, file formats, and external integrations or just REST APIs?

Contract auditing works for database schemas, file formats, CLIs, libraries, configuration, and external integrations in addition to HTTP and RPC APIs. It reconstructs end-to-end interface contracts across all these boundaries to detect lifecycle and rollout failures where producers, consumers, or stored representations disagree.

Why do I need contract auditing for deployment workflows and migration scenarios?

You need contract auditing for deployment workflows because it detects rollout failures where producers, consumers, services, schemas, or integrations disagree about an interface contract. It traces every affected intermediary, generated artifact, and stored representation across migration, replay, rollback, deprecation, and recovery scenarios to ensure deployment safety.