qa-contract-testing plugin
Contract testing for microservices: Pact consumer and provider tests, OpenAPI, GraphQL and Protobuf breaking-change checks, and a combined deploy gate. The gate aggregates Pact can-i-deploy, oasdiff, graphql-inspector and buf breaking into one go / no-go verdict. Agents (contract-drift-investigator, contract-test-scaffolder) trace contract drift to its source and scaffold contract tests from a spec.
How to install the qa-contract-testing plugin
Run both commands inside Claude Code. The first adds the marketplace once; the second installs the plugin.
/plugin marketplace add testland/qa
/plugin install qa-contract-testing@testland-qaWhat's inside qa-contract-testing
7 parts read from the plugin's own files.
Agents 2
Call as @agent-qa-contract-testing:name- @agent-qa-contract-testing:contract-drift-investigatorsonnet
Use proactively whenever a contract test fails or can-i-deploy says no, before opening a fix. Diffs Pact files, OpenAPI, GraphQL SDL or Protobuf against the last green baseline and says whether the provider, the schema, the consumer expectation or the test data changed, with file:line references.
- @agent-qa-contract-testing:contract-test-scaffoldersonnet
Use proactively whenever an API (OpenAPI, GraphQL SDL, Protobuf or an existing Pact file) needs its first consumer contract tests or a new operation added to them. Emits Pact consumer expectations, Schemathesis runners or buf breaking compatibility tests.
Skills 5
Claude loads it when the task matches- contract-compatibility-gate
Blocks deployments by unifying API contract compatibility checks across Pact, OpenAPI, GraphQL, and Protobuf protocols into a single CI gate.
- graphql-schema-regression
Detects and classifies GraphQL schema changes as breaking, dangerous, or non-breaking to prevent client disruptions.
- openapi-contract-diff
Compares OpenAPI or Swagger specifications to identify breaking changes and gate CI pipelines based on severity levels.
- pact-contract-testing
Set up consumer-driven contract tests to verify API compatibility between microservices and gate deployments using a Pact Broker.
- protobuf-compat-checking
Detects breaking changes in Protobuf schemas by comparing current definitions against past versions using various strictness categories.
Using qa-contract-testing in Claude Code
Ask for an agent by name:
@agent-qa-contract-testing:contract-drift-investigator
@agent-qa-contract-testing:contract-test-scaffolderSkills need no command. Claude reads them when your request matches what they describe.
Update, turn off or remove
- Update the plugin (shell)
- claude plugin update qa-contract-testing@testland-qa
- Refresh the marketplace
- /plugin marketplace update testland-qa
- Turn it off for now
- /plugin disable qa-contract-testing@testland-qa
- Remove it
- /plugin uninstall qa-contract-testing@testland-qa
Skills in qa-contract-testing
- contract-compatibility-gatetestland/qa
Blocks deployments by unifying API contract compatibility checks across Pact, OpenAPI, GraphQL, and Protobuf protocols into a single CI gate.
3 files13stars - graphql-schema-regressiontestland/qa
Detects and classifies GraphQL schema changes as breaking, dangerous, or non-breaking to prevent client disruptions.
2 files13stars - openapi-contract-difftestland/qa
Compares OpenAPI or Swagger specifications to identify breaking changes and gate CI pipelines based on severity levels.
12 files13stars - pact-contract-testingtestland/qa
Set up consumer-driven contract tests to verify API compatibility between microservices and gate deployments using a Pact Broker.
13 files13stars - protobuf-compat-checkingtestland/qa
Detects breaking changes in Protobuf schemas by comparing current definitions against past versions using various strictness categories.
2 files13stars
qa-contract-testing plugin questions
How do I install the qa-contract-testing plugin?
In Claude Code run /plugin marketplace add testland/qa, then /plugin install qa-contract-testing@testland-qa.
What does the qa-contract-testing plugin include?
qa-contract-testing bundles 2 agents, 5 skills.
Which agents come with qa-contract-testing?
contract-drift-investigator, contract-test-scaffolder. Call one with @agent-qa-contract-testing:contract-drift-investigator.
How do I update or remove the qa-contract-testing plugin?
Update it with claude plugin update qa-contract-testing@testland-qa in your shell, or from the Installed tab of /plugin. Remove it with /plugin uninstall qa-contract-testing@testland-qa.
What license is the qa-contract-testing plugin under?
MIT, as stated in the plugin's manifest.