| name | start-session |
| description | Prepare a BrainRot repository work session on a new task branch created from the latest remote main branch. Use when starting a new task, initializing a fresh coding session, or when the user asks to create a branch before implementation. |
Start a Work Session
This workflow is mandatory before every task that may modify repository files, create commits, or push changes. Create the task branch before changing files. Never commit or push task work directly to main or another default branch.
Choose the branch name
Use <type>/<task-slug> with a short lowercase hyphenated slug:
feat/ for new behavior
fix/ for bug fixes
docs/ for documentation-only work
chore/ for tooling or repository maintenance
refactor/ for behavior-preserving restructuring
test/ for test-only changes
Create the branch
- Inspect
git status --short --branch and git status --porcelain.
- Stop if tracked or untracked changes exist. Do not stash, discard, or carry them onto a new base without explicit user direction.
- Confirm the
origin remote and origin/main are expected for this repository.
- Run
git fetch origin main. If it fails, stop; do not claim a branch is based on latest main or fall back to stale local state.
- Check for the proposed branch locally and on
origin. If it already exists, stop and request a different name.
- Run
git switch --create <branch> origin/main.
- Verify the current branch is
<branch> and that HEAD equals the fetched origin/main commit before implementation begins.
- Keep all task edits, commits, and pushes on this branch and publish them through a pull request.
Do not run this workflow when the user explicitly asks to continue an existing branch.