Use when the user asks for release, version bump, changelog, or branch workflow beyond a single commit. Don''t use for single commits or for publishing to a package registry.
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
## Contract
| Field | Bound contract |
|---|---|
| Trigger | User asks for release, version bump, changelog, or branch workflow beyond a single commit. |
| Authority | Human-gated: previews the exact target and consequence before any push, protected-branch action, or force-push, with explicit consent required for protected branches and force-pushes; otherwise reversible local: writes only local commits, tags, and changelog edits; rollback is version control. No remote mutation without the gate. |
| Side effect | Git commits, tags, and changelog edits; protected branches and force-pushes only with explicit consent. |
| Done | History expresses logical change-sets, tags and changelog match shipped contract changes, and no unauthorized protected-branch action occurred. |
## Inputs
Required: the change-set to release or version (working-tree state, staged changes, or committed history since the last tag); the target version bump type or an explicit version string; the branch to operate on.
Optional: changelog path, remote name, tag message, prerelease suffix.
## Procedure
…
The line at the top of this page pins the label git:20260903.31c840c, 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_e2lzsorzbfwcc7pe
GET https://markdownregistry.com/api/v1/resolve?ref=outlinedriven/odin-claude-plugin/git-workflow-and-versioning
GET https://markdownregistry.com/api/v1/blob/fee02288840821b145d2994d004498b7aa28009c9019eb31260dc25d919602f3
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.
outlinedriven/odin-claude-plugin · plugins/odin-agent/skills/agent-environment-retrospective/SKILL.md · Use when a completed session needs an agent-environment retrospective. Not for an engineering retrospective from…
outlinedriven/odin-claude-plugin · plugins/odin-agent/skills/agents-md/SKILL.md · Use when a repo needs agent setup, AGENTS.md added or made lean, CLAUDE.md audited, or agent instructions scored or…
outlinedriven/odin-claude-plugin · plugins/odin-agent/skills/check-agent-compatibility/SKILL.md · Use when a human explicitly asks for a full repository agent-compatibility pass returning a scored report with…
outlinedriven/odin-claude-plugin · plugins/odin-agent/skills/claude-settings-audit/SKILL.md · Use when setting up a project, auditing agent command permissions, or asking which read-only bash commands and domains…
outlinedriven/odin-claude-plugin · plugins/odin-agent/skills/cli-for-agents/SKILL.md · Use when asked to build or review a CLI intended for coding agents and return flag-driven, pipeline-safe, idempotent…
outlinedriven/odin-claude-plugin · plugins/odin-agent/skills/harness-port-guide/SKILL.md · Use when the user asks to make the skills framework work in a new harness, IDE, or CLI. Not for remote, credential…
outlinedriven/odin-claude-plugin · plugins/odin-agent/skills/inits/SKILL.md · Use when onboarding to a repository, capturing costly conventions, constraints, or rationale, or improving AGENTS.md…
outlinedriven/odin-claude-plugin · plugins/odin-agent/skills/mcp-builder/SKILL.md · Use when asked to create an MCP server to integrate an API or service in Python or TypeScript. Not for remote…
outlinedriven/odin-claude-plugin · plugins/odin-agent/skills/multi-agent-tournament-scorecard/SKILL.md · Use when agent strategies need a reproducible finite tournament under a frozen evaluation protocol. Not for open-ended…
outlinedriven/odin-claude-plugin · plugins/odin-agent/skills/prohibit-bad-habits/SKILL.md · Use when a user wants to define patterns the agent should not do. Don''t use for remote, credential, publish, deploy…
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…