safe-versioning
Skill0 starsChanged 23 days agoMITView on GitHub
Manages checkpoints, parallel drafts (branches), version comparisons, conflict resolution, and zero-data-loss rollbacks in plain non-technical language. Use this skill whenever the user asks to save a version, create an alternative draft, check what changed, merge drafts, resolve conflicts, or undo changes.
In this repository6 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- okf-librarianSkill
- onboardingSkill
- task-managerSkill
- workspace-assistantSkill
The file
Files
Máquina del Tiempo y Versionado Seguro (safe-versioning)
Opera Git de forma 100% determinista a través de git-ops.sh, traduciendo cada acción a lenguaje humano claro.
Procedimientos por Intención del Usuario
1. Guardar un punto de control ("Guarda cómo vamos")
- Ejecuta:
sh .agents/scripts/git-ops.sh checkpoint "<Resumen claro de lo realizado>" - Si devuelve
CHECKPOINT_STATUS=SAVED, confirma brevemente qué quedó guardado. Si el avance pertenece a una tarea registrada, añade--task IDal comando; puedes repetirlo para asociar varias tareas. Consultatask-managerpara los estados y la evidencia: guardar avances no termina tareas automáticamente. - Si devuelve
CHECKPOINT_STATUS=BLOCKED, lee el diagnóstico del hookpre-commit(ej. un error enknowledge/o un archivo >50 MB), corrígelo o explícalo en palabras simples y vuelve a intentar. Jamás uses--no-verify.
2. Crear o cambiar entre borradores paralelos ("Probemos otra versión sin tocar la actual")
- Crear borrador nuevo:
sh .agents/scripts/git-ops.sh draft-create "<nombre-corto>" - Consultar borradores existentes:
sh .agents/scripts/git-ops.sh draft-list - Cambiar a otro borrador (o volver a
main/principal):
(Nota:sh .agents/scripts/git-ops.sh draft-switch "<nombre-o-main>"draft-switchguarda automáticamente los cambios pendientes antes de cambiar para que nada se pierda). - Incorporar un borrador aprobado en la versión principal:
- Cambia a
maincondraft-switch main. - Ejecuta:
sh .agents/scripts/git-ops.sh merge-draft "<nombre-del-borrador>"
- Cambia a
3. Revisar qué cambió ("¿Qué modificamos desde ayer?")
- Consulta el historial estructurado:
sh .agents/scripts/git-ops.sh history-human 10 - Si el usuario pide el detalle entre dos momentos, usa
git diff <ref1>..<ref2> -- workspace/de solo lectura y resume los cambios en viñetas comprensibles (qué párrafos, cifras o secciones se agregaron, quitaron o ajustaron), sin volcar código diff crudo salvo que lo pida.
4. Deshacer cambios sin riesgo ("Deshaz esto / Vuelve a la versión anterior")
Usa siempre undo-safe, que crea automáticamente una etiqueta inmutable rescate/YYYYMMDD-HHMMSS-* con todos los archivos (incluso nuevos sin guardar) antes de tocar nada:
- Descartar cambios recientes aún no guardados:
sh .agents/scripts/git-ops.sh undo-safe working - Volver al punto de guardado inmediatamente anterior:
sh .agents/scripts/git-ops.sh undo-safe last - Restaurar un punto específico del historial (o incluso recuperar un
rescate/*):sh .agents/scripts/git-ops.sh undo-safe "<referencia>"
Informa al usuario que sus documentos regresaron a la versión solicitada y que, por seguridad, el estado descartado quedó respaldado por si cambia de opinión.
Si devuelve UNDO_STATUS=BLOCKED_IGNORED_FILES, no se modificó ningún archivo ni se creó un rescate. Explica que los archivos locales excluidos indicados deben moverse fuera del repositorio antes de restaurar. No los añadas forzadamente al respaldo: pueden contener secretos. Los archivos excluidos que no colisionan se conservan sin bloquear la operación.
5. Conciliar conflictos sin tecnicismos (CONFLICT_STATE=true)
El usuario jamás debe ver <<<<<<< ni >>>>>>>:
- Ejecuta
sh .agents/scripts/git-ops.sh conflict-checkpara listar los archivos afectados. - Abre cada archivo con conflicto, extrae el texto de la Opción A y el de la Opción B, y preséntaselos al usuario en lenguaje natural preguntando cuál prefiere conservar (o cómo combinarlos).
- Edita el archivo dejando el texto limpio elegido (eliminando todos los marcadores
<<<<<<<,=======,>>>>>>>). - Ejecuta
sh .agents/scripts/git-ops.sh conflict-checkpara confirmar queUNRESOLVED_MARKERS=false(CONFLICT_STATE=ready_to_checkpointsi provenía de unir dos borradores, oCONFLICT_STATE=false). - Cierra la conciliación guardando el punto de control:
sh .agents/scripts/git-ops.sh checkpoint "Conciliar cambios entre versiones"
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
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.

