git-workflow-and-versioning SKILL.md skillA

git-workflow-and-versioning from nota-america/forgecat-agent-profiles is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

mdr add nota-america/forgecat-agent-profiles/git-workflow-and-versioning@git:20260916.3a6b22e

Pins git:20260916.3a6b22e in mdr.lock. Pin the fingerprint instead.

Audit grade

A, 17 of 17 checks passed

Kind

SKILL.md skill

Repository

nota-america/forgecat-agent-profiles

Path

profiles/addyosmani/agent-skills/for-codex/.agents/skills/git-workflow-and-versioning/SKILL.md

Versions recorded

2

Latest version

git:20260916.3a6b22e, committed Sep 16, 2026

First version recorded

Jun 10, 2026

Size

14,141 bytes

Repository stars

93

License

Apache-2.0

Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving conflicts, splitting uncommitted work in a messy working tree into clean atomic commits, opening or reviewing a pull request (PR), pushing to a remote, or when you need to organize work across multiple parallel streams. Use when cutting a release, choosing a semantic version bump, tagging, or writing a changelog.

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.
…

Read the whole file at its exact version.

How to install

mdr add nota-america/forgecat-agent-profiles/git-workflow-and-versioning@sha256:b7465d187935c525

[![mdr](https://markdownregistry.com/badge/art_3uayhakowvcmikvb.svg)](https://markdownregistry.com/a/art_3uayhakowvcmikvb)

Versions

The registry has recorded 2 versions of this file, between Jun 10, 2026 and Sep 16, 2026, about one every 98 days.

Audit of the latest version

Source

API

GET https://markdownregistry.com/api/v1/artifacts/art_3uayhakowvcmikvb
GET https://markdownregistry.com/api/v1/resolve?ref=nota-america/forgecat-agent-profiles/git-workflow-and-versioning
GET https://markdownregistry.com/api/v1/blob/b7465d187935c52546d39fdc7bd6ac36d94eda25a9500ef8c18b767d2eb116ea

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.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from nota-america/forgecat-agent-profiles

Every file in nota-america/forgecat-agent-profiles

Other files named git-workflow-and-versioning

Browse by kind, by grade A, or by owner.