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

1. •Read issue context: gh issue view <issue> --comments - understand requirements, prior context
2. •Create branch: git checkout -b <issue>-<description>
3. •Post start comment: Document approach on the issue
4. •Write tests first: TDD approach - tests drive implementation
5. •Implement code: Build functionality to pass tests
6. •Quality check: Format code and run pre-commit
7. •Commit: Create focused commit with issue reference
8. •Push and PR: Create PR linked to issue
9. •Post completion: Document summary on the issue
10. •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

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