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›Team Harness Rollout Strategy
한국어English

Team Harness Rollout Strategy

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

Key takeaways

  • Rolling out a harness means distributing a way of working as a system, not handing out documents; the unit of rollout is workflow (commands, skills, templates, hooks, sandbox/MCP, plugins, remote approval, docs).
  • Team size dictates scope: small teams start with AGENTS.md plus a few core commands and an updates log; growing teams add global/domain/local layers and runtime boundary policy; platform orgs add a harness registry and telemetry.
  • Each external case contributes a distinct lesson: Toss raises the productivity floor with layered SSOT, OpenAI standardizes runtime primitives, Anthropic guards trust boundaries, gstack supplies opinionated role commands, revfactory generates harnesses from domain analysis.
  • The 30/60/90 plan moves from externalizing two or three repeated failures, to splitting domain layers and wiring release gates, to adding telemetry, updates, and garbage collection cadence.
  • It is working when new members hit a similar baseline, review comments shift from repeated mistakes to better decisions, and model changes shake the team less.

Using a good harness alone is different from making the whole team produce similar baseline quality.

Toss frames this as raising the team's productivity floor. gstack and revfactory approach it through opinionated workflow and generated harnesses. OpenAI and Anthropic add runtime primitives: sandbox, MCP, hooks, remote approvals, plugins, sessions, and permission classifiers.

The Unit of Rollout Is Workflow

Rollout unitRole
CommandEncapsulates repeated work sequences
SkillPackages role-specific knowledge
TemplateStandardizes plans, runbooks, updates, release notes
Hook / ScriptAutomates validation and blocking
Sandbox / MCPControls execution and internal tool access
PluginInstalls provider setup, domain workflow, API key setup, troubleshooting
Remote approvalKeeps human judgment reachable during long work
DocExplains why and records the baseline date

Team Expansion Model

What Different Team Sizes Need

Rollout Lessons

From Toss

  • Separate global, domain, and local layers.
  • Make workflow and plugins act as executable SSOT.
  • Move personal expert habits into team workflow.
  • If the harness is not frictionless, adoption collapses.

From OpenAI

  • Treat MCP, skills, AGENTS.md, shell, and apply_patch as standard primitives.
  • Use sandbox and Manifest to make inputs, outputs, dependencies, and side effects predictable.
  • Use hooks for prompt checks, validation, logging, and memory.
  • Design remote approval for long-running work.
  • Prefer private MCP connection paths over exposing internal servers.
  • Use plugin surfaces for repeated provider setup and API troubleshooting.

From Anthropic

  • Do not bind session, harness, and sandbox into one failure boundary.
  • Treat auto approval as trust boundary, block rule, and allow exception policy.
  • Check subagent handoff at delegation and return.
  • Keep credentials behind vaults, scoped resources, or MCP proxies.
  • Package domain workflow with skills, connectors, subagents, audit logs, and approval flows.

From gstack

  • Provide opinionated role commands.
  • Connect review, test, ship, and reflect.
  • Keep browser QA and release docs as separate steps.
  • Manage install paths and auto-update policies per agent host.

From revfactory/harness

  • Analyze the domain.
  • Choose an architecture pattern.
  • Generate agent teams and skills.
  • Tune through validation.

30 / 60 / 90 Day Rollout

30 days: choose two or three repeated failures and externalize them into commands and checklists.
60 days: split domain layers and connect review, browser QA, and release gates.
90 days: add telemetry, updates, and garbage collection cadence.

Minimum Team Package

ComponentMinimum contents
Entry docsAGENTS.md, reading path, required verification
Domain docsArchitecture, invariants, release gates
WorkflowReview, QA, ship, updates
Runtime boundarySandbox permissions, MCP allowlist, hooks, approval policy, classifier/trust-boundary config
Provider/domain packagePlugin, skill, connector, cookbook rules
Operating logUpdates and stale cleanup

Signs It Is Working

  • New team members finish first tasks at a similar baseline quality.
  • Review comments shift from repeated mistakes to better decisions.
  • Previously personal routines become commands and skills.
  • Model changes shake the team less.

Conclusion

Rolling out a harness is not distributing documents. It is distributing a better way of working as a system.

Related docs

External Case Comparison

Compare OpenAI, Anthropic, Toss, gstack, and revfactory/harness by input, state, verification, and rollout.

Verification Report

Link, consistency, source, and static validation report for the Harness Engineering handbook.

Skills Ecosystem

Enterprise Project Architecture · Build reusable agent skills, commands, and documents for repeated engineering workflows.

Team Documentation Culture

Agentic Documentation · Govern agent instructions, Skills, Plugins, MCP servers, ownership, and rollout.

Setup and Login

Advanced Codex Usage · Standardize Codex installation, updates, identity, and local developer setup.

Why You Eventually Need Your Own Harness

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

Team Harness Design Checklist

A practical checklist teams can use to design repository, approval, evaluation, browser, log, release, and runtime loops.

On this page

The Unit of Rollout Is WorkflowTeam Expansion ModelWhat Different Team Sizes NeedRollout LessonsFrom TossFrom OpenAIFrom AnthropicFrom gstackFrom revfactory/harness30 / 60 / 90 Day RolloutMinimum Team PackageSigns It Is WorkingConclusion