Skip to main content
reopt Handbook
reopt Handbook
Harness Engineering

Problem and Structure

Foundations of Harness EngineeringRepo-Readable SystemsThe Five Elements of a HarnessEngineering Mechanics

Evaluation and Interpretation

Evaluation Loop DesignExternal Case Comparison

Case Studies

Case: OpenAICase: AnthropicCase: TossCase: gstackCase: revfactory/harness

Domain Playbooks

Domain PlaybooksScenario: Frontend TeamScenario: Platform TeamScenario: Payments and Settlement TeamScenario: AI Product TeamWhy You Eventually Need Your Own Harness

Rollout and Operations

Team Harness Rollout StrategyTeam Harness Design ChecklistOperations: Entropy and Garbage Collection

Appendix

Verification ReportUpdates
Handbook›Harness Engineering›Why You Eventually Need Your Own Harness
한국어English

Why You Eventually Need Your Own Harness

Explain what to copy from external harnesses and what must be redesigned for your domain and team.

Key takeaways

  • External harnesses are useful as a starting point but dangerous when treated as the destination.
  • Generic templates cover entry docs, review commands, and basic verification, but real team failures are usually domain-specific.
  • Borrow structure (folder layout, entry doc, cleanup cadence) but build domain rules, failure-based role splits, and release-matched commands yourself.
  • The conversion loop is: borrow a pattern, observe local failures, keep load-bearing parts, remove ritual, encode domain rules, then operate and clean up.
  • The goal is convergence toward the smallest system that repeatedly prevents your team's real failures, not collecting harness patterns.

External harnesses are useful because they give you a starting point. They are dangerous when treated as the destination.

Why Generic Harnesses Stop Working

Generic templates usually cover:

  • entry docs;
  • review commands;
  • basic verification;
  • common approval language.

But real team failures are often domain-specific.

  • Frontend teams miss rendered behavior.
  • Payments teams need reconciliation and audit.
  • Platform teams need invariant and release discipline.
  • AI product teams need evals and rollout telemetry.

Borrow vs Build

BorrowBuild for your team
Folder structure, entry doc, update log patternDomain rules, approval points, test gates
Generic planner/reviewer loopRole split based on repeated failures
Command naming patternsCommands matching your release workflow
Cleanup cadenceOwnership and drift metrics

The Conversion Loop

Questions Before Copying

  1. Which failure does this step prevent?
  2. Does that failure happen in our team?
  3. Is the evidence measurable?
  4. Who owns the artifact?
  5. When will we remove it if it stops helping?

Domain-Specific Differences

DomainWhat must become local
FrontendBrowser QA, design rules, accessibility gates
PlatformInvariants, release gates, impact analysis
PaymentsApproval, reconciliation, audit trail
AI productEval sets, safety policies, canary metrics

Conclusion

The goal is not to collect harness patterns. The goal is to converge toward the smallest system that repeatedly prevents your team's real failures.

Related docs

Domain Playbooks

Translate harness principles into frontend, platform, payments, and AI product teams.

Case: revfactory/harness

Read revfactory/harness as a meta-harness for generating domain-specific team architectures, agents, and skills.

Scenario: AI Product Team

Design a harness where eval sets, safety policy, online telemetry, and model rollout control nondeterministic behavior.

Team Harness Rollout Strategy

Use Toss, gstack, revfactory, OpenAI, and Anthropic patterns to scale personal routines into a team execution system.

On this page

Why Generic Harnesses Stop WorkingBorrow vs BuildThe Conversion LoopQuestions Before CopyingDomain-Specific DifferencesConclusion