python-development

"Metrics-driven Python refactoring -- analyze complexity, plan improvements, execute with test validation, and produce before/after comparison report" argument-hint: "<target file or directory> [--strict-mode]". TRIGGER WHEN: the user requires assistance with tasks related to this domain. DO NOT TRIGGER WHEN: the task is outside the specific scope of this component.

"Scaffold production-ready Python projects with modern tooling — FastAPI, Django, Library, CLI, or Generic — using uv, pytest, ruff" argument-hint: "<project-name> [--type fastapi|django|library|cli|generic]". TRIGGER WHEN: the user requires assistance with tasks related to this domain. DO NOT TRIGGER WHEN: the task is outside the specific scope of this component.

Master Python Architect and Orchestrator. Acts as the manager for Python development tasks, designing system architecture, choosing the modern stack (uv, ruff, FastAPI, Pydantic), and orchestrating specialist agents (python-test-engineer, python-refactor-agent). TRIGGER WHEN: planning a new Python project, designing architecture, making tech stack decisions, or managing a full-stack Python workflow. DO NOT TRIGGER WHEN: the user is asking for simple bug fixes, writing tests, or isolated refactoring.

Expert Python Refactoring Agent. Cleans up legacy code, reduces complexity, removes dead code using vulture/ruff, and improves documentation/comments. TRIGGER WHEN: refactoring code, removing dead code, optimizing imports, reducing cognitive complexity, or improving code readability and docstrings. DO NOT TRIGGER WHEN: writing new features, scaffolding projects, or writing test suites.

Expert Python Test Engineer. Writes focused, behavior-driven pytest suites, handles TDD workflows, and improves code coverage. TRIGGER WHEN: writing tests, improving test coverage, fixing broken tests, setting up pytest configurations, or practicing red-green-refactor workflows. DO NOT TRIGGER WHEN: building new features from scratch or designing system architecture.

Master Python asyncio, concurrent programming, and async/await patterns for high-performance applications. TRIGGER WHEN: building async APIs, concurrent systems, or I/O-bound applications requiring non-blocking operations. DO NOT TRIGGER WHEN: the task is outside the specific scope of this component.

Write and audit Python code comments using antirez's 9-type taxonomy. Two modes - write (add/improve comments in code) and audit (classify and assess existing comments with structured report). Applies systematic comment classification with Python-specific mapping (docstrings, inline comments, type hints). TRIGGER WHEN: users request comment improvements, docstring additions, comment quality reviews, or documentation audits DO NOT TRIGGER WHEN: the task is outside the specific scope of this component.

Detect and remove unused Python code using vulture and ruff. Covers unused imports, variables, functions, classes, and unreachable code. Framework-aware false positive handling for Django, FastAPI, pytest, click, and more. TRIGGER WHEN: cleaning up Python codebases, enforcing import hygiene, or integrating dead code checks into CI. DO NOT TRIGGER WHEN: the task is outside the specific scope of this component.

Create distributable Python packages with proper project structure, setup.py/pyproject.toml, and publishing to PyPI. TRIGGER WHEN: packaging Python libraries, creating CLI tools, or distributing Python code. DO NOT TRIGGER WHEN: the task is outside the specific scope of this component.

Profile and optimize Python code using cProfile, memory profilers, and performance best practices. TRIGGER WHEN: debugging slow Python code, optimizing bottlenecks, or improving application performance. DO NOT TRIGGER WHEN: the task is outside the specific scope of this component.

Systematic code refactoring skill that transforms complex, hard-to-understand code into clear, well-documented, maintainable code while preserving correctness. Applies structured refactoring patterns with validation. TRIGGER WHEN: users request "readable", "maintainable", or "clean" code, during code reviews flagging comprehension issues, for legacy code modernization, or in educational/onboarding contexts DO NOT TRIGGER WHEN: the task is outside the specific scope of this component.

"Generate focused, behavior-driven Python tests using TDD methodology with pytest. TRIGGER WHEN: writing tests, improving coverage, reviewing test quality, or practicing red-green-refactor workflows." DO NOT TRIGGER WHEN: the task is outside the specific scope of this component.

Master the uv package manager for fast Python dependency management, virtual environments, and modern Python project workflows. TRIGGER WHEN: setting up Python projects, managing dependencies, or optimizing Python development workflows with uv. DO NOT TRIGGER WHEN: the task is outside the specific scope of this component.