The latest articles on DEV Community by Cleverson Trujilu Geronimo Junior (@cleverson_corbeaux). https://dev.to/cleverson_corbeaux https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4101880%2F81e77f81-4474-4d09-872f-9293d6b1814c.jpg https://dev.to/cleverson_corbeaux en Cleverson Trujilu Geronimo Junior Sun, 30 Aug 2026 23:05:02 +0000 https://dev.to/cleverson_corbeaux/supercharge-git-flow-zsh-shortcuts-automated-semver-claude-code-integration-pbi https://dev.to/cleverson_corbeaux/supercharge-git-flow-zsh-shortcuts-automated-semver-claude-code-integration-pbi <p>While Git Flow (specifically the AVH edition) remains a solid branching model for managing releases and hotfixes in structured production environments, running its full suite of CLI commands daily can feel tedious and error-prone.</p> <p>Switching branches, stashing uncommitted work, synchronizing <code>develop</code> and <code>main</code>/<code>master</code>, calculating the next Semantic Version (SemVer), drafting tag release notes, and pushing tags across multiple remotes introduce friction that slows down engineering velocity.</p> <p>To solve this, I built <strong><a href="https://github.com/cleversontrujilu/zsh-git-flow-shortcuts" rel="noopener noreferrer">git-flow-shortcuts</a></strong>: a lightweight Zsh plugin that streamlines the entire Git Flow lifecycle with <strong>Conventional Commits</strong>, automated <strong>SemVer bumping</strong>, transparent <strong>stash/pop handling</strong>, and an optional <strong>Claude Code skill</strong>.</p> <h2> ⚡ Key Highlights </h2> <ul> <li>🔄 <strong>Safe Base Branch Sync (<code>gup</code>):</strong> Automatically pulls the latest changes for both <code>develop</code> and <code>main</code>/<code>master</code> via <code>--ff-only</code>, while safely stashing and restoring your working directory.</li> <li>🏷️ <strong>Automated SemVer Calculation:</strong> Determines the next release/hotfix version based on existing Git tags (e.g., <code>1.4.2</code> $\rightarrow$ <code>1.5.0</code> for releases or <code>1.5.0</code> $\rightarrow$ <code>1.5.1</code> for hotfixes).</li> <li>💬 <strong>Conventional Commits Engine (<code>gcMsg</code>):</strong> Enforces structured commits (<code>feat(scope): message</code>) with built-in pull/push sync and breaking change flags (<code>--breaking</code>).</li> <li>📦 <strong>Seamless Release &amp; Hotfix Finish:</strong> Merges to both target branches without popping up annoying interactive merge editors, creates annotated tags from markdown changelogs, and pushes branches + tags upstream.</li> <li>🤖 <strong>AI-Orchestrated via Claude Code:</strong> Includes a ready-to-use skill in <code>bonus/skill-claude-code/</code> so an AI CLI agent can analyze your diffs and orchestrate these commands directly.</li> </ul> <h2> 🛠️ Installation </h2> <p>You can install it using your preferred Zsh plugin manager or standard shell configuration:</p> <h3> Oh My Zsh </h3> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code>git clone https://github.com/cleversontrujilu/zsh-git-flow-shortcuts <span class="se">\</span> <span class="s2">"</span><span class="k">${</span><span class="nv">ZSH_CUSTOM</span><span class="k">:-</span><span class="nv">$HOME</span><span class="p">/.oh-my-zsh/custom</span><span class="k">}</span><span class="s2">/plugins/git-flow-shortcuts"</span> </code></pre> </div> ai git zsh productivity