vigilante-issue-implementation-on-python

Vigilante Python Issue Implementation

Focus

• Read the prompt for detected tech stacks, process hints, and Python security guidance before changing code.
• Follow idiomatic Python conventions already established by the repository and keep changes scoped to the issue.
• Prefer the repository's existing environment, dependency, formatting, linting, typing, and test workflows over inventing a new stack.

Python Tooling Workflow

• Environment: use the repository's documented bootstrap or environment workflow first. When no repo-specific workflow exists, prefer isolated environments such as venv rather than ad hoc global installs.
• Formatting and linting: run the repository's established formatter and linter for touched files. When the repository already uses Ruff, prefer ruff format and ruff check; when it uses Black, use black. Do not introduce repo-wide formatting churn unrelated to the issue.
• Typing: run the repository's existing typing checks when present, such as mypy, pyright-style tooling, or equivalent configured commands.
• Testing: run targeted pytest or repo-standard test commands for the changed area first, then broaden scope when needed.
• Dependency and package security: when dependency or packaging changes are involved, run repo-standard audit tooling. Use pip-audit when it is already part of the repo workflow or otherwise clearly available and relevant.
• Dependencies: prefer standard library modules when they cover the need. Keep dependency manifests and lockfiles consistent when adding or updating packages.

Idiomatic Python

• Follow existing project conventions for layout, imports, and naming instead of forcing a new style.
• Prefer small, explicit functions, early returns, and straightforward exception handling.
• Add or update docstrings only where the repository already expects them or where a public API change needs clear documentation.
• Avoid broad cleanup or modernization unrelated to the issue.