adinsights-contract-guard

Classifies risk of ADinsights API/data/integration changes and outputs a structured decision packet.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/cpowe-ADT/ADinsights --skill adinsights-contract-guard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adinsights-contract-guard
Source: https://github.com/cpowe-ADT/ADinsights/tree/main/docs/ops/skills/adinsights-contract-guard
Command: npx skills add https://github.com/cpowe-ADT/ADinsights --skill adinsights-contract-guard

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Quickly assess the risk impact of proposed ADinsights API/data/integration changes, flagging potential contract-breaking or docs-missing issues before merging.

Core Features & Use Cases

  • Contract classification: Analyze prompts, code changes, and surface touches to categorize risk levels.
  • Evidence-backed decisions: Produce a structured decision packet with contract_surfaces_touched, required_docs_updates, required_tests, reviewers, and next actions.
  • Guardrail automation: Enforce CI-strict behavior and document how to proceed for breaking vs non-breaking changes across API, data, and integration surfaces.

Quick Start

Run the contract guard against your latest change set to obtain a decision packet.

Frequently Asked Questions about adinsights-contract-guard

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

FAQPage Schema
How do I classify API contract risk for integration changes before merging?

To classify API contract risk for integration changes, analyze prompts and changed files to determine touched surfaces and identify missing docs or tests. The tool produces a structured decision packet with rationale, evidence, and next actions for CI enforcement.

What is a contract decision packet and how does it enforce CI strictness?

A contract decision packet is a machine-readable output containing contract_surfaces_touched, required_docs_updates, required_tests, reviewers, and next actions. It enforces CI strictness by evaluating breaking vs non-breaking changes across API, data, and integration surfaces.

How do I check if data contract changes are missing required tests or documentation?

To check if data contract changes are missing tests or documentation, analyze changed files and path hints against touched surfaces. The output flags missing required docs updates and required tests, providing rationale and next actions to resolve the gaps.

Can I use contract risk classification to detect breaking integration contract modifications?

You can use contract risk classification to detect breaking integration contract modifications by evaluating path hints and changed files. It categorizes touched surfaces and returns a structured packet detailing whether the modifications break integration contracts.

Does contract risk classification work with pyyaml dependencies for CI automation?

Contract risk classification works with pyyaml dependencies for CI automation by enforcing CI-style strictness options. It analyzes prompts and changed files to output a machine-readable packet, ensuring API and data contract changes meet strict CI requirements.

What are the limitations of automated contract risk classification for API changes?

Automated contract risk classification for API changes relies on analyzing prompts, changed files, and path hints to determine touched surfaces. It requires accurate file inputs and path hints to correctly identify missing docs or tests and enforce CI strictness.