Przejdź do treści
Biblioteka skilli
AI i agenci · Integracja z narzędziem

harness-engineering-lifecycle

/harness-engineering-lifecycle

Projektuje i integruje uogólnione uprzęże walidacyjne na granicy producent i konsument po powstaniu lokalnego kontraktu, w tym wdrożenie lokalnego narzędzia w projekcie konsumenckim do testów.

Repozytorium
skill_steward ↗
Licencja
MIT
Ostatnia zmiana repozytorium
18.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
6
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 18.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Projektuje i integruje uogólnione uprzęże walidacyjne na granicy producent i konsument po powstaniu lokalnego kontraktu, w tym wdrożenie lokalnego narzędzia w projekcie konsumenckim do testów.

Oryginalny opis (EN)

Design, implement, and integrate generalized validation harnesses across a producer-consumer boundary after a local harness contract exists. Use when refactoring custom validation CLIs/MCPs for large polyrepos, extending Steward across sibling repos, or deploying a local tool to a consumer project for dogfooding and testing.

Jak działa

  1. When to use
  2. When not to use
  3. Part 1: The Cascading Agent Surface (Architecture & Generalization)
  4. Part 2: Cross-Repo Remediation (Testing)
  5. Producer/consumer proof artifacts
  6. Install
  7. Sources
Sekcje z nagłówków SKILL.md, w oryginale · 77 linii, 859 słów
Podgląd SKILL.md
---
name: harness-engineering-lifecycle
description: Design, implement, and integrate generalized validation harnesses across a producer-consumer boundary after a local harness contract exists. Use when refactoring custom validation CLIs/MCPs for large polyrepos, extending Steward across sibling repos, or deploying a local tool to a consumer project for dogfooding and testing.
license: MIT
type: governance
metadata:
  author: skill-steward
  version: "1.1.0"
  category: harness
---

# Harness Engineering Lifecycle

Evolve a proven repo-local contract into a generalized harness, then dogfood it across a producer-consumer boundary. Follow [work discipline](../../docs/core/work-discipline.mdx).

The former `mcp-harness-repo-maintainer` skill was removed in 0.6.0. Cold start and cross-repo generalization are one lifecycle: do not add typed actions, probes, or benchmarks until a local contract exists and the native gate is the thing you rerun. Green Steward artifacts are not a product use-path.

## When to use

- Evolving custom validation scripts into a central linter engine.
- Extending `steward` CLI features for large polyrepos.
- Testing a local CLI/harness build against a sibling repository to catch path-resolution crashes or integration friction.
- Turning repeated local benchmark/probe findings into a reusable harness feature.

## When not to use

- Initial `steward.yaml` adoption or first quick probe in one repo — start here; cold start is part of this lifecycle.
- Skill creation, registry updates, or marketplace packaging — use `skill-authoring-lifecycle`.
- Product-specific diagnostics before a cold-start contract exists — first add a bounded action, probe, and scenario in the target repo.

## Part 1: The Cascading Agent Surface (Architecture & Generalization)

When engineering a harness beyond one local contract, follow the **Cascading Agent Surface** guidelines. A strict separation of tools vs skills can fail once repo workflows span multiple packages, adapters, or consumers. Instead, link them using domain-agnostic abstractions:

1. **Layer 0 (The Embedded Agent Surface)**: The target application or engine must natively expose its internal state via explicit hooks (e.g., RPC or memory probes). Do not rely on brittle UI scraping or black-box testing.
2. **Layer 1 (The Protocol Adapter)**: Build generalized MCP servers or protocol adapters to connect to Layer 0. These tools provide raw visibility and actuation (e.g., taking screenshots, reading memory) but must contain NO business logic.
3. **Layer 2 (The Orchestrator)**: Build specialized harness CLIs that use their own automation/scripting to chain multiple Layer 1 actions together. The Orchestrator's primary job is the **Fast Feedback Loop**: it must emit structured, diagnostic JSON to pinpoint exactly what broke across boundaries.
4. **Layer 3 (The AI Wrapper)**: Following the `agentskills.io` spec, Skills *can and should* contain thin-wrapper tools (scripts). The Skill acts as the AI's brain: it teaches the AI how to trigger Layer 2, interpret its complex JSON heuristics, and safely execute domain-specific recovery tools.

### Generalization Principles

