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: gstack
한국어English

Case: gstack

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

Key takeaways

  • gstack reads a harness as an opinionated software factory: a workflow and command distribution layer, not a loose prompt library.
  • Its signals include 23 specialists, 8 power tools, 10 AI coding agent hosts, team-mode auto-update, and checkpoint mode.
  • The Think to Plan to Build to Review to Test to Ship to Reflect loop keeps review, test, and ship as separate stages.
  • Browser QA and iOS live-device QA verify real behavior, while /learn captures domain knowledge back into the harness.
  • Adopt the core loop first rather than deploying the full catalog, since opinionated workflows create friction when they miss the local domain.

gstack is useful because it shows a harness as an opinionated software factory rather than a loose prompt library.

This page is based on the repository state read on 2026-05-23.

Current Positioning

The README frames gstack as a set of specialists and power tools for AI coding agents across multiple hosts. The practical pattern is a workflow and command distribution layer.

Key current signals:

  • 23 specialists and 8 power tools.
  • Support for 10 AI coding agent hosts.
  • Team mode auto-update.
  • Browser QA and iOS live-device QA.
  • Checkpoint mode.
  • /learn and domain skill capture.
  • /codex second-opinion style review.

Workflow

StageHarness role
ThinkProblem framing and hypothesis
PlanScope, approach, and execution path
BuildImplementation
ReviewCode, design, security, and second opinion
TestBrowser/device verification
ShipRelease and docs
ReflectCapture learning and update the harness

Why This Is Engineering

gstack turns loose agent usage into a pipeline.

  • Specialists reduce role ambiguity.
  • Power tools make common operations discoverable.
  • QA commands make verification explicit.
  • Checkpoints make long work recoverable.
  • Team mode makes updates distributable.
  • Domain learning pushes local knowledge back into the harness.

What to Borrow

BorrowHow to apply
Opinionated stagesName the stages your team actually uses
Review/test/ship separationDo not collapse all validation into implementation
Browser and device QAVerify real behavior, not only code
Team distributionManage commands and skills as shared assets
Checkpoint and learningStore progress and convert repeated patterns into skills

Caveats

  • Opinionated workflows are fast when they fit the team.
  • They create friction when they do not match the local domain.
  • Do not deploy the full catalog at once; start with the core loop.

References

  • gstack README, read baseline 2026-05-23 https://github.com/garrytan/gstack

Related docs

External Case Comparison

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

Team Harness Rollout Strategy

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

Case: Toss

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

Case: revfactory/harness

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

On this page

Current PositioningWorkflowWhy This Is EngineeringWhat to BorrowCaveatsReferences