Quality Specialist
MUST INVOKE for moai-adk-go quality-gate enforcement — TRUST 5 framework, Go toolchain validation (go vet, golangci-lint, go test), coverage targets (85% package / 90% critical cli/template/hook), LSP phase gates, or running the parallel read-only verification batch at run/sync-phase completion. Covers independent skeptical quality scoring and gate-failure triage.
- Type
- Subagent
- Repository
- modu-ai/moai-adk
- GitHub stars
- 1.2k
- License
- Apache-2.0
- Repo last updated
- Sep 27, 2026
- Source file
- .claude/agents/harness/quality-specialist.md
- Model
- opus
What Quality Specialist is
Quality Specialist is a subagent published in the modu-ai/moai-adk repository on GitHub, which has about 1.2k stars. The repository describes itself as: “Agentic development harness for Claude Code — SPEC-driven plan/run/sync, TRUST 5 quality gates, model+effort routing, and Claude×GLM multi-LLM cost control. Single Go binary, 16 languages, zero deps.”
A subagent is a specialist assistant that Claude can hand part of a task to. It is a markdown file whose frontmatter sets a name, a description that tells Claude when to delegate, and optionally the tools and model it may use; the body becomes the subagent's own system prompt.
Because a subagent works in its own context, it keeps the main conversation focused: Claude can send a narrow job, such as a review or a specialised analysis, to Quality Specialist and get back a compact result.
It is set up to use these tools: Read, Write, Edit, Grep, Glob, Bash. Limiting tools is a good sign: the subagent can only do what those tools allow.
How to install Quality Specialist
Claude Code
- Download quality-specialist.md from the repository.
- Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control.
- Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Claude Cowork
- Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent.
- Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
New to extending Cowork? Our plugins guide and Customize guide explain how skills, plugins, and connectors fit together.
Inside the source file
An excerpt from .claude/agents/harness/quality-specialist.md, shared under the repository's Apache-2.0 license. Read the full file on GitHub.
v4 Manifest Entry
Role
This specialist owns quality-gate enforcement for the moai-adk-go Go binary and its template/SPEC surface. It routes independent quality scoring to sync-auditor, relies on the mechanical Stop hook for sync-phase gating, and never references any archived agent from the 12-agent rejection list (the former quality-manager path is closed per SPEC-V3R6-AGENT-TEAM-REBUILD-001 and archived-agent-rejection.md §C row #2). It never prompts the user directly.
Delegates To
- sync-auditor — for independent skeptical quality scoring across the 4 dimensions (Functionality / Security / Craft / Consistency). Invocation: "Use the sync-auditor subagent to score SPEC- sync-phase artifacts with fresh-judgment skepticism; report harmonic-mean dimension scores and must-pass gate results."
- Stop hook sync-phase-quality-gate.sh — mechanically enforces lint + test + coverage-delta on sync commits. The hook self-gates on every turn-end (per .claude/rules/moai/core/agent-common-protocol.md § Hook Invocation Surface). This hook IS the canonical quality gate; it replaces what an archived quality-manager would have done.
Do NOT reference any archived agent from the 12-agent rejection list — not in prose, examples, or delegation chains.
Domain Guidance — moai-adk-go specifics
- TRUST 5 framework: Tested / Readable / Unified / Secured / Trackable. All five dimensions must pass before a SPEC is marked complete.
- Go toolchain sequence: go vet ./... → golangci-lint run --timeout=2m → go test ./.... Missing tools are skipped gracefully; a clean project with no recognized language marker passes the gate silently.
- Coverage targets: 85% minimum package-level; 90%+ for critical packages (internal/cli, internal/template, internal/hook). Measure with go test -coverprofile=cover.out ./internal/ /....
- LSP quality gates per phase: plan = capture baseline; run = zero errors, zero type errors, zero lint errors; sync = zero errors, max 10 warnings. Config in .moai/config/sections/quality.yaml.
- Parallel verification-batch pattern (per .claude/rules/moai/core/agent-common-protocol.md § Parallel Execution): when verifying run-phase completion, issue the canonical 7 read-only checks (go test, coverprofile, subagent-boundary grep, sentinel-key audit, CLI smoke, benchmark, lint) as a SINGLE-turn multi-Bash batch. Never serialize independent read-only verifications across turns.
- Test isolation discipline: t.TempDir() only; no t.Setenv with OTEL env vars in parallel tests (global-state data race — CLAUDE.local.md §WARN).
- Verification-claim integrity (per .claude/rules/moai/core/verification-claim-integrity.md): every PASS row in a verification matrix MUST correspond to an actually-observed command output. No unobserved claims, no carry-over from prior unrelated runs.
Before you install
- Read the whole file first. Skills, commands, and subagents are instructions Claude will follow, so make sure they match what you want.
- Check which tools, scripts, or MCP servers it uses. Local servers and scripts run with your permissions.
- Try it in a test project or a copy of your files before pointing it at real work.
- Pin the version you tested, and review changes before updating.
- Watch for instructions that fetch web content or run shell commands; those are where prompt injection risks start. See our prompt injection guide.
FAQ
What is Quality Specialist?
Quality Specialist is a subagent for Claude Code and Claude Cowork from the modu-ai/moai-adk repository on GitHub. MUST INVOKE for moai-adk-go quality-gate enforcement — TRUST 5 framework, Go toolchain validation (go vet, golangci-lint, go test), coverage targets (85% package / 90% critical cli/template/hook), LSP phase gates, or running the parallel read-only verification batch at run/sync-phase completion. Covers independent skeptical quality scoring and gate-failure triage.
How do I install Quality Specialist in Claude Code?
Download quality-specialist.md from the repository. Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control. Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Can I use Quality Specialist in Claude Cowork?
Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent. Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
Is Quality Specialist safe to install?
It is a third-party community resource, not reviewed by Anthropic or this site. Read the source file first, check which tools and connectors it uses, and install only from sources you trust.
Similar resources
- Harness Release Update Specialist (dev-only) release-update harness specialist — Claude Code upstream change tracker for moai-adk-go maintainers. NOT distributed to user… Subagent · modu-ai/moai-adk
- Builder Harness Unified artifact-meta creation specialist — builds the scaffolding/structure of agents, skills, plugins, commands, hooks, MCP servers, and LSP servers. Operates on artifact metadata (frontmatter, manifests, dispatch tables, hook registration) NOT artifact body content (prose, business logic, domain reasoning). Use PROACTIVELY for creating agents, skills, plugins, commands, hooks, MCP servers… Subagent · modu-ai/moai-adk
- Hook Ci Specialist MUST INVOKE for moai-adk-go hook and CI work — shell-script hooks under .claude/hooks/moai/*.sh, settings.json hook wiring with $CLAUDE_PROJECT_DIR quoting and 5s timeout, GitHub Actions workflows under .github/workflows/, the template-neutrality CI guard, or the moai update namespace-protection contract. Covers adding a hook, adding a CI workflow, and wiring a command. Subagent · modu-ai/moai-adk
- Manager Docs Documentation specialist (sync-phase: CHANGELOG.md + README.md + docs-site authoring + owns progress.md §E.4 Sync-phase Audit-Ready Signal + the merged in-progress → implemented → completed transition on the single sync commit for all 4 SPEC artifacts, per the 3-phase close). See §SPEC Artifact Ownership for artifact-level boundaries — MUST NOT modify spec.md / plan.md / acceptance.md body… Subagent · modu-ai/moai-adk
- Sync Auditor Skeptical code evaluator for independent quality assessment. Actively tests implementations against SPEC acceptance criteria. Tuned toward finding defects, not rationalizing acceptance. Operates post-implementation only — once code exists and acceptance criteria are testable. Pre-implementation document review is plan-auditor's domain (the two agents are complementary, never overlap). Match user… Subagent · modu-ai/moai-adk
- Plan Auditor Independent plan-phase document auditor. Adversarial stance: finds defects in SPECs, BRIEFs, and project documents; never rationalizes acceptance. Operates pre-implementation only — once code exists, sync-auditor is the audit channel (post-implementation skeptical evaluation against acceptance criteria). Match user intent language-independently — do not require literal keyword matches. NOT for… Subagent · modu-ai/moai-adk
- Workflow Specialist MUST INVOKE for moai-adk-go SPEC lifecycle work — plan/run/sync phase routing, GEARS/EARS requirement authoring, the 3-phase V3R6 close contract (sync_commit_sha; the completed transition rides the sync commit), Tier S/M/L classification, era classification + grandfather clause, and the Implementation Kickoff Approval human gate before run-phase entry. Covers adding a SPEC and closing one. Subagent · modu-ai/moai-adk
- Manager Spec SPEC creation specialist (spec.md / plan.md / acceptance.md authoring + emits initial status: draft). See §SPEC Artifact Ownership for artifact-level boundaries. Absorbs the planning role per the 2026-05-25 Anthropic catalog consolidation (which reduced 17 agents to the then-8-agent catalog, since grown to 11; the prior planning-role owner is archived per .claude/rules/moai/wor… Subagent · modu-ai/moai-adk