[DOCS] Discrepancy in documentation: Reference to non-existent built-in subagent "Verify" in IAM guide

Status Fixed / completed

Maintainer reply None cached

Activity 4 comments · opened Jan 20, 2026 · closed Feb 4, 2026

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/iam

Section/Topic

The Task (Subagents) section within the Identity and Access Management documentation.

Current Documentation

Under the Task (Subagents) heading, the documentation states:

Use Task(AgentName) rules to control which subagents Claude can use: - Task(Explore) Matches the Explore subagent - Task(Plan) Matches the Plan subagent - Task(Verify) Matches the Verify subagent

What's Wrong or Missing?

The IAM guide lists Task(Verify) as an example of a built-in subagent that can be controlled via permission rules. However, the dedicated subagents guide (https://code.claude.com/docs/en/sub-agents), which explicitly defines all built-in agents, does not list a "Verify" agent.

The subagent guide only defines:

Explore
Plan
General-purpose
Helpers like Bash, statusline-setup, and Claude Code Guide.

There is no mention of a "Verify" subagent in the feature overview, leading to confusion about whether this is a hidden built-in feature or a hallucination/legacy leftover in the documentation.

Suggested Improvement

If the "Verify" subagent does not exist as a built-in tool, it should be removed from the IAM examples to prevent user confusion.

Suggested replacement text for the IAM guide:

Use Task(AgentName) rules to control which subagents Claude can use: - Task(Explore) Matches the Explore subagent - Task(Plan) Matches the Plan subagent - Task(general-purpose) Matches the general-purpose subagent

Impact

High - Prevents users from using a feature

Additional Context

Reference link for IAM: https://code.claude.com/docs/en/iam#tool-specific-permission-rules
Reference link for Built-in Subagents: https://code.claude.com/docs/en/sub-agents#built-in-subagents
This discrepancy makes it difficult for users to know which built-in agents they should proactively manage via settings.json.

View original on GitHub ↗

4 Comments

github-actions[bot] · 8 months ago

Found 3 possible duplicate issues:

This issue will be automatically closed as a duplicate in 3 days.

If your issue is a duplicate, please close it and 👍 the existing issue instead
To prevent auto-closure, add a comment or 👎 this comment

🤖 Generated with Claude Code

coygeek · 8 months ago

Issue #19395 Verification

Title: [DOCS] Discrepancy in documentation: Reference to non-existent built-in subagent "Verify" in IAM guide
Issue Date: 2026-01-20
Verification Date: 2026-01-23
Status: UNRESOLVED

---

Issue Summary

I reported that the IAM documentation references a Task(Verify) subagent in its permission rules examples, but no "Verify" subagent exists in the built-in subagents documentation.

---

Verification Results

Claim 1: IAM guide references `Task(Verify)` as a built-in subagent

Status: UNRESOLVED

The IAM documentation at code.claude.com/docs/en/iam.md lines 189-196 still contains:

**Task (Subagents)**

Use `Task(AgentName)` rules to control which [subagents](https://code.claude.com/en/sub-agents) Claude can use:

* `Task(Explore)` Matches the Explore subagent
* `Task(Plan)` Matches the Plan subagent
* `Task(Verify)` Matches the Verify subagent

Verdict: The problematic text still exists exactly as I reported.

---

Claim 2: No "Verify" subagent is documented in the subagents guide

Status: UNRESOLVED

The subagents documentation at code.claude.com/docs/en/sub-agents.md lines 19-67 defines the following built-in subagents:

| Subagent | Description |
|----------|-------------|
| Explore | Fast, read-only agent for codebase search |
| Plan | Research agent for plan mode |
| General-purpose | Complex multi-step tasks |
| Bash | Terminal commands (helper) |
| statusline-setup | Status line configuration (helper) |
| Claude Code Guide | Questions about Claude Code features (helper) |

There is no "Verify" subagent documented anywhere in this file.

Verdict: The subagents guide does not document a "Verify" subagent, confirming the discrepancy I reported.

---

Current State

| Claim | Status |
|-------|--------|
| IAM guide lists Task(Verify) | UNRESOLVED - still present at line 195 |
| Verify subagent not in subagents guide | UNRESOLVED - still not documented |

---

Suggested Fix

Replace Task(Verify) with Task(general-purpose) in the IAM documentation to match the actual built-in subagents.

Before (line 195 in iam.md):

* `Task(Verify)` Matches the Verify subagent

After:

* `Task(general-purpose)` Matches the general-purpose subagent

---

References

Mirror file: code.claude.com/docs/en/iam.md
Lines 189-196: Task (Subagents) permission rules section
Mirror file: code.claude.com/docs/en/sub-agents.md
Lines 19-67: Built-in subagents section

---

Conclusion & Recommendation

Primary Concern: The IAM guide references a "Verify" subagent that doesn't exist in the built-in subagents documentation, creating user confusion about available subagents.

Resolution Status: UNRESOLVED

Recommendation: KEEP OPEN

The documentation discrepancy I reported still exists. Either Task(Verify) should be replaced with Task(general-purpose) in the IAM guide, or a "Verify" subagent should be added to the subagents documentation if it actually exists as an undocumented feature.