agentleFS
MazalucasMazalucas/El-DT-Lightweight-Army/.agents/skills/git-guardar/SKILL.md

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

The file

Files
SKILL.md

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.json ni el badge del producto.
  • Nunca uses framework_version como si fuera la app.
  • Si el producto ya tiene semver (package.json en raíz/frontend/backend/apps/*, o VERSION distinta 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.sh

Leé 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

ComandoBumpCuándo
/guardarlo elige la IAHay cambios a commitear
/guardar release patch|minor|majorel dígito nombradoEl 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

  1. vitals/ops/session.yaml con operator.id — pedir /yo salvo pedido explícito de avanzar sin sesión.
  2. vitals/config/dt-upstream.md → mode: canonical | consumer.
  3. Opcional: git fetch; si behind → /actualizar.

Exclusiones (nunca stage)

  • 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.md
  • .env, .env.local, *.credentials
  • vitals/workspace.yaml
  • vitals/config/drive-context.yaml
  • vitals/config/gmail-context.yaml
  • vitals/config/calendar-context.yaml
  • vitals/config/google-apps.yaml
  • vitals/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.

ExitQué hacer
0Este 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.
10origin 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.
20No 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 40Pará. 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.
50El 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.
otroPará y mostrá la salida.

mode: canonical no saltea este paso.

Flujo (ambos modos)

  1. 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/** salvo draft-*, y opcionalmente vitals/config/roster.yaml o vitals/pulse/** solo por inbox) → no sigas este flujo con bump. Usá ./scripts/dt-agent.sh sync --message "chore(inbox): …" (trailer DT-Member). Sin tag ni CHANGELOG de producto.
  2. Gate — ./scripts/dt-publish-gate.sh. Aplicá la tabla de arriba antes de tocar VERSION.
  3. 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.md si quedaron staged. En gate 0, tampoco stagees roster.yaml si team no está vacío, ni vitals/work/inbox/, ni vitals/config/collaboration.yaml.
  4. Resolver VERSION del producto (consumer: nunca la del DT):

    ./scripts/project-resolve-version.sh
    • DT_VERSION_ACTION=keep → hay semver de producto; seguí al dígito y bump.
    • DT_VERSION_ACTION=initial → proyecto nuevo; VERSION ya es 0.1.0 (o initial_semver). No incrementes. Marcá initialized: true y, si auto_bump era none, pasalo a classify. Sync, commit y tag de esa versión inicial.
    • DT_VERSION_ACTION=unchanged → VERSION ya era la del producto; seguí al dígito y bump (salvo auto_bump: none).
  5. Elegir el dígito (ver abajo) y bumpear, salvo acción initial o auto_bump: none:

    ./scripts/project-bump-version.sh patch   # o minor, o major
  6. ./scripts/project-sync-version.sh — README y package.json del producto. En consumer no toques framework_version (el script lo saltea). En canónico sí alinea framework_version con VERSION.
  7. Novedades — si hubo bump o versión inicial, agregá al tope de CHANGELOG.md la entrada ## [X.Y.Z] - fecha con 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) — crear vitals/pulse/entries/YYYY-MM-DD-dt-YYYYMMDD-NNN.md (formato en vitals/specs/protocolo-vitals-ia.md; plantilla entries/_plantilla.md; resumen de 2–3 líneas salido del diff). mode: canonical: la entry es local (no se stagea; canonical-publish.yaml la marca privada) y en vitals/pulse/current.md solo se actualiza Versión template: X.Y.Z. Consumer: opcional; actualizá también el último pulse_id y el resumen. dt-doctor solo avisa.
  8. Stage selectivo + archivos tocados por resolve/bump/sync (VERSION, README, CHANGELOG.md, pulse —en canónico solo current.md—, etc.).
  9. ./scripts/dt-doctor.sh — corregir ERRORES.
  10. 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.

  1. git push origin HEAD — solo si el gate salió 0 o 10. Sin --force en 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.
  2. 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.sh

Si gh no está autenticado, el tag ya está: reportá el fallo. No publiques contra otro remoto.


Dígito

Precedencia:

  1. El mensaje nombra patch, minor o major → ese. No reclasificar.
  2. Si no, leé auto_bump en vitals/config/project-version.yaml:
    • patch | minor | major → ese dígito fijo.
    • none con initialized: 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):

  1. 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.
  2. minor — capacidad nueva (comando, skill, especialista, flujo, integración) y el uso anterior sigue igual.
  3. 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

CasoBump
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 semverIgual que keep: no escribas initial_semver, no copies el DT, bump desde la app
auto_bump: classifyEl dígito de la clasificación
auto_bump: patch|minor|majorEse dígito, salvo override del mensaje
auto_bump: none y initialized: trueSin bump ni tag nuevo
Sin cambiosNo ejecutar guardar

Modo consumer

  • Manifest: /bootstrap o primer guardar. No copies project-version.yaml canónico ni el VERSION del DT.
  • ./scripts/project-resolve-version.sh es obligatorio antes del bump. Si la app ya tenía 0.4.2 y VERSION decía 1.8.0 (DT), se queda en 0.4.2 y recién ahí se bump.
  • Tras initialized: true y auto_bump: classify, cada /guardar con cambios clasifica, sync y tag del producto.
  • framework_version en dt-upstream.md no se bump ni se sincroniza desde VERSION.

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.Z y GitHub Release (si hubo bump o reset inicial)

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.