somtech-pack-maj

name	somtech-pack-maj
description	Mettre à jour le projet courant depuis le somtech-pack (pull). TRIGGERS : somtech-pack-maj, mise à jour pack, update pack, sync pack, pull pack, maj somtech, mettre à jour le pack Détecte les changements disponibles, affiche un résumé, et applique la mise à jour.
disable-model-invocation	false
allowed-tools	Read, Write, Edit, Bash, Grep, Glob

Somtech Pack — Mise à jour projet

Mettre à jour les fichiers de configuration, skills, rules et commandes du projet courant depuis la dernière version du somtech-pack.

Phase 0 — Pré-vérifications

0.1 Vérifier qu'on est dans un projet client

# Vérifier qu'on est dans un repo git
git rev-parse --show-toplevel

# Vérifier qu'il y a déjà une config Somtech
ls .claude/ 2>/dev/null

Si .claude/ n'existe pas, avertir l'utilisateur qu'il s'agit peut-être d'une première installation (utiliser /somtech-pack-install plutôt).

0.2 Vérifier les prérequis

# Git dispo
git --version

# Réseau accessible (test rapide)
git ls-remote https://github.com/SomtechSolutionMAxime/somtech-pack.git HEAD 2>/dev/null | head -1

Si le réseau n'est pas accessible, proposer une mise à jour depuis un clone local si l'utilisateur en a un.

0.3 Vérifier l'état git du projet

# Vérifier s'il y a des changements non commités dans les dossiers pack
git status --short .claude/ docs/ scripts/ features/

Si des fichiers modifiés sont détectés dans ces dossiers :

• Avertir l'utilisateur que la MAJ va écraser ses modifications locales
• Lister les fichiers en conflit potentiel
• Demander confirmation avant de continuer
• Suggérer de faire un somtech_pack_push.sh d'abord si les changements doivent être publiés vers le pack

Phase 1 — Analyser les changements disponibles

1.1 Cloner le pack pour comparaison

WORKDIR=$(mktemp -d)
git clone --depth 1 --branch main https://github.com/SomtechSolutionMAxime/somtech-pack.git "$WORKDIR/somtech-pack" 2>/dev/null

1.2 Comparer les fichiers

Pour chaque dossier synchronisé, comparer le contenu local avec le pack :

# .claude/ — skills, agents, templates, settings
diff -rq .claude/ "$WORKDIR/somtech-pack/.claude/" 2>/dev/null | grep -v ".DS_Store"

# features/ — blueprints de features
diff -rq features/ "$WORKDIR/somtech-pack/features/" 2>/dev/null | grep -v ".DS_Store"

# scripts/
diff -rq scripts/ "$WORKDIR/somtech-pack/scripts/" 2>/dev/null | grep -v ".DS_Store"

1.3 Catégoriser les changements

Classer les fichiers en 3 catégories et présenter à l'utilisateur :

Catégorie	Description	Action
Nouveaux	Fichiers dans le pack mais pas dans le projet	Seront ajoutés
Modifiés	Fichiers différents entre pack et projet	Seront mis à jour
Supprimés	Fichiers dans le projet mais plus dans le pack	Seront signalés (pas supprimés automatiquement)

1.4 Afficher le résumé

Présenter un résumé clair :

📦 SOMTECH-PACK — Changements disponibles
──────────────────────────────────────────

🆕 Nouveaux (X fichiers):
   .claude/skills/deploy-metering/SKILL.md
   features/metering-billing/overview.md
   ...

📝 Modifiés (Y fichiers):
   .claude/skills/end-session/SKILL.md
   .claude/hooks/session-start-app-state.sh
   ...

⚠️  Fichiers locaux uniquement (Z fichiers):
   .claude/skills/custom-local/SKILL.md  ← pas dans le pack
   ...

Appliquer la mise à jour ? (les fichiers locaux uniquement ne seront PAS supprimés)

Attendre la confirmation de l'utilisateur avant de continuer.

Phase 2 — Appliquer la mise à jour

2.1 Option A — Via le script officiel (recommandé)

