claudia-update

name	claudia-update
description	Actualiza el framework de Claudia OS desde el repo canónico sergi-rz/claudia-os, protegiendo todo el territorio del usuario (user/, .claude/skills/*/user/). Uso: /claudia-update
user-invocable	true

claudia-update

Qué hace

Sincroniza la instalación local con la última versión del framework publicada en sergi-rz/claudia-os. Nunca toca el territorio del usuario.

Territorio del usuario — intocable:

• user/ — todo, sin excepciones
• .claude/skills/*/user/ — personalizaciones de skills
• .claude/settings.json, .claude/settings.local.json
• Blueprints en blueprints/ que no existan en el repo canónico (son del usuario)

Territorio del framework — actualizable:

• core/
• .claude/skills/<skill>/ (excepto */user/)
• CLAUDE.md
• scripts/
• blueprints/_template/ + blueprints que vengan del canónico
• Documentos raíz: README.md, ROADMAP.md, PHILOSOPHY.md, CONTRIBUTING.md, ATTRIBUTION.md, SECURITY.md, CLAUDIA_OS_OVERVIEW.md, VPS.md

Invocación

• /claudia-update — comprueba y aplica actualizaciones
• /claudia-update --check — muestra qué cambiaría sin aplicar nada

Repositorio canónico

Remote:  upstream
URL:     https://github.com/sergi-rz/claudia-os.git
Branch:  main

Flujo

Paso 1 — Preparar remote upstream

1. Comprueba si existe el remote upstream:

   git remote get-url upstream
   

2. Si no existe, añádelo:

   git remote add upstream https://github.com/sergi-rz/claudia-os.git
   

3. Fetch:

   git fetch upstream
   

Paso 2 — Detectar cambios en el framework

Ejecuta:

git diff --stat HEAD upstream/main -- core/ .claude/skills/ CLAUDE.md scripts/ blueprints/ README.md ROADMAP.md PHILOSOPHY.md CONTRIBUTING.md ATTRIBUTION.md SECURITY.md CLAUDIA_OS_OVERVIEW.md VPS.md

Si no hay cambios: "Tu instalación ya está al día con el framework." Para.

Paso 3 — Detectar cambios locales no commiteados en el framework

Ejecuta:

git status --porcelain -- core/ CLAUDE.md scripts/

Si hay ficheros del framework con cambios locales sin commitear, avisa antes de continuar:

⚠ Tienes cambios locales en ficheros del framework que serían sobreescritos:
  <lista de ficheros>

Estos cambios no están en el repo canónico. Se perderán con el update.
¿Deseas continuar de todos modos, o prefieres commitear o stashear primero?

Espera OK explícito. Sin OK, para.

Paso 4 — Mostrar resumen de cambios

Muestra un resumen legible organizado por categoría. Para skills, distingue entre actualizada y NUEVA. Ejemplo de formato:

Actualizaciones disponibles desde sergi-rz/claudia-os:

Framework:
  core/memory.md          modificado
  core/behavior.md        modificado

Skills:
  .claude/skills/claudia-wisdom/SKILL.md    actualizada
  .claude/skills/claudia-nueva/             NUEVA

Documentos raíz:
  README.md               modificado
  ROADMAP.md              modificado

Tu carpeta user/ no se toca. Tus personalizaciones en */user/ tampoco.

Si el usuario invocó con --check: para aquí. No apliques nada.

Paso 5 — Confirmar

Pregunta:

"¿Aplico estas actualizaciones? Los cambios quedarán sin commitear para que puedas revisarlos antes."

Espera OK explícito. Sin OK, para.

Paso 6 — Aplicar actualizaciones

Aplica en este orden:

6a. Core, CLAUDE.md, scripts y documentos raíz:

git checkout upstream/main -- core/ CLAUDE.md scripts/ README.md ROADMAP.md PHILOSOPHY.md CONTRIBUTING.md ATTRIBUTION.md SECURITY.md CLAUDIA_OS_OVERVIEW.md VPS.md

6b. Skills — con exclusión explícita de */user/:

git checkout upstream/main -- .claude/skills/ ":(exclude).claude/skills/*/user/"

Si el shell reporta que la sintaxis :(exclude) no es soportada, haz el checkout skill a skill:

git checkout upstream/main -- .claude/skills/<skill>/

Y para cada skill que tuviera un subdirectorio user/ local: restáuralo inmediatamente con:

git checkout HEAD -- .claude/skills/<skill>/user/

6c. Blueprints — solo los del canónico, sin eliminar los del usuario:

Obtén la lista de blueprints en upstream:

git ls-tree --name-only upstream/main blueprints/

Para cada blueprint de upstream (excepto README.md como fichero suelto):

git checkout upstream/main -- blueprints/<nombre>/

No elimines ni modifiques blueprints locales que no aparezcan en esa lista.

Paso 7 — Confirmar resultado

Ejecuta:

git diff --stat HEAD
git status --porcelain

Muestra al usuario:

• Ficheros actualizados
• Skills nuevas (si las hay)
• Rollback disponible: git checkout HEAD -- .
• "Revisa los cambios con git diff HEAD antes de commitear."

Reglas invariantes

1. Nunca commitear. El usuario decide cuándo.
2. user/ es sagrado. Ningún fichero bajo user/ puede ser tocado, creado ni eliminado.
3. */user/ en skills es sagrado. Si git checkout lo sobreescribe, restáuralo de inmediato.
4. Sin OK explícito en Paso 5, no hay Paso 6.
5. Si upstream/main no existe, parar con mensaje claro. No mostrar errores git crudos.
6. Blueprints locales no en upstream: no tocar. Son del usuario.
7. No eliminar skills locales. Una skill que esté en local pero no en upstream podría ser del usuario.