git-workflow

Standardize squad git branching from dev with worktree-based parallel execution.

2|Updated Apr 21, 2026
One-click install
npx skills add https://github.com/elbruno/md-to-slides --skill git-workflow-elbruno
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-workflow
Source: https://github.com/elbruno/md-to-slides/tree/main/.copilot/skills/git-workflow
Command: npx skills add https://github.com/elbruno/md-to-slides --skill git-workflow-elbruno

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The git-workflow Skill prevents inconsistent branching, PR targeting, and release practices by standardizing how teams collaborate on dev-first feature delivery with clear promotion channels.

Core Features & Use Cases

  • Dev-first branching rule: Forces feature work to branch from dev rather than main, reducing integration risk.
  • Consistent branch naming: Applies the squad/{issue-number}-{kebab-case-slug} convention for traceability.
  • Operational PR lifecycle: Guides issue labeling, draft PR creation, readiness signaling, and post-merge cleanup.
  • Parallel work coordination: Uses git worktree to run simultaneous issue changes safely within one repo without branch switching conflicts.
  • Multi-repo dependency handling: Supports coordinated PRs across downstream repositories with dependency-first merge ordering.

Quick Start

Ask the assistant to generate a step-by-step plan to create a squad/195-fix-version-stamp-bug branch from dev, open a draft PR targeting dev, and set up safe parallel work using git worktree for two additional issues.

Frequently Asked Questions about git-workflow

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

FAQPage Schema
How do I standardize a git branching model for feature delivery across dev and main branches?

A standardized git branching model enforces dev-first feature branching, consistent branch naming, and correct PR base targeting to reduce integration risk. It guides issue-driven work from branch creation through draft PR workflows to deterministic post-merge cleanup.

How do I use git worktree for safe parallel execution across multiple issues in one repository?

Git worktree enables safe parallel execution by allowing simultaneous issue changes within one repository without branch switching conflicts. It creates separate working directories for each issue, letting you run multiple branches concurrently and independently.

What is the best way to manage coordinated multi-repo dependency changes with pull requests?

Coordinated multi-repo dependency changes require dependency-first merge ordering across downstream repositories. You create aligned pull requests in each repository and merge the dependency repository first before promoting downstream changes.

Can I align a git release pipeline with npm publish tags across dev, insiders, and main branches?

Yes, a promotion pipeline can align git branches with npm publish tags by mapping dev, insiders, and main branches to corresponding npm dist-tags. This ensures deterministic release promotion from development through insiders to production releases.

Does consistent branch naming help with issue traceability in a squad git workflow?

Consistent branch naming using the squad/{issue-number}-{kebab-case-slug} convention directly links branches to their originating issues. This traceability helps track feature delivery status and automates post-merge cleanup across the promotion pipeline.

When should I not branch feature work from main instead of dev in a release pipeline?

You should avoid branching feature work from main when using a dev-first promotion pipeline because it increases integration risk. Feature branches should originate from dev to keep main stable for production releases and ensure proper promotion ordering.