issue

Prompt file imported from takoeight0821/malgo (.github/prompts/issue.prompt.md). Fill in {{issue_number}} before use. Copyright stays with the author.

Steps

Follow Planning → Action. Obtain user approval between Planning and Action.

Planning

1. Fetch the issue body and discussion from GitHub:
   • Use GitHub MCP server or gh issue view {{issue_number}}.
2. Propose a branch name prefixed with fix/{{issue_number}}/ based on the issue summary.
3. (Optional) Search codebase to locate relevant implementation points and draft an implementation plan.
4. Present the branch name and implementation plan to the user for approval.

Action

5. After approval, verify the working directory is clean (git status).
6. Create the new branch and switch to it:

   git checkout -b fix/{{issue_number}}/<short-description>

7. Implement the changes according to the plan.
8. Run project checks:

   mise run build    # compile the project
   mise run test     # execute test suite

9. If checks pass, stage changes.
10. Commit the changes with a concise message summarizing the fix.
11. Push the branch and create a draft pull request.

Pull Request Format

• Title: concise summary of the fix.
• Body: must start with fix: #{{issue_number}} Auto-generated PR and include:
  • A brief description of the changes
  • Any relevant references or special considerations
  • Any questions or concerns
• Base branch: master