securityreviewer = AgentDefinition(

    name="security-reviewer",
    description="Audits code for security vulnerabilities",
    systemprompt="""Review for:
SQL injection, XSS vulnerabilities
Insecure cryptography
Exposed secrets
Authentication bypass risks""",
    tools=["Read", "Grep", "WebSearch"],  # No Bash, no Edit
    model="claude-3-5-sonnet"
)

implementer = AgentDefinition(

    name="implementer",
    description="Codes new features",
    systemprompt="""When implementing:

Read existing patterns
Follow the code style
Write tests
Verify with tests before reporting done""",
    tools=["Read", "Edit", "Write", "Bash", "Grep"],  # Has Bash + Edit
    model="claude-3-5-sonnet"
)

async for message in query(

    prompt="Research auth patterns and design a refactor plan",
    options={
        "agents": {
            "researcher": researcheragent,
            "planner": planneragent

        }
    }
):
    # Claude automatically decides when to use each agent
    # Researcher explores (keeps findings brief)
    # Planner designs based on summary (context stays lean)
    if isinstance(message, ResultMessage):
        print(message.result)

agents = {

    "explorer": AgentDefinition(
        description="Searches and discovers patterns",
        tools=["Glob", "Grep", "Read", "WebSearch"]
    ),
    "designer": AgentDefinition(
        description="Plans architecture and solutions",
        tools=["Read", "Grep"],
        systemprompt="Design solutions that are scalable, maintainable, and follow existing patterns"
    ),
    "builder": AgentDefinition(
        description="Implements code and features",
        tools=["Read", "Write", "Edit", "Bash"]
    ),
    "validator": AgentDefinition(
        description="Tests and validates work",
        tools=["Bash", "Grep", "Read"]
    )
}

options = ClaudeAgentOptions(agents=agents)


async for message in query(
    prompt="Implement user authentication: research best practices, design it, code it, validate tests pass",
    options=options
):
    # Claude automatically delegates to appropriate agents
    pass

findtodos = AgentDefinition(

    description="Find all TODO comments in code",
    tools=["Grep", "Read"]
)

runtests = AgentDefinition(
    description="Run test suites and report status",
    tools=["Bash"]
)

checktypes = AgentDefinition(

    description="Run TypeScript type checker",
    tools=["Bash"]
)

❌ Bad: Vague responsibility

broadagent = AgentDefinition(
    description="General helper"
)

✓ Good: Specific responsibility

securityauditor = AgentDefinition(

    description="Audits TypeScript code for security vulnerabilities"
)

systemprompt="""You are a database schema reviewer.


FOCUS ON:
Proper indexing for query performance
Referential integrity and constraints
Normalization (avoid redundancy)
Scalability for 1M+ records

IGNORE:
Application code
Frontend concerns
DevOps infrastructure

OUTPUT FORMAT:
Issue: [what's wrong]
Impact: [why it matters]
Fix: [what to change]
"""

❌ Too many tools (confusing)

tools=["Read", "Write", "Edit", "Bash", "Grep", "WebSearch", ...]

✓ Focused toolset

tools=["Read", "Grep"]  # Code review agent doesn't need to write