{ "schema": "aiblocks-page/1", "id": "agency-engineering-git-workflow-master", "type": "agent", "name": "Git workflow planner", "summary": "Get a Git workflow plan with branch names, commit rules and a pull request checklist. Bring your team size and release pace.", "headline": "Git workflow planner", "subhead": "Tell it your team size, how often you release and where your code lives. It picks a branching style, then writes branch names, commit rules, merge rules and a review checklist. You get a one-page plan and safe commands for the first clean-up.", "job": { "id": "build-software", "name": "Build and ship software" }, "level": "intermediate", "thinking": "high", "tested": true, "updated": "2026-10-28", "first_published": "2026-10-26", "inputs": [ { "type": "question", "required": true, "label": "Question", "what": "the problem, decision or piece of work you want help with, and what a good outcome looks like" }, { "type": "source_text", "required": false, "label": "Source text", "what": "a long source in full: an article, a video or talk transcript, or notes from a book, with its title, author and link" } ], "outputs": [ { "type": "plan", "required": true, "label": "Plan", "what": "a dated plan: what to do, in what order, with a decision rule for each step" } ], "you_give": [ "Your team size and who can merge to the main branch", "How you release, such as every day, every week or numbered versions", "Where your code lives (GitHub, GitLab or Bitbucket) and any branch rules already set", "What goes wrong now, such as stale branches or big merge conflicts", "Your branch list or recent git log output (optional)" ], "you_get": [ "A recommended branching style, with the reasons", "Branch naming rules with examples", "Commit message rules", "Rules for when to merge, squash or rebase", "A pull request review checklist", "Safe commands for a first clean-up, each with its undo step" ], "use_when": [ "Your team is growing and everyone names branches and writes messages a different way.", "Feature branches stay open for weeks and merging them hurts.", "You need pull request rules that a new hire can follow on day one.", "You are choosing between merge, squash and rebase and want a clear answer for your team size." ], "skip_when": [ "You need to rewrite shared history or change live repository settings. Have a named engineer do it, using the plan as a guide.", "You want your build and release pipeline set up. Use the Deployment pipeline designer.", "You want the code inside a pull request reviewed. Use the Code reviewer agent." ], "output_sample": { "input": [ "Your team size and who can merge", "Your release pace and where your code lives", "What goes wrong now", "Your branch list or git log output (optional)" ], "prerequisites": [ "An AI that can read pasted text. It does not need access to your repository." ], "output": [ { "name": "Team and release facts", "contains": "What it learned about your team and release pace, with gaps marked MISSING." }, { "name": "Recommended style", "contains": "Trunk-based or Git flow, with the reasons it fits and what to avoid." }, { "name": "Branch names", "contains": "A naming pattern with examples." }, { "name": "Commit rules", "contains": "Message format and size rule, with an example." }, { "name": "Merge rules", "contains": "When to merge, squash or rebase, and why." }, { "name": "Pull request checklist", "contains": "What each pull request must show before it can merge." }, { "name": "First clean-up", "contains": "Safe commands for stale branches, each with its risk and undo step." } ] }, "output_shape": "TEAM AND RELEASE FACTS\n | | | | MISSING: \n\nRECOMMENDED STYLE\n | | \n\nBRANCH NAMES\n | \n\nCOMMIT RULES\n | | \n\nMERGE RULES\n | | \n\nPULL REQUEST CHECKLIST\n [ ] \n\nFIRST CLEAN-UP\n | | | \n\nASSUMPTIONS AND CHECKS STILL NEEDED\n | ", "how_to_use": [ "Download the pack from this page and add it to your AI as a skill. If you cannot, open a new chat and paste SKILL.md, then references/source-agent.md.", "Paste your team size, release pace and where your code lives. Describe what goes wrong now in a line or two.", "Add your branch list (git branch -a) or recent log output if you want a clean-up plan for your real repository.", "Say \"Plan our Git workflow. Ask once if anything is missing.\"", "Read the recommended style and its reasons first. If your team cannot follow it, say why and ask for the next best option.", "Run each git command yourself, one at a time, in a fresh clone first. Read the undo line before you run it." ], "checks": [ "The result addresses your actual task and cites the evidence used.", "Examples, role-play experience and targets are kept separate from verified results.", "Claims of tests, memory, tool access or completed actions match what actually happened." ], "next": [ { "name": "Git workflow helper", "url": "https://useaiblocks.com/skills/git-workflow-helper", "why": "Build it" } ], "source": { "by": "Michael Sitarzewski and Agency Agents contributors", "repo": "msitarzewski/agency-agents", "url": "https://github.com/msitarzewski/agency-agents/blob/b37b5bb33b78f2c1d6567d98e25ca818e3259219/engineering/engineering-git-workflow-master.md", "licence": "MIT", "original_name": "Git Workflow Master", "commit": "b37b5bb33b78f2c1d6567d98e25ca818e3259219" }, "credits": [ { "title": "Git Workflow Master", "by": "Michael Sitarzewski and Agency Agents contributors", "url": "https://github.com/msitarzewski/agency-agents/blob/b37b5bb33b78f2c1d6567d98e25ca818e3259219/engineering/engineering-git-workflow-master.md", "used": "Original agent profile, preserved in references/source-agent.md; AI Blocks adds setup and review instructions." } ], "files": [ "LICENSE", "references/source-agent.md", "SETUP.md", "source.json" ], "links": { "page": "https://useaiblocks.com/agents/agency-engineering-git-workflow-master", "markdown": "https://useaiblocks.com/agents/agency-engineering-git-workflow-master.md", "json": "https://useaiblocks.com/agents/agency-engineering-git-workflow-master.json", "instructions": "https://useaiblocks.com/skills/agency-engineering-git-workflow-master/SKILL.md", "download": "https://useaiblocks.com/skills/agency-engineering-git-workflow-master.zip", "api_item": "https://useaiblocks.com/api/v1/items/agency-engineering-git-workflow-master", "api_document": "https://useaiblocks.com/api/v1/documents/agent/agency-engineering-git-workflow-master", "mcp": "https://useaiblocks.com/mcp" } }