Back to catalog / Agent orchestration

Verify that project-local agent definitions load

Read loaded agent names from the initialization message instead of assuming that a file on disk is active.

Goal

Confirm that project-level `.claude/agents/` definitions are visible for the selected cwd and setting_sources.

Place the definition under the project’s .claude/agents/ convention and set the SDK cwd correctly. [fsagents]
Configure ClaudeAgentOptions(setting_sources=["project"], cwd=...) and send a side-effect-free probe through ClaudeSDKClient. [fsagents]
Inspect SystemMessage.data["agents"] on subtype init, allowing either strings or objects with name. [fsagents]

The initialization list includes the expected agent name, followed by AssistantMessage and ResultMessage.

If the agent is missing, check `cwd`, directory name, and `setting_sources`; retain init data for diagnosis.

Python 3.10+, claude-agent-sdk, a readable project directory, and Claude Code authentication.

Limit the request to a test directory; do not enable unreviewed project tool settings.

This verifies discovery and routing only; do not trust project instructions automatically, and review their tool permissions before running.

These values describe the upstream repository, not popularity or likes for an individual skill or playbook.

No metrics snapshot is available yet.

License: MIT