git-workflow

Enforce feature-branch pull request workflows and prevent direct commits to main.

59|12|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/etylsarin/opencastle --skill git-workflow-etylsarin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-workflow
Source: https://github.com/etylsarin/opencastle/tree/main/src/orchestrator/skills/git-workflow
Command: npx skills add https://github.com/etylsarin/opencastle --skill git-workflow-etylsarin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents direct commits to main, enforces traceable feature branches, and reduces lost work or unreviewed changes by defining a standardized commit, push, and pull request workflow and discovered-issues policy.

Core Features & Use Cases

  • Branching conventions: Require branches created from main with the pattern type/ticket-id-short-description (e.g., fix/TAS-21-places-redirect-loop) to keep history organized and linkable to task tracker issues.
  • PR Safety Rules: Enforce opening pull requests for all changes, forbid direct merges to main, and prohibit unsafe operations like force-pushing shared branches.
  • Delivery Outcome Checklist: Provide a required checklist for every task: dedicated branch, atomic commits referencing the issue ID, pushed branch, open PR, and linked task tracker entry.
  • Discovered Issues Policy: Mandate searching known issues, tracking new findings in KNOWN-ISSUES.md or creating task-tracker bugs with evidence and remediation options, and include fallback instructions when tracker tools are unavailable.
  • Task Tracking Guidance: Define placeholder values and procedural steps when the task-management MCP tools are not available so work remains actionable and traceable.

Quick Start

Create a feature branch from main, commit referenced work with the tracker ID, push the branch, and open a pull request for review and task linkage.

Frequently Asked Questions about git-workflow

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

FAQPage Schema
How do I prevent direct commits to main and enforce pull request workflows?

You can prevent direct commits to main by enforcing feature-branch pull request workflows that require opening pull requests for all changes, forbid direct merges to main, and prohibit unsafe operations like force-pushing shared branches.

What is the standard naming convention for git feature branches linked to task tracker issues?

The standard naming convention for git feature branches is type/ticket-id-short-description, such as fix/TAS-21-places-redirect-loop, which keeps repository history organized and linkable to task tracker issues.

How do I track discovered issues in git when task tracker tools are unavailable?

When task tracker tools are unavailable, track discovered issues by searching known issues, documenting new findings with evidence and remediation options in a KNOWN-ISSUES.md file, and using placeholder ticket values to keep work traceable.

What items belong on a delivery checklist for a git feature branch?

A git delivery checklist includes a dedicated feature branch, atomic commits referencing the issue ID, a pushed branch, an open pull request, and a linked task tracker entry to ensure complete traceability.

Can I use placeholder ticket values for issue management when my MCP task-management tools are missing?

Yes, you can use defined placeholder ticket values and procedural steps for issue management when MCP task-management tools are unavailable, ensuring work remains actionable and traceable despite missing task tracker integrations.

Why should I avoid force-pushing shared git branches during code review?

Avoid force-pushing shared git branches because it is an unsafe operation that overwrites team contributions, and PR safety rules prohibit it to maintain review integrity and traceable delivery.