rollback

Restores a Syntaris project to its last known-good gate, including repository commits and foundation memory artifacts.

Updated Apr 24, 2026
One-click install
npx skills add https://github.com/brianonieal/Syntaris --skill rollback-brianonieal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rollback
Source: https://github.com/brianonieal/Syntaris/tree/main/.claude/skills/rollback
Command: npx skills add https://github.com/brianonieal/Syntaris --skill rollback-brianonieal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill restores a Syntaris project to a previous known-good gate when a completed gate introduced bad code, lost tests, or incorrect architecture and you need to recover cleanly without leaving the project in a drifted state.

Core Features & Use Cases

  • Atomic project rollback: Reverts the code, version roadmap, and Syntaris memory artifacts together so the repository stays consistent.
  • Gate-aware recovery: Supports the current Syntaris gate tags and older Blueprint gate tags for projects that were upgraded over time.
  • Safety-first workflow: Shows the target tag, affected commits, restored foundation files, and uncommitted changes before any destructive action runs.
  • Use Case: A completed gate shipped a broken refactor and the agent must return the project to the last closed gate while preserving the correct foundation snapshots and correction history.

Quick Start

Ask the assistant to roll back the project to the last gate and preview the exact code and foundation file changes before proceeding.

Frequently Asked Questions about rollback

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I revert a git project to a previous snapshot after a bad commit?

To revert a git project to a previous snapshot, you apply an atomic stash-and-reset that restores repository commits alongside foundation memory artifacts. This ensures the project returns to a known-good gate without leaving the repository in a drifted state.

What is the best way to roll back broken code changes while preserving project memory?

Rolling back broken code changes while preserving project memory requires an atomic recovery process that reverts both repository commits and foundation memory artifacts together. This keeps the code, version roadmap, and memory snapshots perfectly consistent.

Can I restore a project to a previous gate tag if I have uncommitted changes?

Yes, you can restore a project to a previous gate tag with uncommitted changes present. The workflow performs an atomic stash-and-reset execution that safely handles uncommitted changes while restoring the target gate's repository commits and foundation files.

Does this rollback process support older Blueprint snapshot directories?

Yes, the rollback process supports older Blueprint snapshot directories. It is gate-aware and can restore both current Syntaris gate tags and legacy Blueprint gate tags for projects that have been upgraded over time.

How does the recovery workflow verify code before executing destructive git resets?

The recovery workflow verifies code before destructive git resets by previewing the target tag, affected commits, restored foundation files, and uncommitted changes. This safety-first approach ensures you see exactly what will happen before any destructive action runs.

Why do I need to restore foundation memory artifacts during a git version rollback?

Restoring foundation memory artifacts during a git version rollback is necessary to maintain architectural state consistency. Reverting only repository commits would leave the version roadmap and memory snapshots drifted, causing the project's correction history to become inconsistent.