Git

Router

references/read-only.md

references/cli-help.md

references/commit-workflow.md

references/branch-workflow.md

references/worktree-workflow.md

references/worktree-maintenance.md

references/worktree-summary.md

references/tag-workflow.md

references/pr-workflow.md

references/pr-review-workflow.md

references/advanced-workflows.md

Config (Edit Here)

cd

.git/

WORKTREES_DIR=./.worktrees
WORKTREE_PATH=$WORKTREES_DIR/<topic>

../.worktrees

~/worktrees/<repo>

WORKTREES_DIR

references/worktree-workflow.md

Resilience Rules (Worktrees)

• If multiple worktree root folders are detected (example: both

  ./.worktrees/

  and

  ../repo-feature-x/

  exist), do not delete anything by default.
• Prefer consolidating into

  WORKTREES_DIR

  using

  git worktree move

  (when possible) or a remove+re-add plan.
• If stale metadata exists, propose a cleanup plan:

  git worktree prune

  + remove/quarantine orphan directories (with confirmation).

Global Safety Rules (Never Violate)

• Never force push to main/master.
• Never commit secrets (env files, keys, credentials).
• Never rewrite history that is already pushed unless explicitly requested.
• Always show what will change before an irreversible action.

Confirmation Policy

• git add

  ,

  git commit

  ,

  git push

• git merge

  ,

  git rebase

  ,

  git reset

  ,

  git revert

• git worktree add

  ,

  git worktree remove

• git tag

  (create/delete)

• git branch -d/-D

Quick Start

# Read-only
git status
git diff

# Commit
git diff --cached
git commit -m "feat(scope): why"

# Worktrees
git worktree list