# Initialize Scoped Branch

> Initialize a narrowly scoped feature branch after checking repository state, ownership, and the exact starting revision.

- Skill: `homenshum/initialize-scoped-branch` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add homenshum/initialize-scoped-branch`
- Raw SKILL.md: https://api.skillmd.com/api/skills/homenshum/initialize-scoped-branch/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: HomenShum (https://skillmd.com/u/homenshum)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/homenshum/initialize-scoped-branch

---


# Initialize a scoped branch

Read [the execution contract](references/contract.json) before starting. Validate the final receipt with its parameterized `verification.argv`, replacing `{python}`, `{skill_dir}`, and `{receipt}` with concrete local values.

Use only when the user requested branch work or the repository workflow
requires it.

1. Inspect status, current branch, remotes, and the intended base without
   modifying files.
2. Stop if unrelated changes overlap the requested scope; preserve them.
3. Record the user outcome, named proof, base revision, and owned paths.
4. Create one branch using the repository naming convention. Never reset,
   delete, or switch away from uncommitted work to force a clean state.
5. Verify the new branch points at the intended base and refresh `HANDOFF.md`.

Branch creation does not authorize commit, push, pull request, or deployment.

