Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving conflicts, or when you need to organize work across multiple parallel streams.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Git Workflow and Versioning
## Overview
Git is your safety net. Treat commits as save points, branches as sandboxes, and history as documentation. With AI agents generating code at high speed, disciplined version control is the mechanism that keeps changes manageable, reviewable, and reversible.
## When to Use
Always. Every code change flows through git.
## Core Principles
### Trunk-Based Development (Recommended)
Keep `main` always deployable. Work in short-lived feature branches that merge back within 1-3 days. Long-lived development branches are hidden costs — they diverge, create merge conflicts, and delay integration. DORA research consistently shows trunk-based development correlates with high-performing engineering teams.
```
main ──●──●──●──●──●──●──●──●──●── (always deployable)
╲ ╱ ╲ ╱
●──●─╱ ●──╱ ← short-lived feature branches (1-3 days)
```
This is the recommended default. Teams using gitflow or long-lived branches can adapt the principles (atomic commits, small changes, descriptive messages) to their branching model — the commit discipline matters more than the specific branching strategy.
…
The line at the top of this page pins the label git:20260627.bd6e9ea, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
GET https://markdownregistry.com/api/v1/artifacts/art_b2uiwkmd3faza56f
GET https://markdownregistry.com/api/v1/resolve?ref=hamza-ali-shahjahan/hamzaish/git-workflow-and-versioning
GET https://markdownregistry.com/api/v1/blob/b1a84eac7a47f6e2985a27733137d862fcdeb552eefe2bd17629e1f3c20e0e97
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
hamza-ali-shahjahan/hamzaish · _archive/v0/agents/_orchestrator/SKILL.md · Top-level routing brain. Given any user request, identifies the product + stage + intent, then routes to the right…
hamza-ali-shahjahan/hamzaish · _archive/v0/agents/idea/competitor-mapper/SKILL.md · Map the competitive landscape by tier (direct/indirect/acquirer/adjacent) and argue why each could win. Antidote to…
hamza-ali-shahjahan/hamzaish · _archive/v0/agents/idea/devils-advocate/SKILL.md · Stress-test an idea or hypothesis. Build the strongest possible case AGAINST it, find disconfirming evidence, and…
hamza-ali-shahjahan/hamzaish · _archive/v0/agents/idea/idea-generator/SKILL.md · Generate startup ideas grounded in Hamza's existing patterns, current trends, and validated demand signals. Never just…
hamza-ali-shahjahan/hamzaish · _archive/v0/agents/idea/interview-synthesizer/SKILL.md · Synthesize a batch of customer interviews into evidence-for + evidence-against the hypothesis, with pattern surfacing…
hamza-ali-shahjahan/hamzaish · _archive/v0/agents/idea/problem-sharpener/SKILL.md · Turn vague problem observations into testable hypothesis statements with specific who/when/severity/current-workaround…
addyosmani/agent-skills · skills/git-workflow-and-versioning/SKILL.md · Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving…
sandbaseai/sandbase-skills · marketing/git-workflow-and-versioning/SKILL.md · Plan, implement, or review git workflow and versioning work in an existing codebase with compatibility, security, and…
shashankswe2020-ux/whoop-mcp · .github/skills/git-workflow-and-versioning/SKILL.md · Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-codex/.agents/skills/git-workflow-and-versioning/SKILL.md · Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-claude/.claude/skills/git-workflow-and-versioning/SKILL.md · Structures git workflow practices. Use when making any code change.
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-forgecat/platforms/cursor/.cursor/skills/git-workflow-and-versioning/SKILL.md · Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-forgecat/platforms/codex/.agents/skills/git-workflow-and-versioning/SKILL.md · Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-forgecat/skills/git-workflow-and-versioning/SKILL.md · Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving…