agentleFS
librosdeialibrosdeia/builder-method-claude-plugin/skills/undo/SKILL.md

undo

Skill0 starsChanged 5 days agoMITView on GitHub

Go back to an earlier saved point of a Builder project safely — lists the checkpoints in plain language and restores one without deleting history (new commit or new branch). Use when something broke and the user wants to go back, or runs /builder:undo.

  • Deletes or force-pushes
  • Commits and pushes

8 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

8 rules. 0 are common, 2 are distinctive, and 6 are very specific to this project.

  • 0

    Common

    Most of the 5 edited versions we read keep these.

  • 2

    Distinctive

    This author's own choices. Worth a look.

  • 6

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  • could be automatic: a setting could enforce it
  1. Very specific:

    Read ${CLAUDE_PLUGIN_ROOT}/skills/_shared/tone.md and ${CLAUDE_PLUGIN_ROOT}/skills/_shared/state-rules.md.

    line 8
  2. Very specific:

    If you have no shell tool, say that undoing needs a terminal: open this same folder in Claude Code and run /builder:undo.

    line 10
  3. Distinctive:

    Never: use git reset --hard, git push --force, git checkout -- ., git clean, or anything else that deletes work or history.

    line 12
  4. Very specific:

    Run git log --format='%h|%ad|%s' --date=relative -n 30, and show the builder: commits as a plain numbered list, newest first:

    line 16
  5. Very specific:

    If there are uncommitted changes (git status --porcelain), say so.

    line 20
  6. Very specific:

    add a one-line note to builder/decisions.md if a decision was undone.

    line 35
  7. Distinctive:

    update the progress page.

    line 36
  8. Very specific:

    Commit the state change: builder: undo to after T<n>.

    line 38

“Common” is measured: kept by at least 6 in 10 of the 5 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Undo safely

Read ${CLAUDE_PLUGIN_ROOT}/skills/_shared/tone.md and ${CLAUDE_PLUGIN_ROOT}/skills/_shared/state-rules.md.

If you have no shell tool, say that undoing needs a terminal: open this same folder in Claude Code and run /builder:undo. Then stop.

Never use git reset --hard, git push --force, git checkout -- ., git clean, or anything else that deletes work or history.

1 · List the saved points

Run git log --format='%h|%ad|%s' --date=relative -n 30, and show the builder: commits as a plain numbered list, newest first:

3. After T3 — Booking form (yesterday)

If there are uncommitted changes (git status --porcelain), say so. Offer to save them first as a commit (builder: work in progress before undo) so nothing is lost.

2 · Choose and confirm

Ask which point to go back to, unless the user already said. Explain in plain words what will change ("the work from T4 and T5 will be undone; it stays in the history, so we can bring it back"). Get a clear yes. A "yes" already given in the request counts.

Offer two ways (recommend the first):

  1. Undo the later work (recommended): git revert --no-edit <target-sha>..HEAD, where <target-sha> is the saved point the user chose (the range covers every commit after it). This creates new commits that cancel the later ones, so the history stays complete. Then check it worked: git diff <target-sha> -- . ':!builder' must print nothing.
  2. Restore on a separate branch: git switch -c builder/restore-<n> <target-sha>. The current version stays untouched on the original branch.

3 · Update the state

After restoring:

  • set the undone tasks back to pending in state.json;
  • set currentPhase and the steps to match;
  • add a one-line note to builder/decisions.md if a decision was undone;
  • update the progress page.

Commit the state change: builder: undo to after T<n>.

Tell the user what the project looks like now and what comes next (/builder:next).

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.