GitHub Feature Workflow — Plain Steps
A six-phase workflow for building features or fixing bugs with Claude Code. Each phase runs in its own session to keep context clean. Copy-paste the prompts below and fill in your details.
Note: Click on View Raw in the GitHub Feature Workflow Gist to get the full Markdown without rendering.
1. Ideate
Goal: Turn a rough idea into a well-written GitHub issue.
| Setting | Value |
|---|---|
| Session | New |
| Model | Any (re-evaluated in Plan phase) |
| Mode | Plan Mode |
Steps
- Describe your idea and chat about it
- Answer Claude’s clarifying questions
- Let Claude research official docs
- Create the GitHub issue
Prompt
I have the following idea and I want you to
create a new GitHub issue for it.
Ask me any clarifying questions.
When planning, always do a research.
But only look at the official documentation
for the packages we use
(not blog posts or unofficial GitHub repos).
Always give implementation suggestions.
I don't want you to plan the implementation
as such. The plan is to create a new GitHub
issue for my idea so another dev can work
on it.
<your idea here>
2. Plan
Goal: Read a GitHub issue and produce a concrete development plan.

Pedro Estrela on March 21, 2026
can I suggest adding the initial scafolding as a seperate step in day 1? realpython.com/gists/9ea33811-86e5-423e-98f7-4a147343c0c5/