managing-git-workflow

Automate HASH git workflow with branch naming, PR creation, and reviews.

1.6k|123|Updated Jul 15, 2019
One-click install
npx skills add https://github.com/hashintel/hash --skill managing-git-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: managing-git-workflow
Source: https://github.com/hashintel/hash/tree/main/.claude/skills/managing-git-workflow
Command: npx skills add https://github.com/hashintel/hash --skill managing-git-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Git workflow for HASH development, ensuring branch naming, PR clarity, and structured reviews.

Core Features & Use Cases

  • Branch naming conventions that link to Linear issues
  • PR title formats and PR template usage
  • Guidance for PR reviews and diff checks
  • Quick reference commands for PR exploration

Quick Start

Create a branch using the <shortname>/h-XXXX-description format and open a PR using the standard template.

Frequently Asked Questions about managing-git-workflow

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

FAQPage Schema
How do I set up branch naming conventions that link to Linear issues?

Branch naming in HASH git workflow follows the format `<shortname>/h-XXXX-description`, where h-XXXX references your Linear ticket. This convention ensures traceability between branches, commits, and issue tracking, so all work is linked to the original task.

What should a pull request title and description include?

Pull requests use a standard template that captures context and changes clearly. The template guides PR title formatting and description structure to ensure reviewers understand the work, dependencies are documented, and the change connects back to the Linear ticket via your branch name.

How do I conduct an effective code review in a structured git workflow?

Code reviews follow a checklist covering diff verification, testing, and compliance with branch and commit standards. The workflow guides you through checking changes against PR requirements and Linear ticket scope to maintain consistency across feature work, bug fixes, and ticket-driven tasks.

Can I use this git workflow for bug fixes and feature branches?

Yes. The workflow applies to feature work, bug fixes, and Linear-ticket-driven tasks. Branch naming, PR templates, and review checklists enforce the same format and rigor across all work types, ensuring consistent traceability regardless of task category.

What commands help me explore and manage pull requests?

The workflow includes quick reference commands for PR exploration, branch creation, and commit management. These commands streamline checking PR status, viewing diffs, and verifying branch names match the Linear ticket format before opening or reviewing.

Why does branch naming matter in a shared git workflow?

Branch naming conventions that reference Linear tickets create a traceable link from code to issue tracking, making it easy to find related work, understand context during reviews, and maintain audit trails. This prevents confusion in teams and ensures accountability across development.