gsd-pr-branch

Create a pull request branch excluding .planning/ commits from the diff.

4|1|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/lgwanai/openforce --skill gsd-pr-branch-lgwanai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-pr-branch
Source: https://github.com/lgwanai/openforce/tree/main/skills/gsd-pr-branch
Command: npx skills add https://github.com/lgwanai/openforce --skill gsd-pr-branch-lgwanai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes GSD planning artifact commits (such as .planning/ changes) from your branch so that pull requests show only meaningful code diffs for review.

Core Features & Use Cases

  • Clean PR Branch Creation: Filters out .planning/ commits to produce a PR-ready branch with review-focused changes.
  • Reviewer-Friendly Diffs: Keeps reviewers from being distracted by PLAN/SUMMARY/STATE style updates that are irrelevant to code logic.
  • Use Case: When your working branch contains both implementation commits and GSD planning artifacts, generate a separate clean branch so the PR diff only includes the implementation.

Quick Start

Run gsd-pr-branch to create a clean PR branch filtered to exclude .planning/ commits, targeting your main branch by default.

Frequently Asked Questions about gsd-pr-branch

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

FAQPage Schema
How do I exclude planning artifacts from a git pull request diff?

To exclude planning artifacts from a git pull request diff, you can create a clean branch that filters out commits modifying the `.planning/` directory. This ensures reviewers only see implementation code changes without being distracted by PLAN.md or SUMMARY.md updates.

Why does my pull request include `.planning/` directory changes?

Your pull request includes `.planning/` directory changes because GSD planning artifacts were committed alongside implementation work on the same branch. Filtering these planning commits generates a separate review-ready branch containing only code diffs.

Can I remove planning commits from a branch without losing code changes?

Yes, you can remove planning commits from a branch without losing code changes by applying deterministic git operations to generate a new branch. This separates GSD artifact history from implementation work, producing a clean PR branch.

What's the best way to keep code review diffs focused on implementation?

The best way to keep code review diffs focused on implementation is to strip GSD planning artifact commits before submitting a PR. Filtering out `.planning/` directory updates ensures the diff contains only meaningful code changes for reviewers.

Does this branch filtering target a specific base branch by default?

Yes, this branch filtering targets your main branch by default when creating the clean PR branch. It applies deterministic git operations to exclude `.planning/` commits while preserving implementation changes against the main branch.

When should I not use a filtering approach for PR branch management?

You should not use a filtering approach for PR branch management if your repository requires preserving the complete chronological commit history of planning artifacts alongside code changes, as this process strips `.planning/` commits to produce review-focused diffs.