fix-issue

name	fix-issue
description	End-to-end implementation workflow for a GitHub issue from planning through PR creation. Use when starting work on an issue from scratch.
category	github

Implement GitHub Issue

Complete workflow for implementing a GitHub issue from start to finish.

When to Use

• Starting work on a new issue
• Need structured workflow from branch to PR
• Want to follow best practices end-to-end
• Working on assigned GitHub issue

Quick Reference

# 1. Fetch issue and create branch
gh issue view <issue>
git checkout -b <issue>-<description>

# 2. Commit and PR
git commit -am "feat: description"
git push
gh pr create --issue <issue>

Workflow

1. Read issue context: gh issue view <issue> --comments - understand requirements, prior context
2. Create branch: git checkout -b <issue>-<description>
3. Write tests first: TDD approach - tests drive implementation
4. Implement code: Build functionality to pass tests
5. Commit: Create focused commit with issue reference
6. Push and PR: Create PR linked to issue
7. Monitor CI: Verify all checks pass

Branch Naming Convention

Format: <issue-number>-<description>

Examples:

• 42-add-tensor-ops
• 73-fix-memory-leak
• 105-update-docs

Commit Message Format

Follow conventional commits:

type(scope): Brief description

Detailed explanation of changes.

Closes #<issue-number>

Types: feat, fix, docs, refactor, test, chore

Code Quality Checklist

Before creating PR:

• Issue requirements met
• Tests written and passing
• Pre-commit hooks pass
• No warnings or unused variables
• Documentation updated
• Commit messages follow convention

Error Handling

Problem	Solution
Issue not found	Verify issue number
Branch exists	Use different name or delete old branch
Tests fail	Fix code before creating PR
CI fails	Address issues before merge