45844de534
Consolidate the repository into clearer apps, tools, and layered docs areas so contributors can navigate and maintain it more reliably. Align validation, metadata sync, and CI around the same canonical workflow to reduce drift across local checks and GitHub Actions.
1.2 KiB
1.2 KiB
Rollback Procedure
Use this when a structural refactor, generated artifact refresh, or release prep needs to be backed out safely.
Before Rolling Back
- Capture the current branch name with
git branch --show-current. - Review changed files with
git status --short. - Decide whether you need to keep any generated files before reverting.
Safe Rollback Flow
- Create a temporary safety branch:
git switch -c rollback-safety-check
- Verify the repository still reports the expected changed files:
git status --short
- Switch back to the original branch:
git switch -
- If you need to discard only this refactor later, revert the relevant commit(s) or restore specific files explicitly:
git restore README.md CONTRIBUTING.md package.json package-lock.json
git restore --staged README.md CONTRIBUTING.md package.json package-lock.json
- If the refactor has already been committed, prefer
git revert <commit>over history-rewriting commands.
Notes
- Avoid
git reset --hardunless you have explicit approval and understand the impact on unrelated work. - For generated artifacts, regenerate after rollback with the standard scripts instead of manually editing them.