git-workflow

Manage Squad branching model workflows across multiple repositories.

619|188|Updated Jul 4, 2024
One-click install
npx skills add https://github.com/CommunityToolkit/Aspire --skill git-workflow-communitytoolkit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-workflow
Source: https://github.com/CommunityToolkit/Aspire/tree/main/examples/squad/CommunityToolkit.Aspire.Hosting.Squad.AppHost/dev-squad/.copilot/skills/git-workflow
Command: npx skills add https://github.com/CommunityToolkit/Aspire --skill git-workflow-communitytoolkit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps teams manage the Squad branching model, providing a structured workflow for feature development, testing, and release management.

Core Features & Use Cases

  • Branching Model: Implements the Squad branching model with dev, insiders, and main branches.
  • Branch Naming: Defines conventions for issue branch naming.
  • Workflow Steps: Outlines the process for issue work, including branching, in-progress marking, PR creation, and cleanup.
  • Parallel Work: Supports parallel multi-issue work using git worktree.
  • Multi-Repo Scenarios: Handles scenarios where work spans multiple repositories.
  • Promotion Pipeline: Describes the promotion pipeline from dev to insiders and main.

Quick Start

Initialize the git workflow for a new issue by running:

git checkout dev
git pull origin dev
git checkout -b squad/{issue-number}-{slug}

Frequently Asked Questions about git-workflow

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

FAQPage Schema
What is the Squad branching model for git version control?

The Squad branching model is a git version control strategy using dev, insiders, and main branches to structure feature development, testing, and release management. It ensures a dev-first workflow with a structured promotion pipeline.

How do I manage parallel development across multiple issues in git?

To manage parallel development across multiple issues, use git worktree alongside the Squad branching model. This approach supports concurrent multi-issue work and handles scenarios where development spans multiple repositories.

How do I create a new feature branch using the Squad workflow?

To create a feature branch in the Squad workflow, checkout and pull the dev branch, then create a new branch named squad/{issue-number}-{slug}. This naming convention defines the issue branch for structured tracking.

Does the Squad branching model support multi-repository scenarios?

Yes, the Squad branching model explicitly supports multi-repository scenarios. It manages structured workflows for feature development and release management across multiple repositories during parallel multi-issue work.

What is the promotion pipeline from dev to main in this branching model?

The promotion pipeline in this branching model moves code from the dev branch to insiders, and finally to main. This structured workflow ensures proper testing and release management before deploying features.

Can I use this Squad workflow without git worktree?

While the Squad branching model enforces branch naming and promotion pipelines, using git worktree is required for parallel multi-issue work. Without it, managing concurrent development across multiple repositories becomes unstructured.