Add python-annotator agent integration to Python tools.

Create clear escalation path from general Python commands and conformer agent to
specialized python-annotator agent for complex type annotation work. Update
cs-conform-python, cs-code-python commands and python-conformer agent with targeted
references that delegate type suppression investigation, dependency management, and
comprehensive type annotation tasks to the specialized agent.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: emcd

template/.auxiliary/configuration/claude/agents/python-conformer.md

@@ -144,7 +144,9 @@ functionality.
 **Unacceptable Suppressions (require investigation):**
 - `type: ignore` MUST NOT be used, except in extremely rare circumstances. Such
   suppressions usually indicate missing third-party dependencies or type stubs,
-  inappropriate type variables, or a bad inheritance pattern.
+  inappropriate type variables, or a bad inheritance pattern. For complex type
+  suppression investigation and dependency management, delegate to the
+  `python-annotator` agent.
 - `__.typx.cast` SHOULD NOT be used, except in extremely rare circumstances.
   Such casts suppress normal type checking and usually the same problems as
   `type: ignore`.
@@ -263,7 +265,7 @@ def _group_documents_by_field(
 
 **Violations identified:**
 1. **Narrow parameter types**: `list[dict[...]]` instead of wide `__.cabc.Sequence[__.cabc.Mapping[...]]`
-2. **Type suppression abuse**: `# type: ignore[arg-type]` masks real design issue
+2. **Type suppression abuse**: `# type: ignore[arg-type]` masks real design issue (delegate to `python-annotator` agent for systematic suppression resolution)
 3. **Mutable container return**: Returns `dict` instead of `__.immut.Dictionary`
 4. **Function body blank lines**: Empty lines breaking vertical compactness
 5. **Vertical compactness**: `return { }` could be same line as `if`
@@ -333,4 +335,5 @@ def _group_documents_by_field(
 - **Focus on compliance**: Maintain exact functionality while improving standards adherence
 - **Reference specific lines**: Always include line numbers and concrete examples
 - **Document reasoning**: Explain why each standard matters and how fixes align with project practices
+- **Agent delegation**: When type annotation issues exceed basic compliance scope, consider delegating to the `python-annotator` agent for comprehensive type work
 - **Guide access**: If any prerequisite guide cannot be accessed, stop and inform the user

template/.auxiliary/configuration/claude/commands/cs-code-python.md

@@ -83,6 +83,8 @@ Write Python code following established patterns:
 - Apply nomenclature patterns for consistent naming
 - Ensure functions are ≤30 lines and modules are ≤600 lines
 
+For complex type annotation issues or when adding comprehensive type annotations to existing code, consider using the `python-annotator` agent.
+
 ### 4. Implementation Tracking Checklist
 Track progress against requirements:
 - [ ] All specified functions/classes have been implemented
@@ -114,6 +116,7 @@ Type Error Resolution Process:
    - Generate stubs: `hatch --env develop run pyright --createsub <package>`
    - Complete necessary stub definitions
    - Re-run type checker to verify resolution
+3. Complex Type Issues: For comprehensive type annotation work, systematic suppression resolution, or complex dependency management, consider using the `python-annotator` agent.
 
 Stop and consult user if:
 - Type errors cannot be categorized as code issues or third-party stub gaps

template/.auxiliary/configuration/claude/commands/cs-conform-python.md

@@ -121,7 +121,9 @@ Acceptable Suppressions:
 Unacceptable Suppressions (require investigation):
 - `type: ignore` MUST NOT be used, except in extremely rare circumstances. Such
   suppressions usually indicate missing third-party dependencies or type stubs,
-  inappropriate type variables, or a bad inheritance pattern.
+  inappropriate type variables, or a bad inheritance pattern. For systematic
+  investigation and resolution of type suppressions, consider using the
+  `python-annotator` agent.
 - `__.typx.cast` SHOULD NOT be used, except in extremely rare circumstances.
   Such casts suppress normal type checking and usually the same problems as
   `type: ignore`.
@@ -312,7 +314,7 @@ Apply fixes in systematic order:
 1. **Module Organization**: Reorder imports, type aliases, functions per practices guide
 2. **Wide/Narrow Types**: Convert function parameters to wide abstract types
 3. **Import Cleanup**: Remove namespace pollution, use private aliases and __ subpackage
-4. **Type Annotations**: Add missing hints, create `TypeAlias` for complex types
+4. **Type Annotations**: Add missing hints, create `TypeAlias` for complex types. For comprehensive type annotation work or complex type checking issues, consider using the `python-annotator` agent.
 5. **Exception Handling**: Narrow try block scope, ensure proper chaining
 6. **Immutability**: Replace mutable with immutable containers where appropriate
 7. **Spacing/Delimiters**: Fix `( )`, `[ ]`, `{ }` patterns