Enhance linting for subagent routing and tools

[krataratha]

Added validation for subagent routing strategy and improved error handling for tools configuration.

[github-actions]

Thank you for your submission, we really appreciate it. Like many open-source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution. You can sign the CLA by just posting a Pull Request Comment same as the below format.

---

I have read the CLA Document and I hereby sign the CLA

---

_{You can retrigger this bot by commenting recheck in this Pull Request. Posted by the CLA Assistant Lite bot.}

[Copilot]

Pull request overview

This PR updates the managed-agent cookbook tool-scope linter to add subagent routing validation and revise tool configuration handling.

Changes:

• Adds documentation for subagent routing validation.
• Adds checks for missing routing_strategy on subagent entries.
• Refactors _lint_one() and main() logic in scripts/lint-tool-scope.py.

Comments suppressed due to low confidence (2)

scripts/lint-tool-scope.py:107

• This module guard is inserted before the existing remainder of the file, leaving the old _lint_one tail and a second main() below it at module scope. Because that leftover block includes return errs outside any function, the script will fail to import/run with a SyntaxError instead of performing the lint.

if __name__ == "__main__":
    sys.exit(main())

scripts/lint-tool-scope.py:46

• This only checks that routing_strategy is present and truthy, but the added policy text says subagents must use the required 'handoff' routing. A typo or unsupported strategy such as direct would pass this lint, so the new rule does not actually enforce the required routing mode.

    # Feature: Ensure every subagent has a defined 'routing_strategy'
    for sa in subagents:
        if isinstance(sa, dict) and not sa.get("routing_strategy"):
            errs.append(f"{path}: subagent '{sa.get('name')}' missing routing_strategy")

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.