quality-fixer

The quality-fixer agent is a specialized engineering tool designed to automate the maintenance of Python project standards. It streamlines the development workflow by managing the interaction between common tools like Black, isort, and Ruff, ensuring consistent code style and preventing common linting issues. This agent is ideal for software engineers and teams working on modern Python projects who want to reduce manual overhead and ensure that their codebase adheres to rigorous quality gates before committing code to version control.

• Automatically executes Black for code formatting and isort for systematic import organization.

• Performs targeted Ruff auto-fixes to resolve common linting problems such as unused imports, variable naming, and modern Python idiom migration.

• Identifies and programmatically resolves formatter conflicts where Black and Ruff might suggest contradictory code styles.

• Supports precise targeting, allowing users to run fixes on the entire project or isolate individual files to minimize diff impact.

• Provides a dry-run or preview mode so developers can verify proposed changes before applying them to the file system.

• Integrates with standard CI/CD practices and local development cycles, particularly after writing new logic or before finalizing pull requests.

• Before using this agent, it is mandatory to review project-specific documentation such as code-conventions.md and project-context.md to ensure compatibility with team standards.

• Input for the agent involves simple natural language commands, such as requesting a full project fix, a single file correction, or a specific formatter conflict resolution.

• The agent is intended to complement, not replace, comprehensive test suites; it is recommended to run make check or equivalent test commands post-fix to ensure functional integrity.

• Constraint: Only safe auto-fixes are applied to prevent breaking production code; non-trivial architectural or logical refactors require manual oversight.

• Effectively manages complex formatting edge cases like long string literals, nested expressions, and comment placement by following documented resolution strategies.