branching-workflow

Solid

When and how to use the coding-agent CLI's `/rewind` to abandon a bad branch and restart from a prior turn. Documents the recovery primitive for the layered eval architecture's Layer 3 (universal recovery toolkit) and the branch-and-retry path. Use when an output is going off the rails, when a Critic verdict says BLOCK, or when a path-of-least-resistance failure has corrupted the conversation context. Pairs with /save (extract insight first), /scope (re-frame after rewind), and the Critic skill (verdict-driven branch trigger).

AI & Automation 3 stars 0 forks Updated today MIT

Install

View on GitHub

Quality Score: 79/100

Stars 20%
20
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Branching workflow `/rewind` (Claude Code v2.0.0+): fork from a prior assistant turn, take a different forward path. The abandoned branch's tokens leave context entirely. The cleanest zoom-out primitive available natively in the CLI. This skill: WHEN to branch, WHAT to preserve first, HOW to recover. Pairs with the Critic skill (a BLOCK verdict often triggers a branch). ## When to branch Branch (use `/rewind`) when ALL three apply: 1. **The current path is going off the rails.** Output is wrong, the agent is confidently asserting unverified claims, the classifier flagged high-stakes but the Critic says BLOCK, or a path-of-least-resistance failure (closure-bias / search-truncation / sycophancy) has visibly compromised the conversation. 2. **Continuing-with-corrections would be more polluting than rewinding.** "Let me reconsider" + retry-emit will leave the bad branch in context as residue. Rewinding leaves it cleaner. 3. **The bad path started recently enough.** If the divergence is 1-3 turns back, rewind. If it's 10+ turns back, /save the insights + /compact + start fresh with prepended context. Do NOT branch when: - The output is acceptable but imperfect (continue-with-revision is cheaper). - You're in the middle of a long-running task with persistent state (database writes, sent messages, scheduled tasks fired). Branch does NOT undo external side effects. - You're under 50 turns into the session (the cost of pollution is low; rewind overhead doesn't pay back yet). ...

Details

Author
0xUrsanomics
Repository
0xUrsanomics/utopia-os
Created
5 days ago
Last Updated
today
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

branch-lifecycle

Run work on a branch or git worktree from start to finish — branch per scope, commit against pins, keep parallel agents from colliding, and finish cleanly. Makes the executor's "one scope at a time" enforceable by giving each scope its own tree. Use when starting a unit of work, running agents in parallel, or finishing a development branch.

0 Updated 3 days ago
r3vs
AI & Automation Listed

work-the-branch

Workflow for advancing in-progress work on the current branch, at any stage, through to review-ready. Assesses where the branch stands (uncommitted changes, unpushed commits, missing or stale PR, remaining ticket scope), plans what is left, implements via a team of specialist agents, verifies, and ships the result: committed, pushed, PR created or updated, Jira transitioned. Use when the user invokes /work-the-branch.

3 Updated 3 days ago
chancegraff
AI & Automation Solid

git-workflow

Guides safe, professional Git usage — branching strategies, atomic clean commits, conventional commit messages, interactive rebase (squash/fixup/reword/reorder), merge vs rebase decisions, conflict resolution, and recovery of lost work via reflog. Use this skill when the user asks to create or clean up a branch, write or amend commits, squash or reorder history, rebase onto main, resolve merge conflicts, undo a bad commit/merge/reset, recover deleted commits or branches, find lost work, fix a detached HEAD, force-push safely, or generally "clean up my git history" before opening a PR.

3 Updated today
JayRHa