Pick up a GitHub issue (or accept one), fully understand the RenderCV codebase, implement the fix/feature with tests, and open a PR to origin/main.
Pick a GitHub issue from the rendercv repository, implement a complete solution with tests, and open a pull request to origin/main.
If an issue number or URL is provided, use it. Otherwise, pick the highest-priority open issue automatically:
gh issue list --repo rendercv/rendercv --state open --sort created --json number,title,labels,body --limit 10
Choose the most impactful issue that is not labeled wontfix or question. Prefer bugs over features, and smaller-scoped issues over vague ones.
Read the full issue body:
gh issue view <number> --repo rendercv/rendercv
Before writing any code, build a deep understanding of the project:
Read the referenced files, focusing on modules relevant to the issue.
Create a branch from origin/main named after the issue:
git fetch origin main
git checkout -b claude/issue-<number> origin/main
For bug reports:
uv run --frozen --all-extras pytest tests/path/to/test_file.py::test_name -x
Write the fix or feature following @.claude/skills/rendercv-development-context/SKILL.md and @.claude/skills/rendercv-testing-context/SKILL.md.
Run all verification commands from the development context (just format, just check, just test, just test-coverage). Every single one must pass before proceeding.
Stage only the files you changed. Write a clear commit message and push:
git add <specific-files>
git commit -m "Fix #<number>: <concise description of what and why>"
git push origin claude/issue-<number>
Create a PR targeting main:
gh pr create \
--repo rendercv/rendercv \
--base main \
--head claude/issue-<number> \
--title "Fix #<number>: <concise description>" \
--body "$(cat <<'EOF'
## Summary
<1-3 bullet points explaining what was done and why>
Closes #<number>
## Changes
<list of files changed and why>
## Test plan
<what tests were added or modified>
EOF
)"
Tell the user: