Conventional Branch is a specification for Git branch names. It defines a small convention, <type>/<description>, in which every branch declares its own purpose — turning a branch name into something your CI/CD pipelines, review policies, and tooling can act on directly.

The specification is published in machine-readable form, with a JSON Schema, permanent version-pinned endpoints, and language-agnostic conformance fixtures, so supporting it is a solved problem for any tool.

English · 简体中文 · 繁體中文 · 日本語 · Deutsch · Español · Français · Polski · Português (Brasil) · Русский · ภาษาไทย

Teach your AI coding assistant (Claude Code, Cursor, and more) to create and validate branch names that follow the specification.

Install the Conventional Branch Skill with:

npx skills add conventional-branch/conventional-branch --skill conventional-branch

Then just ask your agent to create a branch — it will follow the convention automatically.

If you find this project helpful, follow us and give it a ⭐️ on GitHub! Your support helps developers discover and adopt the specification.