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
| Borrow | Build for your team |
|---|---|
| Folder structure, entry doc, update log pattern | Domain rules, approval points, test gates |
| Generic planner/reviewer loop | Role split based on repeated failures |
| Command naming patterns | Commands matching your release workflow |
| Cleanup cadence | Ownership and drift metrics |
The Conversion Loop
Questions Before Copying
- Which failure does this step prevent?
- Does that failure happen in our team?
- Is the evidence measurable?
- Who owns the artifact?
- When will we remove it if it stops helping?
Domain-Specific Differences
| Domain | What must become local |
|---|---|
| Frontend | Browser QA, design rules, accessibility gates |
| Platform | Invariants, release gates, impact analysis |
| Payments | Approval, reconciliation, audit trail |
| AI product | Eval 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.