GitHub Feature Workflow

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.


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

  1. Describe your idea and chat about it
  2. Answer Claude’s clarifying questions
  3. Let Claude research official docs
  4. 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.

Locked learning resources

Join us and get access to thousands of tutorials and a community of expert Pythonistas.

Unlock This Lesson

Already a member? Sign-In

Locked learning resources

The full lesson is for members only. Join us and get access to thousands of tutorials and a community of expert Pythonistas.

Unlock This Lesson

Already a member? Sign-In

Avatar image for Pedro Estrela

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/

Avatar image for Martin Breuss

Martin Breuss RP Team on March 21, 2026

@Pedro Estrela done, it’s now here: realpython.com/lessons/python-project-scaffold/

I’ve kept it in the Gist so you can easily click View Raw and avoid the site rendering the Markdown :)

You must own this product to join the conversation.