AIToday
Large Language ModelsAI Coding AssistantsZenn AI/MLPublished: Oct 1, 2026, 22:00 JST

7 subagents, day one: qa-reviewer fails a draft, 2 roles idle

7 subagents, day one: qa-reviewer fails a draft, 2 roles idle

3 Key Points

  1. What happened

    In a repository running 7 subagents, qa-reviewer — limited to read-only tools — rejected a draft because a first-person anecdote lacked a verification record; after evidence was logged, a re-review passed.

  2. Why it matters

    Separating the writer from the checker appears to work, since a reviewer that cannot edit files caught an unsupported claim the author would likely have passed themselves.

  3. What to watch

    builder and content-writer were merged for two tightly coupled articles, and growth-marketer and revenue-analyst have never run, so the count of 7 may be an overestimate.

WHO IT HITSEngineers and solo developers configuring AI coding agents (Claude Code subagents) now have a concrete split criterion — different output location or different evaluation standard — plus evidence that a read-only checker role catches unverified claims. Teams copying agent setups between projects should note that unused roles are cheap to keep, since each definition is a single file under .claude/agents/.

Not sure about something? Ask the AI

Questions and answers are published on this page.

Summaries like this, in your inbox every morning.

Context & Analysis

This is a first-day field report rather than a proven playbook. The seven subagents were split along three design criteria: whether the output destination differs, whether the required expertise and judgment criteria differ, and whether the role is worth reusing independently. The author is explicit that only the first of these is mechanically checkable — you can look at the directories — while whether two jobs really use different evaluation standards often only becomes clear after running both in one agent. The qa-reviewer separation is the case where that second criterion was confirmed the hard way: a defect appeared, and only then was it clear the evaluation axes had genuinely differed.

Within the same repository, the opposite happened at the same time. builder and content-writer were defined as separate roles with different output folders (samples/ and articles/) and different expertise, yet for two articles whose sample code and prose were one-to-one coupled, running them as one agent was faster because no other judgment intervened between the steps. Meanwhile growth-marketer and revenue-analyst have never been invoked; the ops/kpi.md update that revenue-analyst was meant to own amounted to the main session adding a single line after one article was published.

What ties these together is that agent definitions live as Markdown files under .claude/agents/, so merging or splitting costs one or two file edits. That low correction cost is arguably the reason the author can leave the question open — and the reason a follow-up review after roughly a month of operation is planned to test whether 7 was the right number.

FAQ
Why does qa-reviewer not have Write or Edit tools?
Its configuration lists only Read, Grep, Glob, Bash, WebFetch and WebSearch, so it can only write findings to reviews/<slug>.md rather than rewrite a file itself. The stated purpose is to prevent the reviewer from fixing problems on its own judgment.
Why does revenue-analyst use a different model?
Its configuration specifies model: haiku, while builder inherits the main session's model and the other five use sonnet. The repository's CLAUDE.md assigns lightweight models to number-recording and simple aggregation work.
Did splitting builder and content-writer actually save time?
No — for the first published article and one still in preparation, a single agent read both definition files and handled implementation through writing in one session. The two articles had a strong serial dependency, so the handoff cost outweighed the benefit of splitting.

AI news that matters for your work, delivered every morning.

Pick your industry and the AI tools you use, and get news related to your work every day.

Free · 30 seconds with Google · unsubscribe anytimeWhat is AIToday? →

Ask AI

Ask AI anything about this article. The AI reads this article, earlier AIToday articles, and Wikipedia, and cites its sources. Q&As are published on this page for other readers too.

Questions and answers are published on this page.

Related Articles

Next articleOllaya runs decision models locally, up to 255 options