Skip to content

apuya/react-basics-ui / .claude/skills/version-control

version-control

Verified

Manages branch naming, version tracking, and branch lifecycle. Use when user wants to create, list, rename, or clean up branches, or asks about versioning. Triggers on "branch", "version", "new branch", "create branch", "rename branch", "cleanup branches", "what version", "release".

FileKindSize
SKILL.mdskill md7.1 KB
branch-conventions.mdmarkdown3.2 KB

branch-conventions.md

View on GitHub
# Branch Naming Conventions

Full reference for react-basics-ui branch naming standards.

---

## Format

```
<type>/<lowercase-kebab-description>[-vN[.M]]
```

### Type Prefixes

| Prefix       | Use when...                                      |
|-------------|--------------------------------------------------|
| `feature/`  | Adding new functionality or rebuilding a feature |
| `fix/`      | Fixing a bug                                     |
| `chore/`    | Tooling, CI, dependencies, config                |
| `refactor/` | Restructuring code without changing behavior     |
| `release/`  | Preparing a versioned release                    |
| `hotfix/`   | Urgent fix for production                        |

### Description

- **Lowercase kebab-case**: `pricing-profiles`, not `PricingProfiles` or `pricing_profiles`
- **Descriptive**: Name the feature or fix, not the ticket — `feature/date-picker` not `feature/JIRA-123`
- **Concise**: 2-4 words is ideal — `fix/badge-truncation` not `fix/the-bug-where-badge-text-does-not-truncate`

### Version Suffix (feature branches only)

| Scenario | Suffix | Example |
|----------|--------|---------|
| First implementation of a feature | None (implicitly v1) | `feature/data-table` |
| Major rework / rebuild | `-v2`, `-v3`, etc. | `feature/data-table-v2` |
| Minor revision of a version | `-vN.M` | `feature/data-table-v2.1` |

**Rules:**
- Version suffixes only apply to `feature/` branches
- Increment the major version when substantially rebuilding the feature
- Use minor versions for targeted fixes or refinements to an active version branch
- Other types (`fix/`, `chore/`, etc.) never get version suffixes

---

## Base Branch Policy

| Acceptable bases | Notes |
|-----------------|-------|
| `main` | Default — always up to date |
| `dev` / `develop` | Acceptable for integration work |
| Any other branch | Warn — may be outdated or stale |

---

## Examples

### Features with version history

```
feature/table              (v1 — implicitly)  ✓ merged
feature/table-v2                              ✓ merged
feature/table-v2.1                            ✓ merged

feature/date-picker        (v1 — implicitly)  ✓ merged
feature/date-picker-v2                        ✓ merged
```

### Features without iterations (single version)

```
feature/autocomplete   ✓ merged
feature/file-input     ✓ merged
feature/stepper        ✓ merged
feature/timeline       ✓ merged
feature/tree           ✓ merged
```

### Legacy names that don't follow the convention

Some branches predate the convention (`set-up`, `feat-components`). They are
merged and left as-is — the convention applies going forward only.

---

## Quick Reference

```
✓  feature/date-picker
✓  feature/date-picker-v2
✓  feature/date-picker-v2.1
✓  fix/modal-focus-trap
✓  chore/upgrade-tailwind-4
✓  refactor/shared-form-styles
✓  release/v2.0.0
✓  hotfix/dropdown-keyboard-nav

✗  date-picker              (missing type prefix)
✗  feature/My-Feature       (uppercase)
✗  feature/date-picker_v2   (underscore instead of hyphen)
✗  v2                       (bare version — use release/v2.0.0)
✗  fix/badge-v2             (version suffix on non-feature branch)
✗  chore-v3                 (missing slash separator)
```
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 197kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall