managing-git-workflow

The managing-git-workflow skill is an essential tool for developers contributing to the HASH ecosystem. It ensures that all code changes maintain strict traceability to Linear issues, which serves as the project's primary source of truth for task management and development progress. By automating the validation of git conventions, this skill helps maintain a clean, navigable development history and ensures that team members adhere to consistent communication standards during code reviews.

• Enforces branch naming conventions using the <shortname>/h-XXXX-description pattern to link work directly to Linear tickets.

• Standardizes pull request titles in the H-XXXX: Description format to improve visibility across the repository.

• Provides a template-driven PR creation process, ensuring that purpose, implementation details, and pre-merge checklists are systematically addressed.

• Facilitates the code review process by providing specific commands to fetch full PR metadata, pull diffs, and inspect inline comments.

• Integrates with external tools like gh (GitHub CLI) to ensure that reviewers have the necessary context from both GitHub and the Linear issue tracker.

• Ensure you have the Linear MCP server configured to allow the skill to fetch issue details directly using the h-XXXX identifier.

• Always use the provided PR template at .github/pull_request_template.md to ensure all required fields, including tests, demo materials, and documentation impact, are covered.

• When performing a review, use the recommended gh api commands to retrieve the full diff and comments, rather than truncated summaries.

• Use the skill whenever you are initializing a new task, submitting code, or reviewing a peer's implementation to minimize friction in the merge process.

• Pay close attention to the requirement for uppercase 'H' in PR titles versus lowercase 'h' in branch names; this distinction is critical for system parsing.

• The skill acts as a guardrail; if your workflow deviates from these standards, it will offer immediate suggestions for correction, helping you stay aligned with the team's engineering practices.