Si le script somtech_pack_pull.sh est accessible :

# Depuis le projet courant
./scripts/somtech_pack_pull.sh --target .

Ou si le script n'est pas encore dans le projet :

"$WORKDIR/somtech-pack/scripts/somtech_pack_pull.sh" --target .

2.2 Option B — Copie manuelle (fallback)

Si le script n'est pas disponible ou échoue, copier manuellement :

PROJECT_ROOT=$(git rev-parse --show-toplevel)

# .claude/ (skills, agents, commands, hooks, settings, etc.)
# NB: le pack ne pousse PAS .claude/CLAUDE.md (cf. D-20260513-0009) — si le projet
# en a un local, il reste intact. On l'exclut explicitement par prudence.
rsync -av --exclude='.DS_Store' --exclude='CLAUDE.md' "$WORKDIR/somtech-pack/.claude/" "$PROJECT_ROOT/.claude/"

# features/ (blueprints réutilisables)
rsync -av --exclude='.DS_Store' "$WORKDIR/somtech-pack/features/" "$PROJECT_ROOT/features/"

# scripts/
rsync -av --exclude='.DS_Store' "$WORKDIR/somtech-pack/scripts/" "$PROJECT_ROOT/scripts/"

2.3 Nettoyage

rm -rf "$WORKDIR"

Phase 3 — Post-mise à jour

3.1 Vérifier l'installation

# Lister les skills disponibles
ls .claude/skills/

# Vérifier la présence du hook SessionStart (STD-027)
ls -la .claude/hooks/session-start-app-state.sh

3.2 Résumé final

✅ SOMTECH-PACK MIS À JOUR
──────────────────────────
Fichiers ajoutés  : X
Fichiers modifiés : Y
Version pack      : main@<commit-sha>

📋 Nouveaux skills disponibles :
   /deploy-metering — Déployer métriques et facturation
   ...

⚠️  Actions recommandées :
   - Si l'app n'est pas encore liée (.somtech/app.yaml absent) : /lier-app
   - Commiter les changements : git add .claude/ features/ scripts/ && git commit -m "chore(pack): sync somtech-pack"

3.3 Proposer le commit

Proposer à l'utilisateur de commiter les changements avec un message conventionnel :

git add .claude/ features/ scripts/
git commit -m "chore(pack): sync somtech-pack $(date +%Y-%m-%d)"

Ne PAS commiter sans confirmation explicite de l'utilisateur.

Options avancées

L'utilisateur peut demander une mise à jour partielle :

Demande	Comportement
"maj skills seulement"	Synchroniser uniquement .claude/skills/
"maj depuis une branche"	Utiliser --ref <branche> pour le pull
"dry-run"	Ajouter --dry-run pour preview sans écriture
"maj + push mes changements"	Faire un push d'abord, puis un pull

Pour les mises à jour partielles, utiliser les flags réels du script (modules définis dans pack.json) :

./scripts/somtech_pack_pull.sh --target . --modules core              # Config Claude Code + scripts + docs + sécurité
./scripts/somtech_pack_pull.sh --target . --modules core,features     # Core + blueprints de features (défaut)
./scripts/somtech_pack_pull.sh --target . --modules plugins           # Plugins Cowork uniquement
./scripts/somtech_pack_pull.sh --target . --modules mockmig           # Workflow migration maquette → production
./scripts/somtech_pack_pull.sh --target . --ref staging               # Pull depuis une autre branche
./scripts/somtech_pack_pull.sh --target . --dry-run                   # Preview sans écriture

Règles critiques

1. Ne JAMAIS écraser sans confirmation — toujours montrer le diff d'abord
2. Ne JAMAIS push sur main — si un commit est nécessaire, le faire sur la branche courante
3. Ne JAMAIS supprimer des fichiers locaux qui ne sont pas dans le pack (l'utilisateur peut avoir des skills custom)
4. Toujours nettoyer le dossier temporaire de travail après l'opération
5. Proposer le push si des changements locaux pertinents sont détectés avant le pull