OpenParable
Skip to content
← Back to skills

Resolve Issues

Testing & Quality
resolve-issues

Resolve Issues is an Agent Skill for testing & quality published in the FradSer/dotclaude repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/FradSer/dotclaude/blob/HEAD/github/skills/resolve-issues/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/resolve-issues, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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