gh-issue

name	gh-issue
description	Analyze and fix the specified GitHub issue
user-invocable	true

Analyze and fix the specified GitHub issue: $ARGUMENTS

Follow these steps:

1. Get issue details:

   • Use gh issue view $ARGUMENTS to get the complete issue information
   • If $ARGUMENTS is not provided, list issues with gh issue list and ask which to work on
   • Understand the problem description, expected behavior, and acceptance criteria

2. Understand the problem:

   • Read through the issue description and any comments carefully
   • Identify the root cause and scope of the issue
   • Note any reproduction steps or examples provided

3. Search the codebase:

   • Use appropriate search tools to find relevant files and code sections
   • Understand the current implementation and identify what needs to change
   • Look for related code that might be affected by the fix

4. Plan and comment your approach:

   • Post a detailed implementation plan as a comment on the issue
   • Use gh issue comment $ARGUMENTS --body "Implementation plan: ..."
   • Include what files will be changed and the general approach

5. Create a development branch:

   • Create a new branch: git checkout -b fix/issue-$ARGUMENTS-{description}
   • Ensure you're working from the latest main branch

6. Implement the fix:

   • Make the necessary changes to fix the issue
   • Follow existing code patterns and conventions
   • Include comprehensive tests to verify the fix
   • Add debug logging where helpful

7. Verify the solution:

   • Run existing tests to ensure nothing breaks: npm test or equivalent
   • Run linting and type checking: npm run lint, npm run typecheck
   • Test your specific fix thoroughly
   • Ensure all tests pass

8. Create a pull request:

   • Commit changes with descriptive message referencing the issue
   • Push the branch to GitHub
   • Use gh pr create --title "Fix #$ARGUMENTS: {description}" --body "Closes #$ARGUMENTS"
   • Include details about the fix and testing performed

9. Keep the issue open until the pull request is merged

Remember: Use the GitHub CLI (gh) for all GitHub-related tasks and reference the issue number in commits and PR.