What went wrong with the sub-agents?

Trying to call planner produced "Agent type 'planner' not found".

How do you fix the not found error?

Sub-agent definitions are read from the .claude/agents/ folder of the directory you launched from and any directory added with --add-dir. Restart in the directory holding the definitions, or add that directory with --add-dir.

Why does the drafting AI have to ask questions?

The author had things only they knew written into questions for the AI to ask, rather than written directly. The author says the AI proposed this approach because writing it themselves left the content and the best structure unclear.

Large Language ModelsAI Coding AssistantsZenn AI/MLOct 9, 2026Oct 9, 2026, 10:00 JST

Claude Code sub-agents split article writing, 3 human gates

Send on LINE

The author split article work into planning, structuring, drafting and fixing sub-agents in Claude Code, plus a still-separate fact-checking role, and put three review checkpoints — after planning, after structuring, and before publishing — where only the author decides pass or rework.

Not sure about something? Ask the AI

Questions and answers are published on this page.

Summaries like this, in your inbox every morning.

Get news like this every morning, free

Context & Analysis

The setup rests on a deliberate separation of roles: writing, fixing and doubting (fact-checking) are never merged, because the author believes mixed roles lower accuracy. The doubting role is the exception — it has not been turned into a sub-agent and is instead handled by the AI in the ordinary conversation where the author talks to Claude Code directly.

Deciding who passes and who is sent back is the author's alone, and the idea of human stop points predates having the AI write the system's own specification.

One practical trap surfaced only after the build. The author did not notice. Definitions load from the launch directory and from directories added with --add-dir, so the first thing to check when a not found error appears is where the session was started.

FAQ

What went wrong with the sub-agents?: Trying to call planner produced "Agent type 'planner' not found".
How do you fix the not found error?: Sub-agent definitions are read from the .claude/agents/ folder of the directory you launched from and any directory added with --add-dir. Restart in the directory holding the definitions, or add that directory with --add-dir.
Why does the drafting AI have to ask questions?: The author had things only they knew written into questions for the AI to ask, rather than written directly. The author says the AI proposed this approach because writing it themselves left the content and the best structure unclear.

Zenn AI/MLRead Original Article

Send on LINE

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.

Get it free

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.