1. **Decouple transport from engine:** Command interfaces (CLI) and JSON-RPC (MCP) are thin wrappers. All logic lives in a reusable core package.
2. **Declarative configuration:** Use a configuration file (like `steward.yaml`) to specify:
   - **Branding:** Name and description of the harness.
   - **Actions:** Typed, bounded repo-local commands with effects, limits, outputs, and evidence policy.
   - **Documentation lattice:** Maps of labels to specific doc files.
3. **Pruned traversals:** Never perform recursive file-walking (`list(recursive: true)`) without pruning standard build/VCS folders early.
4. **Generalized checks:** Do not hardcode linters. Use parameterized declarative engines (e.g. `disallowed-substrings`).

## Part 2: Cross-Repo Remediation (Testing)

When you make changes to the harness (Producer), you must validate it against dependent downstream projects (Consumer).

1. **Establish Sibling Baseline:** Locate the consumer repository (e.g. `../<consumer-repo-name>`). Run its tests to ensure it starts green. Do not change it yet.
2. **Deploy Local Producer:** Build and install the local development version of your harness.
3. **Capture Adoption Friction:** Run the consumer's validation suite using the local producer build. Document path crashes or fragile rules in a scratchpad.
4. **Core Remediation:** Fix the root causes in the *Producer* codebase. Generalize the fix; do not write consumer-specific hacks.
5. **Consumer Configuration Remediation:** Update the *Consumer* repository to leverage the new generalized features (e.g. updating its `steward.yaml`).
6. **Dual Verification:** Verify that the consumer suite passes, and the producer suite passes.
7. **Durable Knowledge:** Extract any learnings to ADRs or FAQs using the `repository-governance-lifecycle` skill.

**Detour stop rule:** If installing, activating, or wiring the local producer build fails twice, stop restoration, record the friction, use the consumer's native gate or portable fallback when possible, and return to the original acceptance check. Do not promote a generalized harness capability from that same detour; capture an observation or unknown case first.

## Producer/consumer proof artifacts

Before promoting a generalized harness change, capture the proof from both sides.

| Side | Required artifact | Purpose |
|------|-------------------|---------|
| Producer | Changed schema/action/rule with tests or validator output | Shows the generalized feature works in the source harness. |
| Consumer | Updated `steward.yaml` or scenario manifest | Shows adoption does not require local-path magic. |
| Consumer | Benchmark summary or truthful `durability_blocked` output | Shows a fresh agent can see what is proven and what is blocked. |
| Both | Validation commands and versions | Makes failures reproducible across repos. |
| Docs | ADR/FAQ update when the boundary changed | Keeps future agents from rediscovering the same split. |

Do not promote a local fix into the generalized harness when only one consumer has a private path workaround. Keep it local until the contract, schema, or rule has a reusable shape and at least one held-out or future-agent repeat proves it transfers.

## Install

```bash
npx skills add arenukvern/skill_steward --skill harness-engineering-lifecycle
```

## Sources

See [references/sources.md](references/sources.md).
Pliki w paczce (6)
  • SKILL.md 6 KB
  • evals/cases/first-action-dormant.yaml 1 KB
  • evals/cases/producer-consumer-trigger.yaml 1 KB
  • references/evals.md 1 KB
  • references/output-guidance.md 11 KB
  • references/sources.md 1 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · Arenukvern/skill_steward100MIT
arenukvern/mcp_flutter100MIT

Migawka bazy z 13.11.2026 · wersja paczki fe2c28a1843f (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100feedback-loops
    Projektuje pętle informacji zwrotnej i uprzęże walidacyjne przed rozpoczęciem implementacji, gdy agent nie może łatwo sprawdzić własnej pracy.
  • 90esp32-producer-consumer-pipeline
    Projektuje potok producent-konsument w firmware ESP32 i sprawdza, czy dane przepływają bez gubienia i bez zakleszczeń.
  • 90harness-engineering
    Wyjaśnia koncepcję harness engineering: czym jest harness, inżynierię kontekstu i ograniczenia architektoniczne dla kodu AI.
  • 100harness-engineering
    Projektuje, buduje, diagnozuje i rozwija uprzęże agentów: instrukcje, narzędzia, środowiska wykonania, trwały stan, zarządzanie kontekstem, weryfikacja, odzyskiwanie i ograniczone pętle autonomiczne.
  • 90harness-setup
    Inicjalizuje albo aktualizuje konfigurację Oh My Harness w projekcie Codex.
  • 100om-refresh-standalone-harness
    Odświeża harness AI aplikacji standalone na podstawie wskazanego lokalnego zakresu wydań Git, gdy zmiana dotyczy modułu, punktu rozszerzeń lub kontraktu publicznego.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.