CC-AG-009: Invalid Tool Name in Tools List - Claude Agents

Summary

• Rule ID: CC-AG-009
• Severity: HIGH
• Category: Claude Agents
• Normative Level: MUST
• Auto-Fix: No
• Verified On: 2026-10-04

Applicability

• Tool: claude-code
• Version Range: unspecified
• Spec Revision: unspecified

Evidence Sources

• https://code.claude.com/docs/en/sub-agents
• https://code.claude.com/docs/en/tools

Test Coverage Metadata

• Unit tests: true
• Fixture tests: true
• E2E tests: false

Examples

The following examples demonstrate what triggers this rule and how to fix it.

Invalid

---
name: my-agent
description: Agent with unknown tool
tools:
  - Read
  - MakeFile
---
Agent instructions.

Valid

---
name: my-agent
description: Agent with valid tools
tools:
  - Read
  - Write
  - Bash
---
Agent instructions.