# Khoabd Paperclip Git Workflow

> Git Workflow & Versioning

- Skill: `tomevault-io/khoabd-paperclip-git-workflow` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/khoabd-paperclip-git-workflow`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/khoabd-paperclip-git-workflow/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/khoabd-paperclip-git-workflow

---


# Git Workflow & Versioning

One commit = one logical change. Branch names describe work. PRs are small.

## Branch Strategy (GitHub Flow)

```
main ──────────────────────────────────── (always deployable)
       └── feature/ATO-123-add-login ── (short-lived)
       └── fix/ATO-456-null-pointer ──
       └── release/v1.2.0 ────────────  (optional for scheduled releases)
```

## Commit Message Format
```
type(scope): short description

Body explaining WHY (optional, 72 char wrap)

Refs: ATO-123
```
Types: `feat`, `fix`, `docs`, `refactor`, `test`, `chore`, `ci`

## PR Checklist
- [ ] Branch named with issue ID: `feat/ATO-123-description`
- [ ] Commits are atomic (one logical change)
- [ ] PR description explains WHY not WHAT
- [ ] Tests pass
- [ ] No merge conflicts
- [ ] Linked to issue

## Versioning (SemVer)
- `MAJOR.MINOR.PATCH`
- MAJOR: breaking change
- MINOR: new feature, backward compatible
- PATCH: bug fix

## Red Flags
- Committing directly to main
- `git push --force` on shared branches
- Commits with message "fix" or "wip"
- PRs with 50+ files changed

---
> Source: [khoabd/paperclip](https://github.com/khoabd/paperclip) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-16 -->