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.