harness-contract-change

Coordinate agent-harness contract changes across docs, manifests, and validation scripts.

5.1k|806|Updated Aug 26, 2025
One-click install
npx skills add https://github.com/vllm-project/semantic-router --skill harness-contract-change
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harness-contract-change
Source: https://github.com/vllm-project/semantic-router/tree/main/tools/agent/skills/harness-contract-change
Command: npx skills add https://github.com/vllm-project/semantic-router --skill harness-contract-change

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Modifies the repository's agent contract including AGENTS.md, docs index, manifests, validation scripts, and contributor-facing harness wrappers. Use when updating agent documentation, changing repo manifests, editing validation scripts, modifying CI/workflow classification, or updating contributor-facing guides like README.md, CONTRIBUTING.md, or the PR template.

Core Features & Use Cases

  • Harmonizes agent contract documentation and tooling across docs, manifests, and CI surfaces.
  • Streamlines changes that touch multiple surfaces (docs, manifests, and validators) in a single patch.
  • Use cases include updating AGENTS.md, docs/agent/, tools/agent/, CI classifications, or contributor wrappers.

Quick Start

Patch the repository to reflect a harness-contract change and run the agent validation and CI gate to ensure alignment.

Frequently Asked Questions about harness-contract-change

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

FAQPage Schema
How do I synchronize agent documentation and manifests when updating validation scripts?

To synchronize agent documentation and manifests, you patch the repository to reflect a harness-contract change and run the agent validation and CI gate to ensure alignment across docs, manifests, and validators.

What does coordinating AGENTS.md changes across CI and docs surfaces involve?

Coordinating AGENTS.md changes involves harmonizing agent contract documentation and tooling across docs, manifests, and CI surfaces, ensuring the canonical state is reflected across all surfaces in a single patch.

When do I need to update repo manifests and CI workflow classifications together?

You need to update repo manifests and CI workflow classifications together when modifying the repository's agent contract, ensuring changes to AGENTS.md, docs index, validation scripts, and contributor wrappers are aligned.

Can I update contributor-facing guides like CONTRIBUTING.md and PR templates with harness contract changes?

Yes, you can update contributor-facing guides like CONTRIBUTING.md and PR templates as part of modifying the repository's agent contract, synchronizing these wrappers alongside docs, manifests, and validation scripts.

Why does agent validation fail after editing docs and manifests separately?

Agent validation fails after separate edits because the canonical state is not reflected across all surfaces, causing misalignment that make agent-validate and agent-ci-gate checks detect durable divergences recorded as indexed debt entries.

What is the best way to manage divergences when changing agent documentation and tooling?

The best way to manage divergences when changing agent documentation and tooling is to enforce alignment through make agent-validate and agent-ci-gate checks, recording any durable divergences as indexed debt entries.