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›Case: Toss
한국어English

Case: Toss

Analyze Toss's harness approach through executable SSOT, domain layers, frictionless adoption, and HITL.

Key takeaways

  • Toss reads harness adoption as an organizational problem: raising a team's productivity floor, not just one expert's ceiling.
  • Rules are layered into global (shared floor), domain (performance), and local (task context) so context stays aligned without giant rule files.
  • Executable SSOT means rules must become commands, templates, skills, and human gates, since passive wiki pages and meeting notes do not shape behavior.
  • Domain HITL ties approval cost to risk, with distinct gates for payments, security, platform, and AI product work.
  • The rollout must stay frictionless; if the workflow is slower than personal habit, the team falls back to chat and memory.

Toss is useful because it reads harness adoption as an organizational problem: how do you raise the productivity floor of a team, not just the ceiling of one expert?

Problems Solved

  • Good usage patterns stay inside one person's head.
  • Rules live in docs but do not shape execution.
  • Approval points are implicit.
  • Domain-specific risk is treated like generic coding work.

Core Mechanism

LayerContainsWhy it matters
GlobalShared security, style, release, approvalGives everyone the same floor
DomainProduct/team rules, approval conditions, risk patternsCreates domain performance
LocalTicket, current branch, temporary contextKeeps the agent aligned to the task

Executable SSOT

The strongest Toss lesson is that SSOT cannot be passive. It must be executable enough to shape behavior.

Weak formStronger harness form
Wiki pageCommand or workflow
Meeting noteTemplate or checklist
Senior engineer habitSkill or runbook
Approval customHuman gate with criteria

The more critical the domain, the more the SSOT must become workflow.

Domain HITL

Not every team should use the same approval policy. But approval rules cannot be entirely personal either.

Examples:

DomainHuman gate trigger
PaymentsPricing, refund, settlement, ledger rules
SecurityAuth, token, key, policy, network boundary
PlatformShared package, migration, release gate
AI productModel, prompt, tool permission, safety policy

Rollout Pattern

Create shared AGENTS.md, verification commands, and approval vocabulary.

Move domain risks from docs into commands, templates, and gates.

If the workflow is slower than personal habit, the team returns to chat and memory.

What to Borrow

BorrowWhy
Global/domain/local splitPrevents giant rule files and disconnected context
Executable SSOTMakes rules affect work
Domain HITLAligns approval cost with risk
Frictionless default pathSustains adoption

What Not to Copy Blindly

  • Do not make every rule a workflow.
  • Do not add human approval where risk is low.
  • Do not put domain-specific rules into global docs.
  • Do not rely on docs if the actual work path ignores them.

References

  • Toss, Software 3.0 era: raising the organizational productivity floor through Harness, 2026-02-26 https://toss.tech/article/harness-for-team-productivity

Related docs

Team Harness Rollout Strategy

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

Domain Playbooks

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

Project Rule Documents

Agentic Documentation · Design AGENTS.md, CLAUDE.md, and path-scoped rules without conflicts or drift.

Case: Anthropic

Analyze Anthropic's long-running harness through planner/evaluator, Managed Agents, and auto approval patterns.

Case: gstack

Read gstack as an opinionated multi-host workflow harness with specialists, power tools, QA, checkpointing, and release gates.

On this page

Problems SolvedCore MechanismExecutable SSOTDomain HITLRollout PatternWhat to BorrowWhat Not to Copy BlindlyReferences