pythonic-refactor

Prompt file imported from brandonvio/dot-claude (.claude/commands/pythonic-refactor.md). Fill in {{arg1}} before use. Copyright stays with the author.

Refactor Python code to add type hints and use Pydantic models by invoking the pydantic-refactor-specialist agent.

Usage

/pythonic-refactor path/to/file.py

Examples

/pythonic-refactor src/models/user.py
/pythonic-refactor src/services/notification_service.py

Steps

1. Validate Input

PYTHON_FILE = {{arg1}}

If PYTHON_FILE is empty:
  Display: "Error: Python file path required."
  Display: "Usage: /pythonic-refactor path/to/file.py"
  Exit

If PYTHON_FILE doesn't exist:
  Display: "Error: Python file not found: $PYTHON_FILE"
  Exit

If PYTHON_FILE doesn't end with ".py":
  Display: "Warning: File doesn't appear to be a Python file"
  Display: "Proceeding anyway..."

2. Invoke Agent

Invoke the pydantic-refactor-specialist agent with:

Refactor the Python file at: $PYTHON_FILE

Requirements:
1. Add comprehensive type hints to all functions, methods, and class attributes
2. Convert appropriate data structures to Pydantic models (BaseModel)
3. Maintain 100% backward compatibility with existing interfaces
4. Use Pydantic validation features (validators, Field constraints)
5. Follow Python best practices and PEP 8
6. Add docstrings if missing

CRITICAL: Preserve external interfaces. All public methods must maintain original signatures.
Use Pydantic model.model_dump() for dict compatibility where needed.

3. Report Success

After agent completes:

• Confirm file was refactored
• Summarize changes made
• Suggest running tests to verify compatibility