# New Branch

> Create a branch following the project's GitFlow Lite model Use when this capability is needed.

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

---


# /new-branch

Cut a new branch under the GitFlow Lite model.

## Branch model

```
master  = released / stable (tagged on release; protected)
dev     = integration branch (protected)
feat/*  = cut from dev  → PR → merge into dev
fix/*   = cut from dev  → PR → merge into dev
hotfix/* = cut from master → merge into master AND synced into dev (double merge)
release  = dev → master + tag on master (no separate release branch)
```

## Steps

1. Ask (or infer) the change type: `feat`, `fix`, or `hotfix`.
2. Pick the parent:
   - `feat/*`, `fix/*` → branch from **`dev`**.
   - `hotfix/*` → branch from **`master`**.
3. Update the parent first:
   ```bash
   git checkout <parent>
   git pull --ff-only
   ```
4. Create the branch with a kebab-case slug:
   ```bash
   git checkout -b feat/<short-slug>
   ```
5. For a `hotfix`, remember it must later merge into **both** `master` and `dev`.

## Naming

- `feat/add-agentic-rerank`, `fix/empty-profile-crash`, `hotfix/lancedb-conn-leak`.
- Lowercase, hyphen-separated, no spaces, concise.

Never commit directly to `master` or `dev` — always via a branch + PR.

---
> Source: [EverMind-AI/EverOS](https://github.com/EverMind-AI/EverOS) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-22 -->