Capture version-sensitive claude agents surface

[bingran-you]

Summary

• extend the agent management surface to cover the version-sensitive top-level Based on my exploration, here's what exists in this Claude Code context tree about agents:

Agent Documentation in This Repository

Primary Domains

Domain	Path	Content
Collaboration & Agents	collaboration-and-agents/	23 files covering multi-agent topology, worker execution, team formation, remote sessions
Agent Tool Control	tools-and-permissions/agent-and-task-control/	8 files on agent launching and routing
Agent Management Surface	product-surface/agent-management-surface.md	CLI/UI for listing and managing agents

Key Concepts Documented

Agent Sources (precedence order):

• Built-in, Plugin, User (~/.claude/agents), Project (.claude/agents), Managed, CLI-argument

Execution Modes:

• Coordinator (planning/synthesis), Worker (bounded tasks), Fork (inherited context), Background, Remote, Team/Swarm

Agent Capabilities:

• Tool allowlists/disallowlists, skills, model selection, memory, permission modes, hooks, MCP servers, worktree isolation

User-Facing Commands

• /agents — Local management UI
• claude agents — Top-level read-only listing command

---

Would you like me to:

1. Read specific files for detailed information?
2. Summarize a particular aspect (e.g., how agents are defined, remote execution, team coordination)?
3. Something else related to agents? listing command

• distinguish the read-only CLI listing from the interactive management UI
• update the product-surface index text to reflect the dual surface

Verification

• npx -p first-tree first-tree verify