gsd-pr-branch

Filter planning-only commits from a pull-request branch.

Updated May 22, 2026
One-click install
npx skills add https://github.com/yusaduymaz/loexai --skill gsd-pr-branch-yusaduymaz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-pr-branch
Source: https://github.com/yusaduymaz/loexai/tree/main/.codex/skills/gsd-pr-branch
Command: npx skills add https://github.com/yusaduymaz/loexai --skill gsd-pr-branch-yusaduymaz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes planning-only commits from a development branch so pull requests stay focused on real code changes instead of workflow artifacts.

Core Features & Use Cases

  • Branch cleanup: Produces a clean PR branch by filtering out .planning/ history.
  • Review clarity: Keeps reviewers focused on implementation work rather than PLAN, SUMMARY, or STATE file churn.
  • Workflow compatibility: Supports the GSD branching workflow for teams that want planning artifacts excluded from code review diffs.

Quick Start

Use the gsd-pr-branch skill to create a review-ready branch that excludes all .planning/ commits from my current work.

Frequently Asked Questions about gsd-pr-branch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I remove planning-only commits from a pull request branch?

To remove planning-only commits from a pull request branch, you need to apply branch history rewriting or commit filtering that preserves implementation work while excluding planning files and metadata. This process filters out `.planning/` history to produce a clean PR branch focused on actual code changes.

Why does my code review diff show planning artifacts instead of implementation work?

Your code review diff shows planning artifacts because workflow files like PLAN, SUMMARY, or STATE records are cluttering the branch history. Filtering planning-only commits from the pull request branch keeps reviewers focused on implementation work rather than planning file churn.

Can I clean up a Git branch to exclude .planning/ files before a code review?

Yes, you can clean up a Git branch to exclude `.planning/` files before a code review by applying commit filtering that preserves implementation work. This produces a review-ready PR branch that removes planning artifacts from the diff entirely.

What's the best way to turn a noisy development branch into a review-ready PR?

The best way to turn a noisy development branch into a review-ready PR is to filter planning-only commits from the branch history. This process removes workflow artifacts like planning files and metadata, ensuring reviewers see only the actual implementation work in the pull request diff.

Does branch history rewriting preserve my actual code changes when filtering commits?

Yes, branch history rewriting preserves your actual code changes when filtering commits by specifically targeting planning-only commits for exclusion. This approach maintains all implementation work while removing `.planning/` history and related metadata from the branch.

When do I need to filter planning artifacts from my Git workflow?

You need to filter planning artifacts from your Git workflow when using a branching process where planning files clutter diffs and reviewers need to see only code changes. This is necessary for teams wanting planning artifacts excluded from code review diffs to maintain review clarity.