GitHub Issue Workflow Manager

Instructions

Starting Work on an Issue

1. Fetch issue details:

   bashCopy

   gh issue view <number> --repo chaoming/ww2-flutter-game
   

2. Add "in progress" comment:

   bashCopy

   gh issue comment <number> --repo chaoming/ww2-flutter-game --body "Started working on this issue."
   

Completing an Issue

1. Ensure all acceptance criteria are met
2. Close the issue with a summary:
   bashCopy

   gh issue close <number> --repo chaoming/ww2-flutter-game --comment "Completed. Summary of changes: ..."
   

Creating Follow-up Issues

If work reveals additional tasks:

gh issue create --repo chaoming/ww2-flutter-game \
  --title "Follow-up: <title>" \
  --label "<label>" \
  --body "Discovered while working on #<parent-number>. ..."

Handling Blockers

1. Add blocker comment:

   bashCopy

   gh issue comment <number> --repo chaoming/ww2-flutter-game \
     --body "Blocked by: <reason>. Need: <what's needed>"
   

2. If blocked by another issue, link them:

   bashCopy

   gh issue comment <number> --repo chaoming/ww2-flutter-game \
     --body "Blocked by #<blocking-issue>"
   

Project Labels

• foundation - M1: Foundation phase
• core-gameplay - M2: Core gameplay phase
• combat-ai - M3: Combat & AI phase
• polish - M4: Polish & Modes phase
• models - Data models
• ui - User interface
• game-logic - Game logic & mechanics
• ai - AI opponent