git-branchless

# Git-branchless Branchless treats commits as checkpoints, detached HEAD as the default work mode, and branches as publishing artifacts. This skill enforces that mental model and routes every common git workflow to its branchless equivalent. Reference docs: - `references/commands.md`: every command, flag, revset, config key. - `references/recipes.md`: concrete sequences + decision rubric. - `references/recovery.md`: undo, restack, hide, snapshot, GC semantics. --- ## Pre-flight gate [LOAD-BEARING] Before applying any rule below, confirm branchless is initialized for the current repository. Run: ``` test -d "$(git rev-parse --git-common-dir)/branchless" && git config --get branchless.core.mainBranch ``` (Resolving the git-common-dir handles linked worktrees, where `.git` is a file rather than a directory and branchless state lives in the main repo's git dir.) | Result | Skill behavior | |--------|----------------| | Both succeed | Skill is active. Apply the rules below. Acknowledge with one line: `git-branchless active — main=<value>`. | | Either fails | Skill is **silently inert**. Emit one line: `git-branchless not initialized; skill inactive`. Yield to plain git. Do **not** suggest `git branchless init` unless the user explicitly asks how to enable. | The inert path is intentional. This skill does not nag and does not refuse legitimate work in repos where branchless was never adopted. --- ## Always / Never (operation-class framing) Each rule names an **operation...