git-guardar
Skill4 starsChanged 3 days agoMITView on GitHub
[Rutina] Commit y push — la IA elige patch, minor o major, sync README/front/back, commit vX.Y.Z, tag. Use when the user invokes /guardar.
- Reads credentials
- Commits and pushes
In this repository169 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- .github/copilot-instructions.mdCopilot instructions
- .cursor/rules/00-orquestador-core.mdcCursor rule
- .cursor/rules/01-protocolos-dt.mdcCursor rule
- .cursor/rules/02-documentacion.mdcCursor rule
- .cursor/rules/03-catalogo-subagentes.mdcCursor rule
- .cursor/rules/05-multi-project-git.mdcCursor rule
- .cursor/rules/06-dt-colaboracion.mdcCursor rule
- .cursor/rules/07-orden-continuo.mdcCursor rule
- .cursor/rules/08-stack-web-default.mdcCursor rule
- .cursor/rules/10-arquitectura-backend.mdcCursor rule
- .cursor/rules/15-engineering-reuse.mdcCursor rule
- .cursor/rules/16-numeric-grounding.mdcCursor rule
- .cursor/rules/17-canvas-first.mdcCursor rule
- .cursor/rules/18-drive-contexto.mdcCursor rule
- .cursor/rules/19-gmail-contexto.mdcCursor rule
- .cursor/rules/20-frontend-ui.mdcCursor rule
- .cursor/rules/21-calendar-contexto.mdcCursor rule
- .cursor/rules/30-testing.mdcCursor rule
- .cursor/rules/31-agent-inbox.mdcCursor rule
- .cursor/rules/40-devops.mdcCursor rule
- .cursor/rules/90-seguridad-secrets.mdcCursor rule
- analisis-propuestaSkill
- arquitectoSkill
- atelier-actualizarSkill
- atelierSkill
- auditoria-legalSkill
- bragSkill
- brand-guardianSkill
- content-creatorSkill
- data-auditorSkill
- deploySkill
- development-plannerSkill
- devopsSkill
- docSkill
- dt-actualizarSkill
- dt-ayudaSkill
- dt-bootstrapSkill
- dt-calendarSkill
- dt-configSkill
- dt-driveSkill
- dt-gmailSkill
- dt-oficialSkill
- dt-ordenarSkill
- dt-revisar-instalacionSkill
- dt-sessionSkill
- dt-setupSkill
- dt-skillsSkill
- engineering-reuseSkill
- feedback-synthesizerSkill
- frontendSkill
- git-actualizarSkill
- github-save-releaseSkill
- growth-hackerSkill
- hack-auditSkill
- marketing-strategistSkill
- operations-maintainerSkill
- pitch-specialistSkill
- prd-creatorSkill
- The first 60 shown.
The file
Files
git-guardar
Spec versión: vitals/specs/project-version.md.
Invariante — dos semver distintos
VERSION (raíz) es solo la versión del producto de este repo. framework_version en vitals/config/dt-upstream.md es solo la del DT.
- Nunca copies, sugieras ni escribas el semver del DT en
VERSION,package.jsonni el badge del producto. - Nunca uses
framework_versioncomo si fuera la app. - Si el producto ya tiene semver (
package.jsonen raíz/frontend/backend/apps/*, oVERSIONdistinta del DT) → conservala y hacé bump con los criterios de abajo. - Si el proyecto es nuevo (no hay semver de producto) → partí de
initial_semver(0.1.0). No heredes el número del DT.
El script lo garantiza. Antes de bumpear:
./scripts/project-resolve-version.shLeé DT_PRODUCT_VERSION, DT_FRAMEWORK_VERSION y DT_VERSION_ACTION. Si bump/sync fallan porque VERSION coincide con el DT, resolvé; no pises el package.json a mano.
Invocaciones
| Comando | Bump | Cuándo |
/guardar | lo elige la IA | Hay cambios a commitear |
/guardar release patch|minor|major | el dígito nombrado | El mensaje ya lo especifica; no reclasificar |
| Sin cambios en el repo | — | No bump; informar "sin cambios" |
/guardar release a secas = patch. También vale nombrarlo en prosa (“bumpeá major”, “esto es un patch”).
Pre-requisitos
vitals/ops/session.yamlconoperator.id— pedir/yosalvo pedido explícito de avanzar sin sesión.vitals/config/dt-upstream.md→mode:canonical|consumer.- Opcional:
git fetch; si behind →/actualizar.
Exclusiones (nunca stage)
vitals/ops/session.yamlvitals/ops/canonical-checkout.yamlvitals/ops/collaboration.local.yamlvitals/ops/context-profile.yaml.cursor/rules/99-perfil-local.mdc.claude/rules/99-perfil-local.md.agents/rules/99-perfil-local.md.env,.env.local,*.credentialsvitals/workspace.yamlvitals/config/drive-context.yamlvitals/config/gmail-context.yamlvitals/config/calendar-context.yamlvitals/config/google-apps.yamlvitals/work/inbox/**/draft-*
Gate de publicación (antes del bump)
Corré ./scripts/dt-publish-gate.sh. El exit es una decisión. Leé la línea DT_PUBLISH_GATE. Spec: vitals/specs/canonical-publish.md.
| Exit | Qué hacer |
| 0 | Este checkout está activado con /oficial y el árbol no lleva rastros personales. Seguí el flujo completo, incluido push y tag al DT. El commit no lleva operator_id. |
| 10 | origin es otro repo. Seguí el flujo y pusheá a ese origin. No hables del remoto oficial ni de pedir acceso. El commit sí puede llevar operator_id. |
| 20 | No hay origin. Podés commitear en local. Sin git push y sin dt-tag-version.sh --push. No agregues el remoto oficial. Siguiente paso: un repo propio o /bootstrap. |
| 30 o 40 | Pará. Sin bump, sin commit, sin push, sin tag. Copiá el mensaje del script. No ofrezcas acceso, invitación ni gh auth para publicar el DT. Si el 40 dice keyring o sandbox y el operador acaba de mostrar gh api user = publisher en su terminal, reintentá el gate una vez sin sandbox (el agente necesita el llavero). No es un rechazo de identidad. |
| 50 | El checkout es oficial, pero hay sesión, roster con personas, inbox, postura o notas locales en el árbol. Pará. No las stagees ni las borres. El roster.yaml versionado sigue en team: []. Cuando eso no esté en el commit, volvé a correr el gate. |
| otro | Pará y mostrá la salida. |
mode: canonical no saltea este paso.
Flujo (ambos modos)
git status— si no hay cambios (salvo archivos excluidos) → detener sin bump.- Si los únicos cambios versionables son coordinación de agentes (
vitals/work/inbox/**salvodraft-*, y opcionalmentevitals/config/roster.yamlovitals/pulse/**solo por inbox) → no sigas este flujo con bump. Usá./scripts/dt-agent.sh sync --message "chore(inbox): …"(trailerDT-Member). Sin tag ni CHANGELOG de producto.
- Si los únicos cambios versionables son coordinación de agentes (
- Gate —
./scripts/dt-publish-gate.sh. Aplicá la tabla de arriba antes de tocarVERSION. git reset HEAD vitals/ops/session.yaml vitals/ops/canonical-checkout.yaml vitals/ops/collaboration.local.yaml vitals/ops/context-profile.yaml .cursor/rules/99-perfil-local.mdc .claude/rules/99-perfil-local.md .agents/rules/99-perfil-local.mdsi quedaron staged. En gate 0, tampoco stageesroster.yamlsiteamno está vacío, nivitals/work/inbox/, nivitals/config/collaboration.yaml.Resolver VERSION del producto (consumer: nunca la del DT):
./scripts/project-resolve-version.shDT_VERSION_ACTION=keep→ hay semver de producto; seguí al dígito y bump.DT_VERSION_ACTION=initial→ proyecto nuevo;VERSIONya es0.1.0(oinitial_semver). No incrementes. Marcáinitialized: truey, siauto_bumperanone, pasalo aclassify. Sync, commit y tag de esa versión inicial.DT_VERSION_ACTION=unchanged→VERSIONya era la del producto; seguí al dígito y bump (salvoauto_bump: none).
Elegir el dígito (ver abajo) y bumpear, salvo acción
initialoauto_bump: none:./scripts/project-bump-version.sh patch # o minor, o major./scripts/project-sync-version.sh— README ypackage.jsondel producto. En consumer no toquesframework_version(el script lo saltea). En canónico sí alineaframework_versionconVERSION.- Novedades — si hubo bump o versión inicial, agregá al tope de
CHANGELOG.mdla entrada## [X.Y.Z] - fechacon lo que quien ya usa el proyecto puede hacer ahora. En el README, «Qué trae» queda solo con esa versión y el enlace al historial. Las notas salen del diff. No inventes releases que no se taguearon. Si no hubo bump, no toques el changelog. 7b. Pulse (si hubo bump) — crearvitals/pulse/entries/YYYY-MM-DD-dt-YYYYMMDD-NNN.md(formato envitals/specs/protocolo-vitals-ia.md; plantillaentries/_plantilla.md; resumen de 2–3 líneas salido del diff).mode: canonical: la entry es local (no se stagea;canonical-publish.yamlla marca privada) y envitals/pulse/current.mdsolo se actualizaVersión template: X.Y.Z. Consumer: opcional; actualizá también el últimopulse_idy el resumen.dt-doctorsolo avisa. - Stage selectivo + archivos tocados por resolve/bump/sync (
VERSION, README,CHANGELOG.md, pulse —en canónico solocurrent.md—, etc.). ./scripts/dt-doctor.sh— corregir ERRORES.- Commit — primera línea siempre con la versión nueva.
Gate 0 (remoto oficial). Sin nombre de operador: quien clona el framework no tiene que ver la sesión.
v{X.Y.Z}: {resumen corto}
Bump: {patch|minor|major} — {motivo en una línea}Gate 10 o 20 (repo propio):
v{X.Y.Z} ({operator_id}): {resumen corto}
Bump: {patch|minor|major} — {motivo en una línea}
DT-Member: {operator_id}DT-Member es obligatorio si el commit agrega mensajes en vitals/work/inbox/: dt-doctor lo cruza con el from de cada mensaje (agent-inbox.md).
El hook prepare-commit-msg (lo instala /yo y install-hook) agrega DT-Member en cualquier commit si hay sesión y no es checkout oficial. Escribí el trailer igual: si ya está, el hook no lo duplica. Sin operator.id, no commitees: pedí /yo.
git push origin HEAD— solo si el gate salió 0 o 10. Sin--forceen main/master. Si el remoto rechaza por permisos, pará: ese remoto no es de este checkout. No pidas acceso ni reintentes contra el DT oficial.- Tag tras push OK, cuando hubo bump o reset inicial. En gate 20, no corras el tag con
--push:
./scripts/dt-tag-version.sh --push --message "Release v$(cat VERSION)"Tras bump, el tag debe ser nuevo. Si falla (tag en otro commit sin bump previo) → reportar error.
13. GitHub Release — tras el tag en origin, publicá la entrada nueva:
./scripts/dt-publish-github-release.shSi gh no está autenticado, el tag ya está: reportá el fallo. No publiques contra otro remoto.
Dígito
Precedencia:
- El mensaje nombra patch, minor o major → ese. No reclasificar.
- Si no, leé
auto_bumpenvitals/config/project-version.yaml:patch|minor|major→ ese dígito fijo.noneconinitialized: true→ commit y push sin bump ni tag nuevo.classify→ clasificá el diff.
Clasificación, sobre el diff sin exclusiones y sin lo que el bump reescribe (VERSION, badge del README, version en package.json, framework_version):
- major — quien ya usa el proyecto tiene que cambiar de hábito, o se rompe un contrato público: comando, skill, schema de
vitals, API o formato que otros leen. - minor — capacidad nueva (comando, skill, especialista, flujo, integración) y el uso anterior sigue igual.
- patch — corrección, aclaración o mantenimiento de algo que ya existe.
En canónico el proyecto es El DT. En consumer, el producto de ese repo.
Si el diff mezcla niveles, gana el más alto. Si dudás entre dos vecinos, elegí el menor y dejá el motivo en Bump:. No preguntes.
Quedan en patch aunque el diff sea grande: formato, comentarios, el mismo cambio espejado en .cursor / .agents / .claude, y el sync de versión.
Excepciones de bump
| Caso | Bump |
Consumer con semver de producto (DT_VERSION_ACTION=keep) | El dígito de la clasificación (o el nombrado). Base = versión de la app, nunca la del DT |
Consumer proyecto nuevo (DT_VERSION_ACTION=initial) | No incrementar — VERSION ya es initial_semver; initialized: true; si auto_bump era none pasarlo a classify. Luego sync, commit y tag |
initialized: false pero la app ya tiene semver | Igual que keep: no escribas initial_semver, no copies el DT, bump desde la app |
auto_bump: classify | El dígito de la clasificación |
auto_bump: patch|minor|major | Ese dígito, salvo override del mensaje |
auto_bump: none y initialized: true | Sin bump ni tag nuevo |
| Sin cambios | No ejecutar guardar |
Modo consumer
- Manifest:
/bootstrapo primer guardar. No copiesproject-version.yamlcanónico ni elVERSIONdel DT. ./scripts/project-resolve-version.shes obligatorio antes del bump. Si la app ya tenía0.4.2yVERSIONdecía1.8.0(DT), se queda en0.4.2y recién ahí se bump.- Tras
initialized: trueyauto_bump: classify, cada/guardarcon cambios clasifica, sync y tag del producto. framework_versionendt-upstream.mdno se bump ni se sincroniza desdeVERSION.
Modo canonical (El DT)
Manifest: vitals/config/project-version.yaml · auto_bump: classify.
Cada /guardar con cambios, y solo si el gate salió 0: el dígito elegido → sync README + framework_version + tools/front/back → entrada en CHANGELOG.md → commit vX.Y.Z: → tag → GitHub Release.
/github-save-small = mismo flujo.
Entrega
- Versión anterior → nueva, con el motivo (
1.7.11→1.8.0, minor — comando nuevo) - Archivos sincronizados
- Entrada en
CHANGELOG.md(si hubo bump o versión inicial) - Hash, push, tag
vX.Y.Zy GitHub Release (si hubo bump o reset inicial)
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.

