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. Implement with TDD
# - Write tests first
# - Implement code
# - Run tests: mojo test tests/

# 3. Quality checks
just pre-commit-all

# 4. Commit and PR
git add . && git commit -m "feat: description

Closes #<issue>"
git push -u origin <branch>
gh pr create --issue <issue>

Workflow

Read issue context: gh issue view <issue> --comments - understand requirements, prior context
Create branch: git checkout -b <issue>-<description>
Post start comment: Document approach on the issue
Write tests first: TDD approach - tests drive implementation
Implement code: Build functionality to pass tests
Quality check: Format code and run pre-commit
Commit: Create focused commit with issue reference
Push and PR: Create PR linked to issue
Post completion: Document summary on the issue
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
[ ] Code formatted (pixi run mojo format)
[ ] 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 |

Documentation Requirements

Post documentation directly to the GitHub issue:

# Post implementation started
gh issue comment <issue> --body "$(cat <<'EOF'
## Implementation Started

**Branch**: `<branch-name>`

### Approach
[Brief description of implementation approach]

### Files to Modify
- `path/to/file1.mojo`
- `path/to/file2.mojo`
EOF
)"

# Post completion summary
gh issue comment <issue> --body "$(cat <<'EOF'
## Implementation Complete

**PR**: #<pr-number>

### Summary
[What was implemented]

### Verification
- [x] Tests pass
- [x] Pre-commit passes
EOF
)"

References

See CLAUDE.md for complete development workflow
See CLAUDE.md for Mojo syntax standards
See CLAUDE.md for zero-warnings policy