Claude Code Plugins

Community-maintained marketplace

Feedback

graphite-workflow

@jclfocused/claude-agents
1
0

Use this skill when working with Graphite (gt) for stacked PRs, using execute-issue-jira-graphite agent, or when the user mentions Graphite, stacking, or gt commands. Ensures proper use of gt commands instead of raw git for stack-aware operations.

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name graphite-workflow
description Use this skill when working with Graphite (gt) for stacked PRs, using execute-issue-jira-graphite agent, or when the user mentions Graphite, stacking, or gt commands. Ensures proper use of gt commands instead of raw git for stack-aware operations.

Graphite Workflow Skill

This skill ensures correct usage of Graphite CLI (gt) for managing stacked PRs. When working in a Graphite-enabled workflow, always use gt commands instead of raw git commands for stack-aware operations.

When to Use

Apply this skill when:

  • User mentions Graphite, stacking, or gt
  • Working on a feature that uses stacked PRs
  • Using execute-issue-jira-graphite agent
  • Managing branches in a stack

Critical Rule: gt vs git

Instead of... Use... Why
git commit gt create -a -m "message" Creates branch + commit + tracks in stack
git commit --amend gt modify -a Amends AND auto-restacks descendants
git push gt submit --no-interactive Pushes AND creates/updates PRs
git checkout <branch> gt checkout <branch> Stack-aware checkout
git pull / git rebase gt sync Syncs trunk AND rebases entire stack

Core Commands Quick Reference

# Creating PRs in a stack
gt create -a -m "feat: description"   # Stage all, create branch, commit

# Modifying existing PR
gt modify -a                           # Amend commit, auto-restack upstack

# Submitting to GitHub
gt submit --no-interactive             # Current branch + downstack
gt submit --stack --no-interactive     # Entire stack

# Navigation
gt up / gt down                        # Move within stack
gt top / gt bottom                     # Jump to ends of stack
gt checkout                            # Interactive picker

# Syncing
gt sync                                # Fetch trunk, rebase stack, cleanup merged

# Viewing
gt log                                 # Visual stack graph
gt ls                                  # Short list

The Stack Building Workflow

  1. Write code FIRST - Never create empty branches
  2. Stage changes - git add .
  3. Create branch - gt create -a -m "message"
  4. Repeat for each slice
  5. Submit stack - gt submit --stack --no-interactive

When to Use Raw Git

These operations are fine with raw git:

  • git add - Staging files
  • git status - Checking status
  • git diff - Viewing changes
  • git log (for viewing history, not stack structure)

Handling Modifications

When changes are needed to an earlier PR in the stack:

gt checkout <branch-needing-changes>
# Make code changes
git add .
gt modify -a                           # Amend + auto-restack
gt submit --stack --no-interactive     # Push updates

Conflict Resolution

# If conflict occurs during sync/restack:
# 1. Fix conflicts in editor
git add .
gt continue

# To abort:
gt abort