Ship a feature from a GitHub issue
From a well-written issue to a reviewed pull request with Claude Code.
The flow · 5 steps
Step by step
- GitHub
Step 1
Write the issue
Describe the goal, the files likely involved, and acceptance criteria as a checklist. A clear issue is the best prompt you will write for this feature.
Resources
- Claude Code
Step 2
Plan before coding
Start in plan mode: "Read issue #N and the files it touches. Propose a step-by-step plan, the files you will change, and the risks. Do not edit anything yet." Correct the plan until you agree with it.
Resources
- Claude Code
Step 3
Implement on a branch
Ask it to create a branch named after the issue, implement the plan, and run the linter, type check and tests after each meaningful change.
- Claude Opus 5.5
Step 4
Review the diff
Ask for a review of the full diff against the acceptance criteria: correctness bugs first, then security, then simplifications. Fix what is real, ignore style nitpicks.
- GitHub
Step 5
Open the pull request
Push the branch and open a PR that links the issue ("Closes #N"), explains what changed and why, and lists how you tested it. Check it in light and dark mode and at phone width if it touches the UI.
Resources