harness-engineering-lifecycle

Generalize and dogfood validation harnesses across producer-consumer repository boundaries.

2|Updated Aug 15, 2026
One-click install
npx skills add https://github.com/Arenukvern/shortly --skill harness-engineering-lifecycle-arenukvern
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: harness-engineering-lifecycle
Source: https://github.com/Arenukvern/shortly/tree/main/.agents/skills/harness-engineering-lifecycle
Command: npx skills add https://github.com/Arenukvern/shortly --skill harness-engineering-lifecycle-arenukvern

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Evolving a repo-local validation contract into a reusable harness system is risky: custom scripts hardcode linters, recursive file walks hit build folders, and local fixes break downstream consumer projects. This Skill provides a structured lifecycle for generalizing a proven steward.yaml contract into a declarative harness and safely testing it across a producer-consumer repository boundary. ## Core Features & Use Cases - Cascading Agent Surface Architecture: Guides a four-layer design (embedded hooks, protocol adapters, orchestrator CLI, AI skill wrapper) that decouples transport from engine logic. - Cross-Repo Remediation Workflow: Defines a seven-step dogfooding process from sibling baseline through dual verification, with a detour stop rule to prevent promoting unproven fixes. - Proof Artifact Requirements: Specifies required producer and consumer artifacts (schema tests, updated steward.yaml, benchmark summaries) before promoting a generalized harness change. - Use Case: After extending a steward CLI with a new declarative lint rule, deploy the local build to a sibling consumer repo, capture adoption friction, fix root causes in the producer, and verify both suites pass. ## Quick Start Ask the AI to generalize the local steward harness and validate it against the sibling consumer repository using the harness-engineering-lifecycle workflow.

Frequently Asked Questions about harness-engineering-lifecycle

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

FAQPage Schema
How do I generalize a validation harness across multiple repositories?▼

Follow the producer-consumer remediation workflow: establish a green sibling baseline, deploy the local producer build, capture adoption friction, fix root causes in the producer, update the consumer's steward.yaml, and run dual verification on both suites.

What is the Cascading Agent Surface architecture?▼

It is a four-layer design: Layer 0 exposes application state via explicit hooks, Layer 1 provides logic-free MCP protocol adapters, Layer 2 orchestrator CLIs emit diagnostic JSON, and Layer 3 skills teach the AI to trigger and interpret the harness.

When should I use harness-engineering-lifecycle instead of mcp-harness-repo-maintainer?▼

Use it only after the target repo already has a steward.yaml contract and at least an H2 smoke proof. For initial steward.yaml adoption, first quick probes, or cold-start contracts in a single repo, use mcp-harness-repo-maintainer instead.

What proof is required before promoting a generalized harness change?▼

Both sides need artifacts: the producer needs changed schema or rules with tests, the consumer needs an updated steward.yaml and benchmark summary, plus reproducible validation commands and versions, and ADR or FAQ updates when the boundary changed.

What happens if installing the local producer build fails repeatedly?▼

The detour stop rule applies: after two failures, stop restoration, record the friction, fall back to the consumer's native gate when possible, and return to the original acceptance check without promoting a generalized capability from that detour.