github-workflow

Rules for using GitHub tools and managing GitHub issues through a required debugging tool. They describe how to update issues, create subtasks, and link related work.

In plain words
What is it for?
Updating issues, creating subtasks, documenting implementation requirements, and organizing related GitHub work.
Why use it?
They provide a consistent process for keeping issue descriptions, comments, labels, and task relationships accurate.

Cursor rule for Cursor

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add rules/giantswarm/muster/github-workflow
Clone the repo
git clone --depth 1 https://github.com/giantswarm/muster

Made for: Cursor.

Per session 987 This file is loaded in full into every session.
When invoked 987 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00987 $0.00987
Opus 5 $0.00494 $0.00494
Sonnet 5 $0.00197 $0.00197
Haiku 4.5 $0.00099 $0.00099

Measured yesterday against content hash b0f3927acbf4, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

github-workflow scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.cursor/rules/github-workflow.mdc · 59 lines

How it starts

The opening of the file, as written. The whole thing — 59 lines — stays where its author put it; the contents beside it link to each section on GitHub.

  • Github Tools Usage
    • Always use the Github tools via mcp-debug
    • The Github tools via mcp_mcp-debug_list_tools
  • Github Tools Discovery
    • Sub-points with details
    • Examples and explanations
  • Issue Management Best Practices
    • When updating existing issues:
      • Always update the issue description if the scope of the issue has changed. A comment is not enough. But only do the necessary changes to the description.
      • Add a short comment underneath explaining what was added/changed
      • Avoid lengthy comments that repeat the description content
    • When adding subtasks to main issues:
      • Create separate issues for each subtask with detailed information
      • Include full description, objective, implementation details, and acceptance criteria in subtask issues
      • Link subtask issues in the main issue's "Related Subtasks" section
      • Use consistent naming: "Subtask X.Y: [Description]"
      • Add appropriate labels: subtask, relevant components, priority
    • Subtask issue structure:
      • Parent Issue: Link to main issue (e.g., "#71 - Task 13: Main Task Title")
      • Objective: Clear, one-sentence goal
      • Implementation Details: Specific technical requirements and approach
      • Files to Create/Modify: Explicit file listing
      • Acceptance Criteria: Detailed, testable requirements
      • Dependencies: Links to related issues/tasks
  • New Task
    • Use the x_github_list_issues tool to fetch the list of open issues from the giantswarm/muster repository, ordered by issue number descending (newest first).
    • Decide which is the next best issue in that list (still open issue) and use the x_github_get_issue tool with its issue number to retrieve full details. Also make sure to use the x_github_get_issue_comments tool to get the comments for the issue.
    • Summarize that issue (title, number, body, key tasks) in the chat before starting implementation steps.
    • After summarizing, outline the approach for addressing the issue and continue with the implementation.
  • New Issue
    • Gather the necessary information for the issue: title and body. labels and assignees can also be included if provided.
    • Use the x_github_create_issue tool to create the new issue in the giantswarm/muster repository. Set owner to giantswarm and repo to muster.
    • Announce the new issue (title and number) in the chat after it has been created.
  • Commit and Push Workflow
    • Get the current branch name using git rev-parse --abbrev-ref HEAD
    • If the current branch is main or master, generate a new branch name using the pattern <type>/issue-<issue_num>-<slugified_issue_title>.
    • Checkout the new branch using git checkout -b <new_branch_name>
  • IMPORTANT - Before staging, committing and pushing changes
    • Make sure to run goimports -w . and go fmt ./... before you commit any code.
    • Run tests by executing the make test command in the terminal using run_terminal_cmd.
    • If tests fail, you have to fix the tests.
  • Stage changes:
    • Run git add . using run_terminal_cmd.
  • Commit changes:
    • Construct a commit message. The suggested pattern is: <CommitType>: <issue_title> (closes #<issue_num>). Example: Refactor: Refactor getPodNameForPortForward for clarity, scope, and context handling (closes #37). The <CommitType> (e.g., Refactor, Fix, Feat) should match the nature of the work.
    • Run git commit -m "<commit_message>" using run_terminal_cmd.
  • Push changes:
    • Run git push origin <target_branch> using run_terminal_cmd.
    • Inform the user that the changes have been committed to <target_branch> and pushed to origin.
  • Closing an issue
    • Confirm with the user that the issue is ready to be closed.
    • Add a comment to the issue with the changes that were made. Use the x_github_add_issue_comment tool to add the comment.
    • Use the x_github_update_issue tool to change the state of the issue to 'closed'.

Read the full file on GitHub · 59 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 59 lines · 987 tokens per session scan A b0f3927acbf4

Subscribe to this mod's changes

github-workflow is a cursor rule published in the GitHub repository giantswarm/muster (28 stars, last pushed 2d ago), licensed Apache-2.0. It adds 987 tokens to every session, about $0.0049 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.