resolve-issues

name	resolve-issues
allowed-tools	Bash(gh:*), Bash(git:*), EnterWorktree, ExitWorktree, Task
description	Resolves GitHub issues using isolated worktrees and test-driven development. This skill should be used when the user asks to "resolve an issue", "fix issue
argument-hint	["issue number or description"]
user-invocable	true

Resolve GitHub Issues

Execute issue resolution workflow using isolated worktrees, TDD methodology, and agent collaboration.

Context

• Current git status: !git status
• Current branch: !git branch --show-current
• Existing worktrees: !git worktree list
• Open issues: !gh issue list --state open --limit 10
• GitHub authentication: !gh auth status

Requirements Summary

Use isolated worktrees to avoid disrupting main development. Follow TDD cycle (red → green → refactor) with agent support. Reference issues in commits using auto-closing keywords. See references/requirements.md for protected PR workflow and commit standards.

Phase 1: Issue Selection and Worktree Setup

Goal: Select target issue and prepare isolated development environment.

Actions:

1. Review open issues from context and select based on priority and $ARGUMENTS
2. Check existing worktrees to determine if reuse is possible
3. Use the EnterWorktree tool with a descriptive name (e.g., fix-456-auth-redirect) to create an isolated session
4. Rename the auto-generated branch to match conventions: run git branch -m <type>/<issue>-<description> (see references/workflow-details.md for naming)
5. Verify issue acceptance criteria and dependencies

Phase 2: TDD Implementation

Goal: Implement fix using test-driven development with agent collaboration.

Actions:

1. Plan implementation approach and assess architectural impact
2. Write failing tests that verify issue is resolved (RED phase)
3. Implement minimal code to make tests pass (GREEN phase)
4. Refactor while keeping tests green (REFACTOR phase)
5. Run quality validation commands (see references/workflow-details.md for project-specific checks)

Phase 3: PR Creation and Cleanup

Goal: Create pull request, link issue, and clean up worktree after merge.

Actions:

1. Push branch to remote with git push -u origin <branch-name>
2. Create PR using gh pr create with auto-closing keywords (e.g., "Closes #456"). CRITICAL: Auto-closing keywords only trigger when the PR merges into the repository's default branch. If targeting a non-default branch (e.g. develop), warn the user that the issue will NOT close automatically on merge and must be closed manually.
   • Consider using --draft if the fix requires further feedback before review
3. Report PR URL and status to user
4. After successful merge: use the ExitWorktree tool with action "remove" to clean up worktree and branch
5. Document resolution and any follow-up tasks

References

• Requirements: references/requirements.md - Worktree setup, TDD, and commit standards
• Workflow Details: references/workflow-details.md - Issue selection, TDD cycle, agent collaboration
• Examples: references/examples.md - Commit message examples