Task Workflow

Execute the standard development workflow for this task: $ARGUMENTS

Follow these steps in order. Do NOT skip any step.

Step 1: Create GitHub Issue

bash
1gh issue create --title "<title>" --body "<description>" --label "<label>"

Common labels: enhancement, bug, tests, documentation, refactor

Use the task description to write a clear issue title and body. The body should explain the context, what needs to change, and why.

Step 2: Create Feature Branch

Branch naming convention:

• feat/<slug> for new features
• fix/<slug> for bug fixes
• refactor/<slug> for refactoring
• test/<slug> for test-only changes
• docs/<slug> for documentation

bash
1git checkout -b <prefix>/<short-slug>

Step 3: Implement Changes

Read existing code before modifying it. Follow patterns already established in the codebase. Key conventions:

• Python 3.10+
• Double quotes for strings
• Type hints on all function signatures
• Docstrings on classes and public functions
• Tests use unittest — never pytest
• Scripts follow the analyze() + main() pattern (see scan_common.py for arg parsing)
• Add an entry to CHANGELOG.md under ## [Unreleased] in the appropriate section (Added/Enhanced/Fixed/Documentation). Format: - Description.

Step 4: Verify

Run formatting, linting, type checking, and all tests. ALL must pass before committing. NEVER install tools to the system Python, if necessary create a venv and install tools into it.

bash
1ruff format <changed-files>
2ruff check <changed-files>
3mypy
4python -m unittest discover tests -v

If any tests fail, fix them before proceeding.

Step 5: Commit

Stage only the files you changed. Use conventional commit format. Always include the issue reference.

bash
1git add <specific-files>
2git commit -m "$(cat <<'EOF'
3<type>: <description>
4
5<optional body>
6
7Closes #<issue-number>
8
9Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
10EOF
11)"

Step 6: Push and Create PR

bash
1git push -u origin <branch-name>
2gh pr create --title "<title>" --body "$(cat <<'EOF'
3## Summary
4<1-3 bullet points>
5
6## Test plan
7- [x] <verification items>
8
9Closes #<issue-number>
10
11Generated with [Claude Code](https://claude.com/claude-code)
12EOF
13)"

Step 7: Merge and Cleanup

bash
1gh pr merge <pr-number> --merge
2git checkout main
3git pull
4git push origin --delete <branch-name>

Step 8: Report

Tell the user:

• Issue URL
• PR URL (merged)
• Summary of changes made
• Test results (pass count)
• Changelog entry