Agent Reference - nguyenhx2/agent-harness-bootstrap GitHub Wiki

Agent reference

The seats this harness can install. A run installs between 3 and 17 of them, decided by the contract and by what the codebase analysis found, plus one dev-agent per module that actually exists. Never all of them by default: see Tailored Build.

Every seat carries an explicit model and effort. An unset model means inherit, which silently bills mechanical work at the caller's tier, so the harness never leaves it unset.

Seat Model Effort maxTurns Installed What it is for
ba-analyst sonnet high 40 needs purpose_code Writes and edits the specification set in docs/specs/ and the PRDs in docs/requirements/.
checker opus high 25 needs checker Read-only check of a finished deliverable before it is relied on - every claim traced to a source that says it, a red-team pass that attacks the reco…
code-reviewer opus high 25 needs purpose_code; absent when solo_review Reviews a branch diff against coding standards and project rules.
data-modeler sonnet high 40 needs db Designs and modifies the the ORM schema and its migrations, per the ERD and the data dictionary.
db-engineer sonnet medium 40 needs db and db_engineer Database operations - applies and troubleshoots migrations, tunes queries and indexes, checks integrity, manages the local DB environment.
db-seeder haiku low 15 needs db and db_seeder Seeds the local or dev database with deterministic synthetic data.
debugger opus xhigh 30 needs purpose_code Root-cause diagnosis of failing CI jobs, failing tests, runtime errors, and environment problems.
devops sonnet medium 40 needs purpose_code CI/CD (CI), environments, infrastructure, and gated releases to the hosting target.
history-tracker haiku low 10 needs audit or long Inspects and summarizes the agent-run archive in .claude/state/history/ (written automatically by the agent-history hook).
merge-manager opus medium 20 needs merge_gate Merges approved pull requests into the default branch and resolves merge conflicts under delegated authority.
orchestrator opus high 60 always Mission controller for Guarded work - plans and decomposes a request that needs two or more seats in a dependent order, or touches schema, auth, mone…
qa-test sonnet medium 40 needs tests Writes and runs the automated tests (unit: the unit framework, e2e: the e2e framework) that prove the stated acceptance criteria.
researcher sonnet medium 40 needs long or purpose_research or purpose_strategy Answers a stated question with cited evidence - gathers sources, records findings with their provenance, and writes the synthesis under docs/.
reviewer opus high 25 needs solo_review The merged review gate for small projects - one read-only pass over a branch diff covering both code quality and security.
security-reviewer opus high 25 needs purpose_code; absent when solo_review Reviews a branch diff for security and privacy - secrets, PII, authn/authz, input validation, injection, dependency risk.
spec-guardian sonnet medium 15 needs purpose_code Checks a feature or change against the written requirements - FR/NFR, acceptance criteria, business rules.
strategist opus high 30 needs long or purpose_strategy Frames an open decision, lays out genuinely distinct options, scores a trade-off matrix and writes the recommendation as a decision memo or an ADR dr…
writer sonnet medium 40 needs purpose_docs Writes and edits this repository's documentation - new pages, restructures, corrections, style passes - from a stated source of truth.

Reviewers hold no write tools

code-reviewer and security-reviewer (or the merged reviewer under the solo_review flag) have no Edit and no Write. Not "usually" - none. A reviewer that can edit is not a review gate.

The template seat

dev-agent.md is not in the table because it is a template, instantiated once per module with that module's real paths as its scope. A module with no seat, or a seat with no module, is a finding in harness-view assess.